钰信版本发布

钰信的版本管理入口位于平台管理端：系统管理 -> 应用版本。它是平台层能力，可为所有租户统一下发版本信息。

发布前提

• Android 首装和后续更新必须使用同一份发布签名；签名丢失后已安装用户无法覆盖升级。
• 版本名和构建号来自 Flutter pubspec.yaml，例如 1.0.1+2 表示版本名 1.0.1、构建号 2。
• 每次正式发布的构建号必须大于已发布记录；不要替换已发布的同名安装包。

Android 发布流程

1. 使用正式域名构建 release APK。
2. 登录平台管理端，进入“系统管理 -> 应用版本 -> 新增”。
3. 填写应用标识 yuxin、渠道 prod、平台 Android、版本名、构建号和更新日志。
4. 点击“安装包上传”，选择 APK。后端会校验扩展名，并自动回填下载地址、包大小和 SHA-256。
5. 检查字段后先保存草稿，再在列表中点击“发布”。
6. 使用低版本测试包进入“设置 -> 关于钰信 -> 检查更新”，确认可下载、校验并唤起系统安装页。

平台差异

平台	允许上传	更新动作	发布建议
Android	.apk	下载、校验 SHA-256、唤起系统安装。	上传正式签名 APK。
iOS	.ipa	打开配置的分发地址。	使用 TestFlight、App Store、MDM 或企业分发，不绕过 Apple 签名与审核规则。
鸿蒙	.hap、.app	打开配置的分发地址。	接入鸿蒙工程后，使用华为应用市场或企业分发。

更新策略

• 普通更新：用户启动 App 后检查，更新状态显示在“关于钰信”页面。
• 强制更新：仅用于安全修复或协议不兼容；旧构建号低于最低可用构建号时不可继续使用。
• 当前只发布整包更新。Dart OTA 补丁属于后续能力，未接入客户端执行器前不得在生产发布 PATCH 记录。

包存储与回退

上传包由后端文件服务保存，并应持久化到宿主机文件目录。出现问题时先在平台后台“暂停”该发布记录，再发布新的更高构建号修复包；不要删除已发布记录或覆盖原文件，以便审计和回溯。