一、写在前面

好久不见~

最近把自己本地用的一个 Flutter 打包发布工具 整理了一下，做成了一个开源项目。

项目名称叫 Open Release Pilot，主要用来处理 Flutter App 发布时的一些重复工作，比如：

• Flutter Android 多渠道打包
• Android 渠道包输出和命名
• iOS IPA 构建
• App Store Connect / TestFlight 上传流程
• 蒲公英发布
• 华为、小米、应用宝等应用市场上传配置
• Flutter App 发布记录保存
• 局域网扫码安装 APK

项目地址：

https://github.com/langyuxiansheng/open-release-pilot

GitHub 主页：

https://github.com/langyuxiansheng

如果你正在搜索这些问题：

• Flutter 怎么做 Android 多渠道打包？
• Flutter 怎么批量生成不同渠道的 APK？
• Flutter iOS 怎么打 IPA？
• Flutter IPA 怎么上传 App Store Connect？
• Flutter 打包后怎么上传蒲公英？
• 有没有本地的 App 打包发布管理工具？
• Android 应用市场发布参数怎么统一管理？

那这个项目可能刚好能用上。

说白了，它不是一个很重的 CI/CD 平台，也不是要替代 Jenkins、GitHub Actions 这些东西。

它更像是一个本地发布工作台。

有些项目发布阶段还没有完全平台化，或者公司里就是习惯本机打包、人工确认、再上传应用市场。这个时候如果全靠命令行和手动记录，时间久了就很容易乱。

我自己遇到的情况大概是这样：

• Android 要给不同渠道打包，也就是常见的 Android 多渠道打包。
• 每个渠道包要放到指定版本目录。
• 包名要按版本号、构建号、渠道名去命名。
• iOS 有时候只打 IPA，有时候要上传 App Store Connect，有时候又要进入 TestFlight。
• 蒲公英这类测试分发平台要维护 API Key、包路径、更新说明。
• 应用市场发布要填一堆包路径、App ID、密钥、审核备注、更新说明。
• 打完包后还要知道哪个包存在、哪个没出、上传记录是什么。
• 测试同事要包时，还希望能直接扫码安装。

这些事情都不难，但是每次发布都要重复做，比较烦。

所以就做了这个工具。

二、先看效果

2.1 Flutter Android / iOS 打包工作台

这个页面主要看当前版本、输出目录、本地数据库路径，然后执行 Flutter Android 打包和 Flutter iOS IPA 构建。

Android 打包这里可以选择渠道，查看每个 Android 渠道包是否已经输出，也可以直接删除当前版本的渠道包。

iOS 这块支持只打包 IPA，也支持打完之后继续走 App Store Connect / TestFlight 相关流程。

2.2 应用市场上传配置和发布说明管理

这个页面主要是放应用市场相关配置。

比如蒲公英、华为、小米、应用宝这些平台，每个平台都有自己的字段。这里可以维护 APK 路径、接口密钥、应用市场发布说明、审核备注等。

当前打包流程和蒲公英发布流程已经可以正常使用，其它应用市场的配置也已经先整理到面板里了，不过部分自动上传能力还在调试和测试中。

2.3 Flutter 项目发布配置管理

这个页面是整个工具比较核心的地方。

每个 Flutter 项目的路径、版本文件、版本号匹配规则、输出目录、命名模板、渠道列表都在这里配置。

配置完之后，打包工作台和分发管理都会按当前项目来处理。

三、安装使用

项目是一个本地 Node 服务，没有数据库依赖，也没有复杂部署。

git clone https://github.com/langyuxiansheng/open-release-pilot.git
cd open-release-pilot
npm start

启动之后终端会输出地址：

Open Release Pilot: http://127.0.0.1:8787
Open Release Pilot LAN: http://192.168.1.10:8787

浏览器打开本地地址就可以。

第一次打开之后，先去「项目管理」页面，把示例项目路径换成自己的 Flutter 项目路径。

如果端口被占用，可以换端口：

./start.sh --port 8788

