ReactOS.exe 安装程序分析概述reactos.exe是 ReactOS 的GUI 第一阶段安装程序位于d:\reactos\base\setup\reactos\。它是一个 Win32 属性表Property Sheet向导提供 7 步安装流程欢迎 → 安装类型 → 设备 → 分区 → 摘要 → 安装进度 → 完成并调用setuplib库完成底层安装操作分区、格式化、文件复制、注册表更新、引导加载器安装。1. 源文件清单文件路径用途reactos.cbase\setup\reactos\reactos.c主入口、所有页面过程、安装线程、辅助函数drivepage.cbase\setup\reactos\drivepage.c分区/驱动器选择页面treelist.cbase\setup\reactos\treelist.cTreeList 控件第三方分区树形列表fileqsup.cbase\setup\reactos\spapisup\fileqsup.cSetupAPI 文件队列支持infsupp.cbase\setup\reactos\spapisup\infsupp.cSetupAPI INF 文件支持reactos.hbase\setup\reactos\reactos.h主头文件treelist.hbase\setup\reactos\treelist.hTreeList 头文件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) ShiftF10 打开 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 安装RepairUpdateFlagTRUE 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:安装引导加载器 ├─ BootLoader0:不安装 ├─ BootLoader1:InstallBootcodeToRemovable()← 软盘 ├─ BootLoader2:InstallBootManagerAndBootEntries()← MBR └─ BootLoader3:仅安装 VBR}6. 辅助函数清单文件[reactos.c](file:///d:/reactos/base/setup/reactos/reactos.c)UI 辅助函数函数行号用途CenterWindow43居中窗口CreateBoldFont70创建粗体字体CreateTitleFont104创建 12pt 粗体标题字体LoadAllocStringW112从资源加载字符串自动分配FormatAllocStringWV147格式化字符串va_listDisplayMessageV172显示消息框DisplayMessage241消息框包装DisplayError260错误消息框SetWindowResTextW281从资源设置窗口文本SetWindowResPrintfVW300格式化窗口文本CreateListViewColumns558创建列表视图列InitGenericComboList597初始化下拉框列表GetSelectedComboListItem635获取选中下拉框项InitGenericListView656初始化列表视图GetSelectedListViewItem693获取选中列表视图项GetSettingDescription712获取设置描述文本AddNTOSInstallationItem723添加 NT 安装项到列表安装数据加载函数行号用途LoadSetupData2627加载分区、NT安装、硬件列表InitNtToWin32PathMappingList2718初始化 NT→Win32 路径映射FreeNtToWin32PathMappingList2726释放路径映射链表ConvertNtPathToWin32Path2747NT 路径 → Win32 路径转换EnablePrivilege3006启用/禁用特权HotkeyThread3036ShiftF10 → cmd.exeGetLocalSetupDllPath3085获取 setuplib.dll 路径setupDelayHook3144延迟加载钩子加载 setuplib.dll安装回调函数函数行号用途FormatCallback1266格式化进度回调ChkdskCallback1313磁盘检查回调FsVolCallback1331文件系统/卷操作回调FileCopyCallback1676文件复制回调RegistryStatus1797注册表操作状态回调PropSheet_SetCloseCancel1836启用/禁用关闭/取消按钮完成相关函数行号用途IsShellActive2353检测 Windows shell 是否活动FindUserClosableWindowProc2375查找可关闭的用户窗口AreThereInteractiveWindows2411检测交互式窗口存在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 函数及其作用函数所在文件用途调用点InitializeSetupsetuplib.c初始化安装源路径、加载 txtsetup.sifwWinMain 第3235行CheckUnattendedSetupsetuplib.c检查无人值守配置wWinMain 第3253行CreatePartitionListpartlist.c枚举所有磁盘分区LoadSetupData 第2630行CreateNTOSInstallationsListosdetect.c检测已有 NT 系统LoadSetupData 第2637行CreateComputerTypeListsettings.c计算机类型列表LoadSetupData 第2643行CreateDisplayDriverListsettings.c显示驱动列表LoadSetupData 第2644行CreateKeyboardDriverListsettings.c键盘驱动列表LoadSetupData 第2645行CreateLanguageListsettings.c语言列表LoadSetupData 第2647行CreateKeyboardLayoutListsettings.c键盘布局列表LoadSetupData 第2669行IsValidInstallDirectorysetuplib.c验证安装目录MoreOptDlgProc 第312行InitSystemPartitionsetuplib.c设置活动系统分区安装线程 Step1FsVolCommitOpsQueuefsutil.c执行格式化/检查安装线程 Step2InitDestinationPathssetuplib.c初始化目标路径安装线程 Step3PrepareFileCopyinstall.c准备文件复制队列安装线程 Step4DoFileCopyinstall.c执行文件复制安装线程 Step5InstallSetupInfFilesetuplib.c创建winntwinntwinnt.inf安装线程 Step6UpdateRegistrysetuplib.c创建/更新注册表安装线程 Step7InstallBootManagerAndBootEntriesbootsup.c安装引导管理器到 MBR安装线程 Step8InstallBootcodeToRemovablebootsup.c安装引导到可移动介质安装线程 Step8FinishSetupsetuplib.c清理安装数据wWinMain 第3410行GetRegisteredFileSystemsfsutil.c获取注册的文件系统DriveDlgProc9. 安装流程图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) │设计要点概念说明属性表向导使用 Win32PropertySheet控件实现多步向导独立安装线程实际安装操作在PrepareAndDoCopyThread中异步执行setuplib 延迟加载通过setupDelayHook动态加载setuplib.dlltxtsetup.sif 驱动所有硬件列表从txtsetup.sif读取SetupAPI 文件队列使用 SetupAPI 管理文件复制、删除、重命名操作回调机制格式化/检查/复制/注册表操作通过回调更新 UI 进度ShiftF10 调试热键线程允许在安装过程中打开命令提示符无人值守支持通过unattend.inf自动跳过所有配置页面
