LanMountainDesktop/.github/WINDOWS_INSTALLER_SETUP.md

Windows 安装包配置指南

执行时间：2026年3月5日

📦 Windows 打包改为 .exe 安装程序

🎯 改进内容

Windows CI/CD工作流已更新，从生成.zip压缩包改为生成Inno Setup .exe安装程序。

特性	原来	现在
输出格式	.zip 压缩包	✅ .exe 安装程序
用户体验	手动解压	✅ 一键安装
系统集成	无	✅ 开始菜单、桌面快捷方式
卸载	手动删除	✅ 系统控制面板卸载
文件大小	~250-300 MB	~150-200 MB (已有内置压缩)

🔧 实施细节

.github/workflows/release.yml 变更

1. 新增步骤：安装Inno Setup

- name: Install Inno Setup
  run: choco install innosetup -y --no-progress
  shell: pwsh

在Windows Runner上自动安装Inno Setup编译器。

2. 替换步骤：构建安装程序

原来的"Package"步骤（压缩为zip）现已改为"Build Installer"：

- name: Build Installer
  run: |
    $version = "${{ needs.prepare.outputs.version }}"
    $arch = "${{ matrix.arch }}"
    $publishDir = "publish\windows-$arch"
    $installerScript = "LanMountainDesktop\installer\LanMountainDesktop.iss"
    $outputDir = "build-installer"
    
    # 查找Inno Setup编译器
    $isccPath = "C:\Program Files (x86)\Inno Setup 6\ISCC.exe"
    
    # 编译安装程序
    $compileCmd = @(
      "`"$isccPath`"",
      "/DMyAppVersion=$version",
      "/DPublishDir=..\$publishDir",
      "/DMyOutputDir=..\$outputDir",
      "/DMyAppArch=$arch",
      "`"$installerScript`""
    ) -join " "
    
    # 执行编译
    Invoke-Expression $compileCmd 2>&1

3. 更新步骤：上传安装程序