看端口状态：

./start.sh --status

停止服务：

./start.sh --stop

四、这个 Flutter 发布工具主要解决什么

4.1 Flutter 多项目发布配置

一个发布工具如果只能写死一个项目路径，其实用不了多久就会变得很难维护。

所以 Open Release Pilot 支持多项目配置。

每个项目可以单独配置：

• 项目名称
• 项目根目录
• 应用短名
• 版本文件
• 版本号正则
• 构建号正则
• Android 输出目录
• iOS 输出目录
• APK 命名模板
• IPA 命名模板
• Android 渠道列表
• iOS 发布配置
• 应用市场配置

这些数据会保存在本地：

data/projects-db.json

这个文件默认被 .gitignore 忽略，不会提交到仓库。

4.2 Flutter Android 多渠道打包

Flutter Android 多渠道打包是很多 App 发布都会遇到的问题。

Open Release Pilot 的 Android 打包脚本会进入你的 Flutter 项目目录，然后按渠道执行：

flutter build apk --release --dart-define="TAG_CHANNEL=${CHANNEL}"

打完之后把 APK 复制到配置好的目录里，并按模板生成渠道包文件名。

目录结构大概是这样：

{androidOutputRoot}/{versionName}/{channel.dir}/{apkNameTemplate}

比如：

~/Desktop/AndroidPackages/3.5.0/xiaomi/myapp-3.5.0-68-XIAOMI.apk

这里有个比较实用的小处理：如果目标 APK 已经存在，并且文件非空，脚本会跳过这个渠道。

这样发布到一半中断了，重新执行时不用全部重来。

如果想强制重打某个渠道，可以先在页面上把对应包删除。

4.3 Flutter iOS IPA 构建和 App Store Connect 上传

iOS 发布常见的问题是：怎么打 IPA、怎么管理 ExportOptions、怎么上传 App Store Connect 或 TestFlight。

Open Release Pilot 目前支持三种目标：

• 仅打包 IPA
• 打包并上传 App Store Connect
• 打包并用于 TestFlight

iOS 脚本执行的是：

flutter build ipa --export-options-plist="$IOS_EXPORT_OPTIONS_PLIST"

构建完成后，会把 build/ios/ipa 下面的 IPA 复制到你配置的输出目录里。

如果选择上传 App Store Connect / TestFlight，服务端会在 IPA 存在后调用 xcrun altool。

这里涉及 Apple Key ID、Issuer ID、.p8 私钥路径，这些都只建议放在本机，不要提交。

4.4 Android 应用市场上传配置管理

目前内置了这些平台的配置：

平台	当前定位
蒲公英	API 上传，当前流程已 OK
华为	API 参数模板，还在调试测试中
小米	API 参数模板，还在调试测试中
应用宝	API 更新应用信息，还在调试测试中
荣耀	人工上传模板
OPPO	人工上传模板
vivo	人工上传模板

为什么有些是 API，有些是人工模板？

因为每个平台开放能力不一样，有些接口稳定一些，有些平台还是人工后台更靠谱。

所以这里先做成应用市场发布配置中心，把账号备注、APK 路径、截图路径、隐私协议、版本更新说明、审核备注这些集中管理。

能走接口上传的再走接口，暂时不能走接口的就作为人工上传清单。

这里也说明一下当前进度：

• Android 多渠道打包流程已经 OK。
• iOS IPA 构建流程已经接入。
• 蒲公英发布流程已经 OK。
• 其它应用市场的配置项还在继续完善，有些字段可能还不是很全。
• 华为、小米、应用宝等自动上传还在调试测试中，使用前建议先自己确认接口参数。

4.5 Flutter 发布记录本地保存

打包和上传相关记录会保存到：

data/release-db.json

这里面会记录版本、包扫描结果、构建记录、上传记录等。

同样，这个文件默认不提交。

五、常用配置项

项目配置里我觉得比较关键的是这些：

