发布中心
📖 构建配置、平台凭证和 CLI 命令详情请查看 构建与发布。
发布中心（Publish Center）是 Flu CLI VSCode 扩展内置的可视化发布工具，让你无需离开编辑器即可完成构建和多平台上传。底层使用 @huoye/app-ship 上传引擎。
打开发布中心
- 打开命令面板（
Cmd+Shift+P/Ctrl+Shift+P） - 输入
Flu: Publish Center - 回车打开发布中心面板
三种发布模式
发布中心支持三种模式，覆盖不同场景：
| 模式 | 说明 | 适用场景 |
|---|---|---|
| 仅构建 (Build) | 只执行 Flutter 编译，生成 APK/IPA | 只想打包，暂不上传 |
| 仅上传 (Upload) | 上传已有的安装包到应用商店 | 手里有包，直接分发 |
| 构建 + 上传 (Both) | 先编译再自动上传 | 完整流水线，一步到位 |
💡 仅上传模式 不需要 Flutter 项目环境，可以上传任意来源的 APK / IPA / HAP 文件。
发布流程
发布中心将整个流程拆分为 5 个阶段，依次引导你完成：
阶段 1：配置（Config）
配置面板提供以下功能区域：
- 工程设置 — 选择 Flutter 项目目录，点击「一键同步」自动读取 pubspec.yaml、加载已有密钥、扫描构建产物
- 资源包池 — 自动扫描项目 build 目录下的安装包，支持手动添加外部文件，勾选要上传的文件
- 构建平台 — 仅构建/全量模式下显示，选择 Android / iOS 等目标平台
- 版本号 — 上传模式下可自由编辑；构建模式下可选择递增策略（保持/修订号+1/次版本+1/主版本+1）
- 更新日志 — 填写全局更新说明，也可按平台设置专属日志
- 分发渠道 — 勾选目标平台：内测托管（蒲公英）和各大应用商店
- 密钥配置 — 各渠道的 API 密钥和凭证，支持从
flu_release.yaml文件加载或 UI 手动输入
右侧清单栏实时显示已选配置摘要和校验状态。
阶段 2：构建（Build）
- 一键执行
flutter build apk/flutter build ipa - 实时显示构建日志输出
- 构建完成后自动定位产物文件，显示文件大小和耗时
阶段 3：确认（Confirm）
- 展示即将上传的产物信息（文件大小、路径）
- 显示目标平台列表
- 确认后进入上传阶段
此阶段仅在「构建 + 上传」模式下出现，给你最后的检查机会。
阶段 4：上传（Upload）
- 并行上传到所有配置的平台（最大并发 3 个）
- 每个平台独立显示进度和状态
- 失败平台自动重试（指数退避策略）
- 支持的平台：蒲公英、华为、小米、OPPO、vivo、腾讯应用宝、App Store、鸿蒙
阶段 5：完成（Done）
- 汇总所有平台上传结果
- 横排卡片布局：Android 与 iOS 结果并排展示，视觉更直观
- 独立结果项：每个平台拥有专属的二维码、下载链接及一键复制按钮
- 后台跳转：点击「前往后台」按钮，直接在浏览器中打开渠道管理页面
外部包上传
发布中心不仅服务于当前 Flutter 项目，还支持上传任意来源的安装包：
- 在资源包池中点击「选择安装包」
- 选择本地的
.apk/.ipa/.hap文件 - 系统自动解析包信息（版本号、包名、架构等）
- 选择目标渠道，直接上传
此时发布中心会自动切换为「外部包模式」，无需 Flutter 项目环境。
配置密钥
上传前需要配置各平台的 API 密钥。有两种方式：
方式 1：从配置文件加载
将密钥写入项目根目录的 flu_release.yaml，点击「一键同步」自动加载：
yaml
# flu_release.yaml
publish:
pgyer:
apiKey: ${PGYER_API_KEY}
huawei:
clientId: ${HUAWEI_CLIENT_ID}
clientSecret: ${HUAWEI_CLIENT_SECRET}方式 2：UI 手动输入
在发布中心的密钥配置区域直接输入，密钥会在上传时临时使用，也可选择保存到配置文件。
🔐 推荐使用环境变量避免泄露。在 VSCode 终端中设置环境变量，或使用
.env文件（已加入.gitignore）。
了解更多
- 构建与发布 · 快速开始 — 5 分钟完成首次发布
- 配置参考 —
flu_release.yaml完整字段说明 - 平台指南 — 各平台凭证获取和配置
- 常见问题 — 构建和上传问题排查