mirror of
https://github.com/wwiinnddyy/LanMountainDesktop.git
synced 2026-06-22 17:24:27 +08:00
ci_fixed2
This commit is contained in:
lincube
278
.github/WINDOWS_INSTALLER_SETUP.md
vendored
Normal file
278
.github/WINDOWS_INSTALLER_SETUP.md
vendored
Normal file
@@ -0,0 +1,278 @@
|
||||
# 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
|
||||
```yaml
|
||||
- name: Install Inno Setup
|
||||
run: choco install innosetup -y --no-progress
|
||||
shell: pwsh
|
||||
```
|
||||
|
||||
在Windows Runner上自动安装Inno Setup编译器。
|
||||
|
||||
#### 2. 替换步骤：构建安装程序
|
||||
原来的"Package"步骤（压缩为zip）现已改为"Build Installer"：
|
||||
|
||||
```yaml
|
||||
- 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. 更新步骤：上传安装程序
|
||||
```yaml
|
||||
- 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 更新
|
||||
```ini
|
||||
# 原来
|
||||
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. 架构支持增强
|
||||
```ini
|
||||
# 原来（仅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. **推送版本标签**
|
||||
```bash
|
||||
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`
|
||||
- 双击运行安装程序
|
||||
- 按照向导完成安装
|
||||
- 从开始菜单或桌面启动应用
|
||||
- 验证应用功能
|
||||
- 尝试从控制面板卸载
|
||||
|
||||
### 本地测试（可选）
|
||||
|
||||
如需本地测试安装程序生成：
|
||||
|
||||
```powershell
|
||||
# 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. 修改安装目录**
|
||||
```ini
|
||||
DefaultDirName={autopf}\{#MyAppName}
|
||||
```
|
||||
|
||||
**2. 添加协议关联**
|
||||
```ini
|
||||
[Registry]
|
||||
Root: HKCU; Subkey: "Software\Classes\.lanmountain"; ValueType: string; ValueName: ""; ValueData: "LanMountainDocument"
|
||||
```
|
||||
|
||||
**3. 修改压缩设置**
|
||||
```ini
|
||||
Compression=lzma2/ultra64 ; 超级压缩
|
||||
; Compression=lzma2/max ; 最大压缩（更慢）
|
||||
; Compression=bzip2 ; bzip2压缩
|
||||
```
|
||||
|
||||
**4. 添加许可证页面**
|
||||
```ini
|
||||
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版本时，使用以下说明：
|
||||
|
||||
```markdown
|
||||
## Windows 安装
|
||||
|
||||
### 64位系统
|
||||
下载 **LanMountainDesktop-Setup-{Version}-x64.exe**
|
||||
|
||||
### 32位系统
|
||||
下载 **LanMountainDesktop-Setup-{Version}-x86.exe**
|
||||
|
||||
### 安装步骤
|
||||
1. 双击 .exe 文件
|
||||
2. 按照向导完成安装
|
||||
3. 安装完成后从开始菜单启动应用
|
||||
|
||||
### 卸载步骤
|
||||
1. 打开"控制面板" → "程序" → "程序和功能"
|
||||
2. 找到 "LanMountainDesktop"
|
||||
3. 点击"卸载"按钮
|
||||
```
|
||||
|
||||
## 📚 相关文档
|
||||
|
||||
- [Inno Setup 官方文档](https://jrsoftware.org/isinfo.php)
|
||||
- [Inno Setup 脚本参考](https://jrsoftware.org/isdocs/)
|
||||
- [.github/workflows/release.yml](../workflows/release.yml) - 完整工作流定义
|
||||
|
||||
## ✨ 总结
|
||||
|
||||
通过使用Inno Setup生成.exe安装程序：
|
||||
- ✅ 用户体验改善：一键安装
|
||||
- ✅ 系统集成：开始菜单、卸载功能
|
||||
- ✅ 文件大小更小：内置LZMA2压缩
|
||||
- ✅ 专业形象：正式的安装向导
|
||||
|
||||
Windows用户现在能够以标准的.exe安装程序方式安装LanMountainDesktop应用！
|
||||
Reference in New Issue
Block a user