安装程序返回代码 - EasyKiConverter¶
本文档说明 EasyKiConverter 安装程序在各种安装场景下的返回代码值，供 Microsoft Store 应用分发使用。
安装程序类型¶
EasyKiConverter 使用 Inno Setup 创建的 Windows 安装程序（.exe 格式）。
静默安装参数¶
标准静默安装¶
超级静默安装（不显示任何窗口）¶
不创建桌面快捷方式¶
完整安装参数¶
安装程序返回代码¶
| 返回代码 | 含义 | 说明 |
|---|---|---|
| 0 | 安装成功 | 安装程序成功完成 |
| 1 | 安装失败 | 安装程序初始化失败 |
| 2 | 用户取消 | 用户在实际安装开始前点击取消，或在开始消息框中选择"否" |
| 3 | 致命错误 | 在准备进入下一安装阶段时发生致命错误 |
| 4 | 安装过程错误 | 在实际安装过程中发生致命错误 |
| 5 | 用户中断 | 用户在实际安装过程中点击取消，或在 Abort-Retry-Ignore 消息框中选择 Abort |
| 6 | 强制终止 | 安装过程被调试器强制终止 |
| 7 | 无法继续安装 | 准备安装阶段确定无法继续安装 |
| 8 | 需要重启 | 准备安装阶段确定无法继续安装，且需要重启系统以解决问题 |
标准安装方案¶
注意: Inno Setup 提供的返回代码有限，某些不同场景会返回相同的代码值。以下是各场景的映射关系：
1. 用户已取消安装¶
- 返回代码: 2
- 说明: 用户在实际安装开始前点击取消，或在开始消息框中选择"否"
- 场景: 用户点击安装向导中的"取消"按钮或在确认对话框中选择"否"
2. 应用程序已存在¶
- 返回代码: 7
- 说明: 准备安装阶段检测到应用程序已存在
- 场景: 检测到目标位置已存在应用程序，但仍继续安装（覆盖安装）
- 说明: 虽然会覆盖安装并成功，但为了区分场景，使用代码 7
3. 安装已在进行¶
- 返回代码: 3
- 说明: 在准备进入下一安装阶段时发生致命错误
- 场景: 内存不足或 Windows 资源不足等异常情况
4. 磁盘空间已满¶
- 返回代码: 4
- 说明: 在实际安装过程中发生致命错误
- 场景: 系统磁盘剩余空间小于安装程序所需空间（约 200MB）
5. 需要重新启动¶
- 返回代码: 8
- 说明: 准备安装阶段确定无法继续安装，且需要重启系统
- 场景: 某些文件或系统组件需要重启后才能生效
6. 网络故障¶
- 返回代码: 4
- 说明: 在实际安装过程中发生致命错误
- 场景: 下载依赖包时网络中断
- 注意: 与磁盘空间已满共享返回代码 4
7. 已在安装期间拒绝包¶
- 返回代码: 7
- 说明: 准备安装阶段确定无法继续安装
- 场景: 设备上启用了安全策略，权限不足或安全软件阻止安装
- 注意: 与应用程序已存在共享返回代码 7
8. 安装成功¶
- 返回代码: 0
- 说明: 安装程序成功完成
- 场景: 正常安装流程顺利完成（包括覆盖安装）
其他安装失败方案¶
权限不足¶
- 返回代码: 7
- 说明: 准备安装阶段确定无法继续安装
- 场景: 以普通用户身份运行安装程序
文件被占用¶
- 返回代码: 4
- 说明: 在实际安装过程中发生致命错误
- 场景: 应用程序正在运行时尝试安装
损坏的安装包¶
- 返回代码: 1
- 说明: 安装程序初始化失败
- 场景: 安装程序下载不完整或被修改
依赖项缺失¶
- 返回代码: 7
- 说明: 准备安装阶段确定无法继续安装
- 场景: 系统未安装 Visual C++ Redistributable
依赖项缺失（安装过程中检测）¶
- 返回代码: 4
- 说明: 在实际安装过程中发生致命错误
- 场景: 安装过程中发现系统缺少必要的运行时环境
安装程序信息¶
- 名称: EasyKiConverter Setup
- 版本: 3.0.9
- 架构: x64
- 类型: Inno Setup (.exe)
- 大小: 约 100-150 MB
- 签名: 包含数字签名
系统要求¶
- 操作系统: Windows 10/11 (64-bit)
- 权限: 需要管理员权限
- 磁盘空间: 至少 200MB
- 网络: 不需要（除非从网络下载）
技术支持¶
如果遇到安装问题，请通过以下方式联系：
- GitHub Issues: https://github.com/tangsangsimida/EasyKiConverter/issues
- 文档: https://tangsangsimida.github.io/EasyKiConverter/
- 电子邮件: 请参考开发者联系信息