构建与发布

Flu CLI 生态提供了完整的应用构建与多平台发布能力，让你可以 一键构建 + 并行上传 到多个应用商店，告别手动打包、逐个登录后台上传的繁琐流程。

上传引擎已独立为 @huoye/app-ship npm 包，不依赖 Flutter 或 VSCode，有安装包就能用。

✨ 核心特性

多平台并行上传：同时发布到多个应用商店，节省大量时间
统一配置文件：一个 flu_release.yaml 管理所有平台的凭证和参数
智能重试：网络波动时自动重试（指数退避策略），部分平台失败不影响其他平台
灵活模式：支持仅构建、仅上传、全量流水线三种模式
框架无关：app-ship 可用于 Flutter、React Native、原生等任何框架的安装包
环境变量：敏感凭证通过 ${VAR_NAME} 引用，避免明文写入配置文件

📦 支持平台

平台	标识	认证方式	支持文件	状态
蒲公英	`pgyer`	API Key	APK / IPA / AAB	✅ 可用
华为 AppGallery	`huawei`	OAuth2 (Client ID/Secret)	APK / AAB	✅ 可用
小米应用商店	`xiaomi`	邮箱 + API 密码 + RSA 公钥	APK	✅ 可用
OPPO 开放平台	`oppo`	Client ID/Secret	APK	✅ 可用
vivo 开发者平台	`vivo`	Access Key/Secret	APK	✅ 可用
腾讯应用宝	`tencent`	App ID/Key	APK	✅ 可用
Apple App Store	`app_store`	Apple ID + App Password / API Key	IPA	✅ 可用
鸿蒙应用市场	`harmony`	OAuth2 (Client ID/Secret)	HAP / APP	✅ 可用

💡 蒲公英是内测分发平台，适合开发/测试阶段快速分享安装包。其他均为正式应用商店。

🚀 三种使用方式

方式 1：VSCode 发布中心（推荐） ⭐

在 VSCode 中打开命令面板，搜索 Flu: Publish Center，即可进入可视化发布界面：

配置阶段 — 选择发布模式、目标渠道、输入版本号和更新日志
构建阶段 — 实时查看构建进度和日志
确认阶段 — 确认即将上传的文件和目标平台
上传阶段 — 监看并行上传进度
完成阶段 — 查看每个平台的结果（下载链接、二维码等）

→ 查看发布中心详解

方式 2：app-ship CLI（命令行）

安装独立上传引擎后，在终端直接使用：

bash

# 安装
npm install -g @huoye/app-ship

# 交互式发布（引导选择平台和配置）
app-ship upload

# 指定安装包上传
app-ship upload -f ./app-release.apk

# 指定平台
app-ship upload -f ./app-release.apk -p pgyer,huawei

# 查看支持的平台
app-ship platforms

# 生成配置文件模板
app-ship init

适合 CI/CD 自动化和命令行操作场景。

方式 3：app-ship npm 库（编程集成）

在 Node.js 项目中作为依赖使用，适合自建发布系统：

bash

npm install @huoye/app-ship

typescript

import { UploadManager } from '@huoye/app-ship'

const manager = new UploadManager()
const report = await manager.uploadToMultiplePlatforms(
  ['./app-release.apk'],
  config,
  { version: '1.0.0', changelog: '修复已知问题' }
)

📖 文档导航

想做什么？	去哪里看？
快速体验一次完整发布	快速上手
了解配置文件的所有字段	配置参考
配置某个具体平台	平台指南（选择你要的平台）
遇到问题了	常见问题

构建与发布 ​

✨ 核心特性 ​

📦 支持平台 ​

🚀 三种使用方式 ​

方式 1：VSCode 发布中心（推荐） ⭐ ​

方式 2：app-ship CLI（命令行） ​

方式 3：app-ship npm 库（编程集成） ​

📖 文档导航 ​