miao-moe/LanMountainDesktop
1
0
Fork 0
mirror of https://github.com/wwiinnddyy/LanMountainDesktop.git synced 2026-06-22 09:05:54 +08:00
Code Issues Packages Projects Releases Wiki Activity

Launcher (#4)

Browse Source 
* 激进的更新

* 试试

* fix.可爱的我一直在修CI（

* fix.启动器一定要能够启动

* feat.尝试弄了AOT的启动器。

* fix.修CI，好像是因为Linux那边有个问题，反正修就对了。

* fix.ci难修，为什么liunx跑不起来呢？

* Update build.yml

* Update LanMountainDesktop.csproj

* changed.调整了启动逻辑，优化了更新页面。

* changed.优化了更新体验

* feat.依旧试增量更新这一块，看看velopack

* fix.我们试验性地修复了启动器无法正常启动的问题，原因可能是这个画面没有启动，就GUI没显示。然后还把编译问题修了一下。

* fix.继续修ci，ci怎么天天炸

* changed.velopack，试试rust

* fix.修ci，修融合桌面，修启动器

* fix.GitHub Action工作流怎么天天出问题

* feat.引入velopack，不好，是rust（至少内存很安全了。

* chore: migrate release pipeline to signed filemap and wire rainyun s3

* fix: make optional s3 upload step workflow-parse safe

* fix: make delta pack generation robust for empty diffs and linux paths

* chore: rotate launcher update public key for pdc signing

* fix: restore stable launcher update public key

* fix: sync launcher public key with update signing secret

* fix: normalize PEM line endings in signing key validation

* fix: rotate launcher public key to match ci signing secret

* fix: compare signing keys by SPKI instead of PEM text

* refactor update backend to host-managed PDC pipeline

* fix release workflow env key collisions

* relax publish-pdc precheck to require S3 only

* set GH_TOKEN for PDCC installer step

* ci: add local pdc mock fallback for release publish

* ci: fix pdc mock process log redirection

* ci: fallback pdcc signing key to update private key

* ci: ensure pdcc signing passphrase env is always set

* ci: create pdcc publish root before invoking client

* ci: set pdcc version variable from release version

* ci: decouple pdcc installer version from publish config version

* ci: package pdcc subchannels with generated filemap and changelog

* ci: make local pdc mock diff return empty for fast fallback

* ci: fix pdcc variable mapping and pdc signing prechecks

* Update App.axaml.cs

* ci: wire aws cli credentials for rainyun s3

* ci: pin pdcc client version separately from app version

* ci: harden local pdc mock transport handling

* ci: publish pdcc subchannels in one pass

* ci: add pdcc publish heartbeat and timeout

* ci: fix pdcc publish workdir bootstrap

* feat.Penguin Logistics Online Network Distribution System

* ci: fix plonds s3 probe and signing fallback

* ci: validate signing key and quiet missing baselines

* ci: relax aws checksum mode for rainyun s3

* ci: avoid multipart uploads to rainyun s3

* ci: handle empty plonds baselines safely

* ci.plonds

* Rebuild release pipeline around PLONDS and DDSS

* Fix Windows installer script path in release workflow
This commit is contained in:
lincube
2026-04-21 20:59:52 +08:00
committed by GitHub
parent 03e32ee6cb
commit 4cb52e56c7
186 changed files with 44656 additions and 1248 deletions
Download Patch File Download Diff File Expand all files Collapse all files

335
docs/BUILD_AND_DEPLOY.md Normal file
View File

@@ -0,0 +1,335 @@
# 构建和部署指南
> LanMountainDesktop 完整构建、打包和发布流程
## 目录
- [本地构建](#本地构建)
- [发布构建](#发布构建)
- [生成安装包](#生成安装包)
- [CI/CD 流程](#cicd-流程)
- [手动发布](#手动发布)
## 本地构建
### 环境要求
- .NET SDK 10.0 或更高版本
- Windows 10/11 (推荐)
- Inno Setup 6 (仅生成安装包时需要)
### 快速构建
```bash
# 1. 还原依赖
dotnet restore LanMountainDesktop.slnx
# 2. 构建 Debug 版本
dotnet build LanMountainDesktop.slnx -c Debug
# 3. 运行主程序
dotnet run --project LanMountainDesktop/LanMountainDesktop.csproj
```
### 构建 Release 版本
```bash
dotnet build LanMountainDesktop.slnx -c Release
```
## 发布构建
### Windows (x64, 自包含)
```bash
dotnet publish LanMountainDesktop/LanMountainDesktop.csproj `
-c Release `
-o ./publish/windows-x64 `
--self-contained `
-r win-x64 `
-p:PublishSingleFile=false `
-p:DebugType=none `
-p:DebugSymbols=false
```
**发布后的目录结构:**
```
publish/windows-x64/
├── LanMountainDesktop.Launcher.exe ← 入口
├── app-{version}/ ← 主程序
│ ├── .current
│ ├── LanMountainDesktop.exe
│ └── ...
```
### Linux (x64)
```bash
dotnet publish LanMountainDesktop/LanMountainDesktop.csproj `
-c Release `
-o ./publish/linux-x64 `
--self-contained `
-r linux-x64
```
### macOS (arm64)
```bash
dotnet publish LanMountainDesktop/LanMountainDesktop.csproj `
-c Release `
-o ./publish/osx-arm64 `
--self-contained `
-r osx-arm64
```
## 生成安装包
### Windows 安装包 (Inno Setup)
**前提条件:**
```powershell
# 安装 Inno Setup
choco install innosetup -y
```
**生成安装包:**
```powershell
# 1. 发布应用
dotnet publish LanMountainDesktop/LanMountainDesktop.csproj `
-c Release `
-o ./publish/windows-x64 `
--self-contained `
-r win-x64
# 2. 运行 Inno Setup 编译器
$version = "1.0.0"
$arch = "x64"
iscc.exe `
/DMyAppVersion=$version `
/DMyAppArch=$arch `
/DPublishDir="publish\windows-x64" `
/DMyOutputDir="build-installer" `
LanMountainDesktop\installer\LanMountainDesktop.iss
```
**输出:**
```
build-installer/
└── LanMountainDesktop-Setup-1.0.0-x64.exe
```
### Linux 包 (.deb)
```bash
# TODO: 添加 .deb 打包脚本
```
### macOS 包 (.dmg)
```bash
# TODO: 添加 .dmg 打包脚本
```
## CI/CD 流程
### GitHub Actions 工作流
项目使用 GitHub Actions 自动化构建和发布。
**触发条件:**
- 推送 `v*` 标签 (例如: `v1.0.0`)
- 手动触发 (workflow_dispatch)
**工作流文件:** `.github/workflows/release.yml`
### 发布流程
```
1. prepare job
├─ 解析版本号
└─ 设置构建变量
2. build-windows job
├─ 构建 x64 和 x86 版本
├─ 重组为 app-{version} 结构
├─ 生成增量包
├─ 生成 Inno Setup 安装包
└─ 上传 artifacts
3. build-linux job
├─ 构建 x64 版本
├─ 生成 .deb 包
└─ 上传 artifacts
4. build-macos job
├─ 构建 arm64 和 x64 版本
├─ 生成 .dmg 包
└─ 上传 artifacts
5. release job
├─ 下载所有 artifacts
├─ 创建 GitHub Release
└─ 上传所有安装包和增量包
```
### 发布产物
**GitHub Release Assets:**
```
LanMountainDesktop-v1.0.0/
├── LanMountainDesktop-Setup-1.0.0-x64.exe # Windows 安装包
├── LanMountainDesktop-Setup-1.0.0-x86.exe
├── LanMountainDesktop-1.0.0-linux-x64.deb # Linux 包
├── LanMountainDesktop-1.0.0-macos-arm64.dmg # macOS 包
├── app-1.0.0.zip # 完整应用包
├── delta-0.9.9-to-1.0.0.zip # 增量包
├── files-1.0.0.json # 文件清单
└── files-1.0.0.json.sig # RSA 签名
```
## 手动发布
### 1. 准备发布
```bash
# 1. 更新版本号
# 编辑 Directory.Build.props 中的 <Version>
# 2. 更新 CHANGELOG.md
# 记录本次发布的变更
# 3. 提交变更
git add .
git commit -m "chore: prepare release v1.0.0"
git push
```
### 2. 创建 Release 标签
```bash
# 创建标签
git tag v1.0.0
# 推送标签 (触发 CI)
git push origin v1.0.0
```
### 3. 等待 CI 完成
访问 GitHub Actions 页面,等待构建完成:
```
https://github.com/YourOrg/LanMountainDesktop/actions
```
### 4. 验证 Release
1. 访问 Releases 页面
2. 检查所有安装包是否上传成功
3. 下载并测试安装包
4. 验证增量更新功能
### 5. 发布公告
- 在 GitHub Release 中编辑发布说明
- 发布到社区/论坛
- 更新官网下载链接
## 增量包生成
### 手动生成增量包
```powershell
# 1. 准备两个版本的发布目录
dotnet publish ... -o ./publish/app-1.0.0
dotnet publish ... -o ./publish/app-1.0.1
# 2. 生成增量包
./scripts/Generate-DeltaPackage.ps1 `
-PreviousVersion "1.0.0" `
-CurrentVersion "1.0.1" `
-PreviousDir "./publish/app-1.0.0" `
-CurrentDir "./publish/app-1.0.1" `
-OutputDir "./delta-output"
# 3. 签名文件清单
./scripts/Sign-FileMap.ps1 `
-FilesJsonPath "./delta-output/files-1.0.1.json" `
-PrivateKeyPath "./private-key.pem"
```
**输出:**
```
delta-output/
├── delta-1.0.0-to-1.0.1.zip
├── files-1.0.1.json
└── files-1.0.1.json.sig
```
### 生成 RSA 密钥对
```powershell
# 生成私钥
openssl genrsa -out private-key.pem 2048
# 提取公钥
openssl rsa -in private-key.pem -pubout -out public-key.pem
```
**重要:**
- 私钥保存在安全位置 (GitHub Secrets)
- 公钥打包到 Launcher 中 (`.launcher/update/public-key.pem`)
## 版本号规范
遵循 [Semantic Versioning 2.0.0](https://semver.org/):
```
MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]
例如:
- 1.0.0 (正式版)
- 1.0.1 (补丁版本)
- 1.1.0 (新功能)
- 2.0.0 (破坏性变更)
- 1.0.0-beta.1 (预览版)
- 1.0.0-rc.1 (候选版本)
```
### 版本号更新规则
- **MAJOR**: 破坏性 API 变更
- **MINOR**: 新功能,向后兼容
- **PATCH**: Bug 修复,向后兼容
- **PRERELEASE**: 预览版标识 (alpha, beta, rc)
## 故障排除
### 构建失败
**问题**: `error NU1102: Unable to find package`
**解决**:
```bash
dotnet restore --force
dotnet nuget locals all --clear
```
### 发布失败
**问题**: Launcher 目录不存在
**解决**: 检查 `LanMountainDesktop.csproj` 中的 `CopyLauncherToPublish` 目标是否正确执行。
### 安装包生成失败
**问题**: Inno Setup 找不到文件
**解决**: 确保 `PublishDir` 路径正确,且包含 `app-{version}/` 目录结构。
## 相关文档
- [开发文档](DEVELOPMENT.md)
- [Launcher 架构](LAUNCHER.md)
- [更新系统](UPDATE_SYSTEM.md)
- [故障排除](TROUBLESHOOTING.md)