字段	说明
rootPath	Flutter 项目根目录
versionFile	版本文件，Flutter 默认是 android/local.properties
versionNamePattern	读取版本号的正则
versionCodePattern	读取构建号的正则
androidOutputRoot	Android 渠道包输出目录
iosOutputRoot	iOS IPA 输出目录
androidApkSource	Flutter 构建后的源 APK 路径
apkNameTemplate	APK 命名模板
ipaNameTemplate	IPA 命名模板
channels	Android 渠道列表

命名模板支持这些变量：

{appSlug}
{versionName}
{versionCode}
{channel}

比如：

{appSlug}-{versionName}-{versionCode}-{channel}.apk
{appSlug}-{versionName}-{versionCode}.ipa

渠道配置大概长这样：

[
  { "code": "PGYER", "dir": "pgyer", "name": "蒲公英" },
  { "code": "XIAOMI", "dir": "xiaomi", "name": "小米" },
  { "code": "HUAWEI", "dir": "huawei", "name": "华为" },
  { "code": "SJQQ", "dir": "sjqq", "name": "应用宝" }
]

六、项目结构

整个项目结构比较简单：

open-release-pilot/
├── config/
│   └── stores.example.json
├── data/
├── public/
├── scripts/
│   ├── build_android_channels.sh
│   ├── build_ios_release.sh
│   └── start_panel.sh
├── server/
├── server.js
├── start.sh
├── package.json
└── README.md

前端就是静态页面，没有打包流程。

服务端用 Node 原生 HTTP，没有引入 Express。

数据用 JSON 文件保存，不需要装 MySQL、Redis 这些。

七、注意事项

这个工具是本地发布工具，所以安全这块要注意。

不要提交这些东西：

• data/*.json
• config/stores.local.json
• .env
• Android 签名文件
• iOS 证书
• .p8
• .p12
• .mobileprovision
• 应用市场密钥
• Apple Team ID
• 测试账号和密码

另外，面板里有本地文件选择能力，所以建议只在可信网络里使用，不要直接暴露到公网。

如果只是本机访问，可以这样启动：

HOST=127.0.0.1 npm start

如果要让手机扫码安装，就保持默认的 0.0.0.0，让同局域网设备可以访问。

八、和 CI/CD 的关系

这个工具不是为了替代 CI/CD。

我更希望它解决的是“本机发布流程太散”的问题。

比如：

• 项目还没上完整 CI/CD。
• 发布流程里有很多人工确认步骤。
• 多渠道参数暂时不想放到远程平台。
• 需要一个工具把路径、配置、记录和状态串起来。

等流程稳定以后，再把这些脚本接到 CI/CD 也可以。

九、写在后面

项目地址：

https://github.com/langyuxiansheng/open-release-pilot

GitHub：

https://github.com/langyuxiansheng

如果你也在维护 Flutter App，尤其是经常搜索或者处理这些问题，可以试试看：

• Flutter 多渠道打包
• Flutter Android 渠道包
• Flutter APK 批量打包
• Flutter iOS IPA 打包
• Flutter 上传 App Store Connect
• Flutter TestFlight 发布
• Flutter 蒲公英发布
• Android 应用市场上传
• 移动端本地发布工具
• App 发布管理工具

目前项目还会继续完善，后面应该会继续补更多平台上传适配、构建记录展示、配置导入导出这些。

当前版本里，打包流程和蒲公英发布流程已经 OK，其它平台上传功能还在调试测试中。有些配置项可能还不是很全，后面会持续补。

有问题请留言或者 @博主，谢谢支持 o(￣︶￣)o~

感谢您的阅读，如果此文章或项目对您有帮助，可以点个关注，若可以的话再给个一键三连吧！

公众号阅读的朋友可以点一下右下角的 在看 和 分享 哦。

GitHub 有开源项目，需要的小伙伴可以顺手 star 一下！

GitHub：https://github.com/langyuxiansheng

ps：

这个项目里的示例配置都用了占位值，真正使用时一定要在自己本机配置真实项目路径和密钥，不要把 data/、证书、签名文件、应用市场密钥这些提交到仓库。