Flutter 打包发布工具推荐：Android 多渠道打包、iOS IPA 构建、蒲公英发布和应用市场配置管理

一、写在前面好久不见~最近把自己本地用的一个Flutter 打包发布工具整理了一下做成了一个开源项目。项目名称叫Open Release Pilot主要用来处理 Flutter App 发布时的一些重复工作比如Flutter Android 多渠道打包Android 渠道包输出和命名iOS IPA 构建App Store Connect / TestFlight 上传流程蒲公英发布华为、小米、应用宝等应用市场上传配置Flutter App 发布记录保存局域网扫码安装 APK项目地址https://github.com/langyuxiansheng/open-release-pilotGitHub 主页https://github.com/langyuxiansheng如果你正在搜索这些问题Flutter 怎么做 Android 多渠道打包Flutter 怎么批量生成不同渠道的 APKFlutter iOS 怎么打 IPAFlutter IPA 怎么上传 App Store ConnectFlutter 打包后怎么上传蒲公英有没有本地的 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 服务没有数据库依赖也没有复杂部署。gitclone https://github.com/langyuxiansheng/open-release-pilot.gitcdopen-release-pilotnpmstart启动之后终端会输出地址Open Release Pilot: http://127.0.0.1:8787 Open Release Pilot LAN: http://192.168.1.10:8787浏览器打开本地地址就可以。第一次打开之后先去「项目管理」页面把示例项目路径换成自己的 Flutter 项目路径。如果端口被占用可以换端口./start.sh--port8788看端口状态./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-defineTAG_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打包并用于 TestFlightiOS 脚本执行的是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这里面会记录版本、包扫描结果、构建记录、上传记录等。同样这个文件默认不提交。五、常用配置项项目配置里我觉得比较关键的是这些字段说明rootPathFlutter 项目根目录versionFile版本文件Flutter 默认是android/local.propertiesversionNamePattern读取版本号的正则versionCodePattern读取构建号的正则androidOutputRootAndroid 渠道包输出目录iosOutputRootiOS IPA 输出目录androidApkSourceFlutter 构建后的源 APK 路径apkNameTemplateAPK 命名模板ipaNameTemplateIPA 命名模板channelsAndroid 渠道列表命名模板支持这些变量{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/*.jsonconfig/stores.local.json.envAndroid 签名文件iOS 证书.p8.p12.mobileprovision应用市场密钥Apple Team ID测试账号和密码另外面板里有本地文件选择能力所以建议只在可信网络里使用不要直接暴露到公网。如果只是本机访问可以这样启动HOST127.0.0.1npmstart如果要让手机扫码安装就保持默认的0.0.0.0让同局域网设备可以访问。八、和 CI/CD 的关系这个工具不是为了替代 CI/CD。我更希望它解决的是“本机发布流程太散”的问题。比如项目还没上完整 CI/CD。发布流程里有很多人工确认步骤。多渠道参数暂时不想放到远程平台。需要一个工具把路径、配置、记录和状态串起来。等流程稳定以后再把这些脚本接到 CI/CD 也可以。九、写在后面项目地址https://github.com/langyuxiansheng/open-release-pilotGitHubhttps://github.com/langyuxiansheng如果你也在维护 Flutter App尤其是经常搜索或者处理这些问题可以试试看Flutter 多渠道打包Flutter Android 渠道包Flutter APK 批量打包Flutter iOS IPA 打包Flutter 上传 App Store ConnectFlutter TestFlight 发布Flutter 蒲公英发布Android 应用市场上传移动端本地发布工具App 发布管理工具目前项目还会继续完善后面应该会继续补更多平台上传适配、构建记录展示、配置导入导出这些。当前版本里打包流程和蒲公英发布流程已经 OK其它平台上传功能还在调试测试中。有些配置项可能还不是很全后面会持续补。有问题请留言或者 博主谢谢支持 o(︶)o~感谢您的阅读如果此文章或项目对您有帮助可以点个关注若可以的话再给个一键三连吧公众号阅读的朋友可以点一下右下角的在看和分享哦。GitHub 有开源项目需要的小伙伴可以顺手 star 一下GitHubhttps://github.com/langyuxianshengps这个项目里的示例配置都用了占位值真正使用时一定要在自己本机配置真实项目路径和密钥不要把data/、证书、签名文件、应用市场密钥这些提交到仓库。