14.14 发布流程

OpenClaw macOS 应用的发布流程包括构建、签名、公证和分发等步骤。

发布前准备

• 开发者证书:使用 Developer ID 证书进行签名
• Sparkle 配置:设置 SPARKLE_PRIVATE_KEY_FILE 环境变量
• 公证凭证:配置 Apple 公证服务凭证
• 版本号:使用数字格式的 APP_BUILD 版本号

构建和打包

使用打包脚本生成发布版本:

# 使用发布脚本打包
./scripts/package-mac-dist.sh

# 生成 Sparkle appcast
./scripts/make_appcast.sh

发布检查清单

1. 签名验证:确认应用使用 Developer ID 证书签名
2. 打包应用:使用 package-mac-dist.sh 生成分发包
3. 生成更新清单:通过 make_appcast.sh 生成 appcast
4. 上传文件:将 ZIP、DMG 和 dSYM 文件上传到 GitHub Releases
5. 验证 appcast:确保 appcast URL 返回 200 状态码
6. 测试更新流程:从"关于"标签中选择"检查更新",验证 Sparkle 能正确安装新版本

版本管理

• 使用语义化版本号(例如:2026.1.29)
• 在 GitHub Releases 中创建对应的版本标签
• 提供详细的更新日志说明
• 保留 dSYM 符号文件用于崩溃分析

分发渠道

OpenClaw macOS 应用通过以下方式分发:

• GitHub Releases:主要分发渠道
• 应用内更新:通过 Sparkle 框架实现自动更新
• 直接下载:用户可以下载 DMG 或 ZIP 文件手动安装