- name: Upload Installer
  uses: actions/upload-artifact@v4
  with:
    name: release-windows-${{ matrix.arch }}
    path: build-installer/*.exe
    retention-days: 30

上传 .exe 安装程序而不是 .zip。

LanMountainDesktop/installer/LanMountainDesktop.iss 变更

1. OutputBaseFilename 更新

# 原来
OutputBaseFilename={#MyAppName}-Setup-{#MyAppVersion}

# 现在
OutputBaseFilename={#MyAppName}-Setup-{#MyAppVersion}-{#MyAppArch}

输出文件名现在包含架构标识（x64或x86），例如：

• LanMountainDesktop-Setup-1.0.0-x64.exe
• LanMountainDesktop-Setup-1.0.0-x86.exe

2. 架构支持增强

# 原来（仅x64）
#if MyAppArch == "x64"
ArchitecturesAllowed=x64compatible
ArchitecturesInstallIn64BitMode=x64compatible
#endif

# 现在（支持x64和x86）
#if MyAppArch == "x64"
ArchitecturesAllowed=x64compatible
ArchitecturesInstallIn64BitMode=x64compatible
#else
#if MyAppArch == "x86"
ArchitecturesAllowed=x86compatible
#endif
#endif

📊 生成的安装程序功能

安装程序 (LanMountainDesktop-Setup-{Version}-{Arch}.exe)

✅ 功能：

• 一键安装到 C:\Program Files\LanMountainDesktop 或 C:\Program Files (x86)\
• 创建开始菜单快捷方式
• 可选：创建桌面快捷方式
• 可选：安装后启动应用
• 支持系统卸载（控制面板 → 程序 → 卸载程序）

✅ 压缩：

• LZMA2 超级压缩（lzma2/ultra64）
• 实体压缩（SolidCompression）
• 减少文件大小 ~35-50%

✅ 安全：

• 需要管理员权限安装
• AppId 唯一标识符防止冲突
• 自动处理先前版本的覆盖安装

🚀 测试说明

CI/CD 验证

1. 推送版本标签

   git tag v1.0.0-installer-test
   git push origin v1.0.0-installer-test
   

2. 监察GitHub Actions

   • 检查"Install Inno Setup"步骤是否成功
   • 检查"Build Installer"步骤的编译日志
   • 验证"Upload Installer"步骤是否上传了.exe文件

3. 下载并测试

   • 从发布页面下载 LanMountainDesktop-Setup-1.0.0-x64.exe
   • 双击运行安装程序
   • 按照向导完成安装
   • 从开始菜单或桌面启动应用
   • 验证应用功能
   • 尝试从控制面板卸载

本地测试（可选）

如需本地测试安装程序生成：

# Windows PowerShell

# 1. 发布应用
dotnet publish LanMountainDesktop\LanMountainDesktop.csproj `
  -c Release -r win-x64 --self-contained `
  -p:PublishSingleFile=true -p:PublishTrimmed=true `
  -o publish\windows-x64

# 2. 安装Inno Setup（如未安装）
choco install innosetup -y

# 3. 编译安装程序
$isccPath = "C:\Program Files (x86)\Inno Setup 6\ISCC.exe"
& "$isccPath" /DMyAppVersion=1.0.0 `
  /DPublishDir=.\publish\windows-x64 `
  /DMyOutputDir=.\build-installer `
  /DMyAppArch=x64 `
  .\LanMountainDesktop\installer\LanMountainDesktop.iss

# 4. 测试安装程序
.\build-installer\LanMountainDesktop-Setup-1.0.0-x64.exe

⚙️ 自定义安装程序

如需修改安装程序外观或行为，编辑 LanMountainDesktop/installer/LanMountainDesktop.iss：

常见自定义

1. 修改安装目录

DefaultDirName={autopf}\{#MyAppName}

2. 添加协议关联

[Registry]
Root: HKCU; Subkey: "Software\Classes\.lanmountain"; ValueType: string; ValueName: ""; ValueData: "LanMountainDocument"

3. 修改压缩设置

Compression=lzma2/ultra64  ; 超级压缩
; Compression=lzma2/max   ; 最大压缩（更慢）
; Compression=bzip2        ; bzip2压缩

4. 添加许可证页面

LicenseFile=LICENSE.txt
InfoBeforeFile=INSTALLATION_INFO.txt
InfoAfterFile=POST_INSTALLATION_INFO.txt

🔍 故障排除

Inno Setup 不存在

错误：Inno Setup compiler not found at: C:\Program Files (x86)\Inno Setup 6\ISCC.exe

解决：

• Windows Runner 已配置自动安装Inno Setup
• 如果CI失败，检查网络连接或choco是否可用
• 本地测试时可能需要手动安装：choco install innosetup

安装程序编译失败

错误：Failed to create installer 或 ISCC编译错误

检查清单：

1. ✅ 发布目录确实存在：publish\windows-x64\
2. ✅ 发布目录包含可执行文件
3. ✅ Inno Setup脚本语法正确
4. ✅ ISCC路径正确

安装后找不到应用

原因：可能禁用了"开始菜单"快捷方式

解决：

• 检查 C:\Program Files\LanMountainDesktop
• 从文件管理器直接运行 LanMountainDesktop.exe
• 检查.iss脚本中的[Icons]部分

📝 发布说明模板

当发布Windows版本时，使用以下说明：

## Windows 安装

### 64位系统
下载 **LanMountainDesktop-Setup-{Version}-x64.exe**

### 32位系统
下载 **LanMountainDesktop-Setup-{Version}-x86.exe**

### 安装步骤
1. 双击 .exe 文件
2. 按照向导完成安装
3. 安装完成后从开始菜单启动应用

### 卸载步骤
1. 打开"控制面板" → "程序" → "程序和功能"
2. 找到 "LanMountainDesktop"
3. 点击"卸载"按钮

📚 相关文档

• Inno Setup 官方文档
• Inno Setup 脚本参考
• .github/workflows/release.yml - 完整工作流定义

✨ 总结

通过使用Inno Setup生成.exe安装程序：

• ✅ 用户体验改善：一键安装
• ✅ 系统集成：开始菜单、卸载功能
• ✅ 文件大小更小：内置LZMA2压缩
• ✅ 专业形象：正式的安装向导

Windows用户现在能够以标准的.exe安装程序方式安装LanMountainDesktop应用！