ReactOS.exe 安装程序分析

ReactOS.exe 安装程序分析

概述

reactos.exe是 ReactOS 的GUI 第一阶段安装程序，位于d:\reactos\base\setup\reactos\。它是一个 Win32 属性表（Property Sheet）向导，提供 7 步安装流程（欢迎 → 安装类型 → 设备 → 分区 → 摘要 → 安装进度 → 完成），并调用setuplib库完成底层安装操作（分区、格式化、文件复制、注册表更新、引导加载器安装）。

1. 源文件清单

2. 全局数据结构

文件：[reactos.c#L23](file:///d:/reactos/base/setup/reactos/reactos.c#L23)

HANDLE ProcessHeap;// 进程堆句柄SETUPDATA SetupData;// 安装配置数据（源路径、目标路径等）PPARTENTRY InstallPartition;// 目标安装分区PPARTENTRY SystemPartition;// 系统分区（活动引导分区）UI_CONTEXT UiContext;// UI 上下文（字体、语言等）

3. wWinMain — 程序入口

文件：[reactos.c#L3210](file:///d:/reactos/base/setup/reactos/reactos.c#L3210)

_tWinMain(INSTANCE, PREVINSTANCE, CMDLINE, CMD_SHOW) │ ├─ 1. ProcessHeap = GetProcessHeap() ├─ 2. ZeroMemory(&SetupData) │ ├─ ★ 3. InitializeSetup() 调用 setuplib：加载 txtsetup.sif ├─ 4. CheckUnattendedSetup() 检查无人值守配置 │ ├─ ★ 5. LoadSetupData() 加载分区、NTOS安装、硬件列表 │ ├─ CreatePartitionList() 枚举磁盘分区 │ ├─ CreateNTOSInstallationsList() 检测已有 NT 系统 │ ├─ CreateComputerTypeList() 计算机类型列表 │ ├─ CreateDisplayDriverList() 显示驱动列表 │ └─ CreateKeyboardDriverList() 键盘驱动列表 │ ├─ 6. CreateThread(HotkeyThread) Shift+F10 打开 cmd ├─ 7. InitCommonControls + 注册 TreeList ├─ 8. CreateTitleFont() + CreateBoldFont() │ ├─ 9. 创建 9 个属性页: │ ├─ IDD_STARTPAGE → StartDlgProc (仅非无人值守) │ ├─ IDD_TYPEPAGE → TypeDlgProc (仅非无人值守) │ ├─ IDD_UPDATEREPAIR → UpgradeRepair (仅非无人值守) │ ├─ IDD_DEVICEPAGE → DeviceDlgProc (仅非无人值守) │ ├─ IDD_DRIVEPAGE → DriveDlgProc (仅非无人值守) │ ├─ IDD_SUMMARYPAGE → SummaryDlgProc (仅非无人值守) │ ├─ IDD_PROCESSPAGE → ProcessDlgProc (始终) │ ├─ IDD_FINISHPAGE → FinishDlgProc (始终) │ └─ IDD_ABORTPAGE → FinishDlgProc (始终) │ ├─ 10. PropertySheet(所有页面) ← 以向导模式显示 │ ├─ 11. 等待安装线程结束 ├─ 12. 清理字体 + TreeList ├─ 13. TerminateThread(HotkeyThread) ├─ 14. FinishSetup() 清理 setuplib │ └─ 15. ExitWindowsEx(EWX_REBOOT) 需要重启时

4. 7 步安装向导详解

页面 1: StartDlgProc — 欢迎页面

文件：[reactos.c#L352](file:///d:/reactos/base/setup/reactos/reactos.c#L352)

StartDlgProc(hwndDlg,uMsg,wParam,lParam){WM_INITDIALOG:保存 SETUPDATA 指针，设置标题字体，居中窗口 PSN_SETACTIVE:只显示"下一步"按钮，隐藏"上一步"PSN_KILLACTIVE:重新显示"上一步"}

页面 2: TypeDlgProc — 安装类型

文件：[reactos.c#L422](file:///d:/reactos/base/setup/reactos/reactos.c#L422)

用户选择: ├─ "安装 ReactOS" (全新安装) │ → PSN_WIZNEXT → 跳到设备页面 (IDD_DEVICEPAGE) │ └─ "升级或修复现有安装" → 检测到有多个 NT 系统? │ Yes → UpdataRepair 页面 (选要升级的系统) │ No → 直接跳到设备页面 └─ SetupData.RepairUpdateFlag = TRUE

页面 3: UpdataRepairDlgProc — 升级选择

文件：[reactos.c#L789](file:///d:/reactos/base/setup/reactos/reactos.c#L789)

WM_INITDIALOG: 初始化列表视图，显示检测到的 NTOS 安装列表 PSN_WIZNEXT: 设置选中的 NTOS 安装，RepairUpdateFlag=TRUE IDC_SKIPUPGRADE: 跳过升级，全新安装

页面 4: DeviceDlgProc — 设备配置

文件：[reactos.c#L975](file:///d:/reactos/base/setup/reactos/reactos.c#L975)

DeviceDlgProc(hwndDlg,uMsg,wParam,lParam){WM_INITDIALOG:InitGenericComboList(IDC_COMPUTER,ComputerTypeList)← 计算机类型InitGenericComboList(IDC_DISPLAY,DisplayDriverList)← 显示驱动InitGenericComboList(IDC_KEYBOARD,KeyboardDriverList)← 键盘驱动 PSN_WIZNEXT:保存三个下拉框的选中值到 SetupData}

设备列表数据来自txtsetup.sif文件，由LoadSetupData()在程序启动时加载。

页面 5: DriveDlgProc — 分区选择

文件：[drivepage.c#L1593](file:///d:/reactos/base/setup/reactos/drivepage.c#L1593)

这是最复杂的页面。TreeList 控件显示所有磁盘和分区的树形结构。

DriveDlgProc(hwndDlg, uMsg, wParam, lParam) │ ├─ WM_INITDIALOG: │ InitPartitionList() → 填充 TreeList (磁盘/分区树) │ 隐藏创建/删除/格式化按钮 │ ├─ TVN_SELCHANGED (选中项变化): │ 根据选中项类型显示/隐藏按钮: │ ├─ 未分区空间 → 显示"创建分区" │ ├─ 已分区 → 显示"格式化"/"删除" │ ├─ 已格式化 → 显示"格式化" │ └─ 磁盘头 → 无操作按钮 │ ├─ IDC_PARTCREATE → PartitionDlgProc() 创建分区对话框 ├─ IDC_PARTDELETE → DoDeletePartition() 删除分区 ├─ IDC_PARTFORMAT → FormatDlgProc() 格式化对话框 ├─ IDC_PARTMOREOPTS → MoreOptsDlgProc() 高级选项 (安装目录) │ └─ PSN_WIZNEXT: ├─ 检查选中分区 → 未格式化? → 弹出格式化对话框 ├─ 设置 InstallPartition = 选中分区 └─ 检查 BIOS 识别性 → 不可引导? → 警告

PartitionDlgProc([drivepage.c#L608](file:///d:/reactos/base/setup/reactos/drivepage.c#L608)) — 创建分区：

用户输入分区大小 (MB) 可勾选"使用所有可用空间" 调用 CreatePartition(空间, 大小) → DoCreatePartition() → 刷新 TreeList 显示

FormatDlgProc([drivepage.c#L555](file:///d:/reactos/base/setup/reactos/drivepage.c#L555)) — 格式化：

选择文件系统 (FAT/FAT32/BtrFS) 勾选"快速格式化" 确认 → FsVolCommitOpsQueue → 执行实际格式化

MoreOptsDlgProc([drivepage.c#L212](file:///d:/reactos/base/setup/reactos/drivepage.c#L212)) — 高级选项：

设置安装目录路径 (默认: \ReactOS) 设置引导加载程序位置 (MBR/软盘/不安装) 调用 IsValidInstallDirectory() 验证目录名合法性

页面 6: SummaryDlgProc — 安装摘要

文件：[reactos.c#L1078](file:///d:/reactos/base/setup/reactos/reactos.c#L1078)

PSN_SETACTIVE: 显示用户选择的全部安装选项: ├─ 安装类型 (新安装/升级) ├─ 计算机类型 ├─ 显示驱动 ├─ 键盘驱动 ├─ 目标分区 └─ 目标路径 按钮文本改为"安装" 复选框 IDC_CONFIRM_INSTALL 勾选后启用"安装"按钮

页面 7: ProcessDlgProc — 安装进度

文件：[reactos.c#L2230](file:///d:/reactos/base/setup/reactos/reactos.c#L2230)

PSN_SETACTIVE: 创建安装线程 PrepareAndDoCopyThread() (挂起) 恢复线程 → 正式开始安装 (属性表页面显示进度信息) PSN_QUERYCANCEL: 停止安装线程 跳到中止页面 (IDD_ABORTPAGE)

5. 核心安装线程: PrepareAndDoCopyThread

文件：[reactos.c#L1847](file:///d:/reactos/base/setup/reactos/reactos.c#L1847)

这是执行实际安装操作的函数，运行在独立线程中，分为 8 个子步骤：

DWORD WINAPIPrepareAndDoCopyThread(LPVOID lpParameter){│ ├─ Step1:InitSystemPartition()│ 查找或设置活动系统分区，如无则自动创建 │ ├─ Step2:FsVolCommitOpsQueue()+FsVolCallback()│ 执行格式化/检查操作队列:│ ├─ FSVOLNOTIFY_STARTFORMAT → 显示"正在格式化..."│ ├─ FSVOLNOTIFY_FORMATPROGRESS → 格式化进度百分比 │ ├─ FSVOLNOTIFY_FORMATSTATUS → 文件系统类型 │ ├─ FSVOLNOTIFY_STARTCHKDSK → 显示"正在检查磁盘..."│ └─ FSVOLNOTIFY_CHKDSKPROGRESS → 检查进度 │ ├─ Step3:InitDestinationPaths()│ 重新计算目标路径（ARC路径、NT路径、Win32路径） │ ├─ Step4:PrepareFileCopy()│ 准备文件复制队列:│ ├─ 从 txtsetup.sif[SourceDisksFiles]读取所有文件 │ ├─ 按目标目录分组 │ └─ 创建 SetupAPI 文件队列 │ ├─ Step5:DoFileCopy()+FileCopyCallback()│ 执行文件复制:│ ├─ 从 CAB 或源目录复制文件 │ ├─ FILECOPYNOTIFY_PROGRESS → 进度百分比 │ ├─ FILECOPYNOTIFY_ERROR → 文件错误处理（重试/跳过） │ ├─ FILECOPYNOTIFY_DELETE → 删除旧文件 │ └─ FILECOPYNOTIFY_RENAME → 重命名文件 │ ├─ Step6:InstallSetupInfFile()│ 创建 $winnt$.inf 安装配置文件（包含分区、目录等配置） │ ├─ Step7:UpdateRegistry()+RegistryStatus()│ 创建并更新注册表配置单元:│ ├─RegInitializeRegistry()→ 初始化 HIVE │ ├─ 从 HiveInfs.Fresh/HiveInfs.Install 导入 │ ├─ 更新显示设置 │ ├─ 设置区域/键盘布局 │ ├─ 添加代码页 │ ├─ 设置默认页面文件 │ └─ 更新已挂载设备值 │ └─ Step8:安装引导加载器 ├─ BootLoader=0:不安装 ├─ BootLoader=1:InstallBootcodeToRemovable()← 软盘 ├─ BootLoader=2:InstallBootManagerAndBootEntries()← MBR └─ BootLoader=3:仅安装 VBR}

6. 辅助函数清单

文件：[reactos.c](file:///d:/reactos/base/setup/reactos/reactos.c)

UI 辅助函数

安装数据加载

安装回调函数

完成相关

7. 完成页面 & 重启

文件：[reactos.c#L2429](file:///d:/reactos/base/setup/reactos/reactos.c#L2429)

FinishDlgProc(hwndDlg, uMsg, wParam, lParam) ├─ WM_INITDIALOG: │ 设置"必须重启"标志 │ 显示重启倒计时进度条 (300步 = 15秒) │ (或显示"稍后重启"文字) │ ├─ WM_TIMER: │ 每50ms递增进度条 │ 300步到 → PostMessage(PSBTN_FINISH) │ └─ PSN_SETACTIVE: 只显示"完成"按钮（文字改为"重启"） 隐藏"上一步"和"下一步"

wWinMain在PropertySheet()返回后：

// reactos.c#L3393-3428WaitForSingleObject(InstallThread,INFINITE);← 等安装线程结束FinishSetup();← 清理 setuplibif(NeedsReboot)ExitWindowsEx(EWX_REBOOT,0);← 重启系统

8. setuplib 库调用关系

reactos.exe通过延迟加载调用setuplib.dll。以下是所有被调用的 setuplib 函数及其作用：

9. 安装流程图

wWinMain │ ├─ InitializeSetup() ← 加载 txtsetup.sif，获取源路径 │ ├─ LoadSetupData() ← 枚举磁盘/分区/硬件 │ ├─ PropertySheet(9 pages) │ │ │ ├─ [欢迎] → [安装类型] → [设备] → [分区] → [摘要] │ │ │ │ │ 用户点击"安装" │ │ │ │ └────────────────────────────────────────────────┘ │ │ ├─ ProcessDlgProc → CreateThread(PrepareAndDoCopyThread) │ │ │ PrepareAndDoCopyThread: │ │ ├─ Step 1: InitSystemPartition() │ │ ├─ Step 2: FsVolCommitOpsQueue() 格式化 │ │ ├─ Step 3: InitDestinationPaths() │ │ ├─ Step 4: PrepareFileCopy() 准备复制 │ │ ├─ Step 5: DoFileCopy() 复制文件 │ │ ├─ Step 6: InstallSetupInfFile() $winnt$.inf │ │ ├─ Step 7: UpdateRegistry() 注册表 │ │ └─ Step 8: Install Bootloader 引导加载器 │ │ │ ├─ WaitForSingleObject(InstallThread) │ ├─ FinishSetup() │ └─ ExitWindowsEx(EWX_REBOOT) │

设计要点