快速上手

本指南帮助你在 5 分钟内 完成首次应用发布。我们将以蒲公英（最简单的平台）为例，走完从配置到上传的全流程。

前提条件

app-ship 已安装（npm install -g @huoye/app-ship）
已有可上传的安装包（APK / IPA），或已有可正常构建的 Flutter 项目
已注册蒲公英账号（www.pgyer.com）

💡 如果你只想通过 VSCode 可视化发布，无需安装 app-ship，直接使用发布中心即可。

Step 1：创建配置文件

在项目根目录执行：

bash

app-ship init

会在当前目录生成一个 flu_release.yaml 模板配置文件。

你也可以手动创建 flu_release.yaml：

yaml

# flu_release.yaml — 发布配置文件

build:
  android:
    type: 'apk'

publish:
  pgyer:
    enable: true
    apiKey: 'your-api-key-here'

Step 2：获取蒲公英 API Key

登录蒲公英官网
进入 账户设置 → API 信息
复制你的 API Key

将 API Key 填入配置文件：

yaml

publish:
  pgyer:
    enable: true
    apiKey: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'

🔐 安全提示：建议使用环境变量替代明文：
yaml
apiKey: '${PGYER_API_KEY}'
然后在终端中设置：export PGYER_API_KEY=xxxxxxxx

Step 3：执行发布

方式 A：app-ship 命令行

bash

app-ship upload

app-ship 会引导你完成以下步骤：

✓ 配置校验通过

当前版本: 1.0.0 (buildNumber: 1)

? 选择版本增长策略:
❯ 保持当前 (1.0.0+1)
  修订号 +1 (1.0.1+1)
  次版本 +1 (1.1.0+1)
  主版本 +1 (2.0.0+1)

? 输入更新说明: 修复若干 Bug，优化性能

? 选择上传平台:
❯ ◉ 蒲公英 (Pgyer)

✓ 正在上传到蒲公英...
✓ 上传成功！
  下载链接: https://www.pgyer.com/xxxxx
  二维码: https://www.pgyer.com/qrcode/xxxxx

你也可以直接指定安装包文件：

bash

# 指定文件上传
app-ship upload -f ./build/app/outputs/apk/release/app-release.apk

# 指定平台 + 更新说明
app-ship upload -f ./app.apk -p pgyer --changelog "修复已知问题"

方式 B：VSCode 发布中心

打开命令面板（Cmd+Shift+P / Ctrl+Shift+P）
搜索 Flu: Publish Center
在可视化界面中选择渠道、填写信息
点击「开始执行」

→ 查看发布中心详解

Step 4：查看结果

发布成功后，你将看到：

下载链接 — 直接分享给测试人员
二维码 — 手机扫码即可安装（蒲公英特有）
控制台链接 — 跳转到对应平台的管理后台

如果上传失败，查看错误信息并参考常见问题。

🎯 下一步

恭喜你完成了首次发布！接下来你可以：

添加更多平台：在 flu_release.yaml 中启用更多平台，实现一键多平台发布
深入了解配置：查看配置参考了解所有可用字段

仅上传指定文件：

bash

app-ship upload -f ./app-release.apk -p pgyer,huawei

快速上手 ​

前提条件 ​

Step 1：创建配置文件 ​

Step 2：获取蒲公英 API Key ​

Step 3：执行发布 ​

方式 A：app-ship 命令行 ​

方式 B：VSCode 发布中心 ​

Step 4：查看结果 ​

🎯 下一步 ​

快速上手

前提条件

Step 1：创建配置文件

Step 2：获取蒲公英 API Key

Step 3：执行发布

方式 A：app-ship 命令行

方式 B：VSCode 发布中心

Step 4：查看结果

🎯 下一步