应用上传
介绍将 iOS 与 Android 应用上传至蒲公英的四种方式,以及各自的适用场景。
蒲公英提供网站、桌面客户端、开放 API、小程序四种上传方式,您可以根据使用场景选择合适的方式发布应用。
支持的安装包格式
- iOS:
.ipa - Android:
.apk - HarmonyOS:
.hap(详见 鸿蒙 HarmonyOS 应用内测分发)
上传方式对比
| 方式 | 适用场景 | 入口 |
|---|---|---|
| 网站上传 | 临时上传、手动发布,兼容 PC 与手机浏览器 | 蒲公英官网 发布 按钮 |
| 桌面客户端 | 需要频繁发布的 Mac 用户 | 桌面客户端下载页面 |
| 开放 API | 接入 CI/CD 或自动化发布流程 | 上传 API 文档 |
| 小程序 | 手机端快速上传与分发 | 小程序入口页面 |
通过网站上传
发布新版前,请了解 版本保留与自动清理规则。每个 App 有独立的版本额度;正常上传造成的新超额会异步清理较早的版本,没有额外业务宽限期,也不逐次发送清理提醒。例如额度为 30 个且已有 30 个版本时,继续发布可能触发旧版本轮换。需要长期归档的安装包,请在发布前自行备份。网站、客户端及 API 发布适用相同规则。
在蒲公英官网导航栏点击 发布,进入发布应用页。若您已有应用的安装包(.ipa 或 .apk),可通过以下任一方式开始上传:
- 点击 立刻上传 按钮选择文件;
- 将文件拖拽至虚线区域。
随后按页面提示填写应用信息即可完成发布。
设置应用信息
上传完成后进入 设置应用信息 页面,系统会自动从安装包中解析以下字段,您可根据需要修改:
- 应用名称
- 包名(Bundle ID / Package Name)
- App 签名类型
- 应用图标
- 应用介绍(若安装包中包含)
- 应用截图(若安装包中包含)
确认信息无误后点击 添加应用,完成发布。
通过桌面客户端上传
蒲公英提供 Mac 版桌面客户端,适合需要频繁上传的 Mac 用户。前往 桌面客户端下载页面 获取安装程序。
通过开放 API 上传
如需将蒲公英接入构建脚本、CI/CD 或 AI 助手,请先查看 自动上传 App 与 CI/CD 集成指南,按场景选择 API、CLI、插件、MCP 或 Agent Skill。
蒲公英开放了上传 API,可将上传流程集成到构建脚本或 CI/CD 流水线中,实现自动化发布。接口说明请参考 上传 API 文档。
若只想用一行命令完成上传,可直接使用现成的脚本示例:PGYER/upload-app-api-example 提供 Shell 脚本封装,填入 API Key 与安装包路径即可运行,也可作为接入 Jenkins、GitHub Actions 等 CI 系统的起点。
通过小程序上传
使用蒲公英小程序可在手机端直接完成上传与分发。扫码或访问 小程序入口页面 即可。
创建空白应用
如果暂时没有安装包,可以先创建一个空白应用作为占位。Dashboard V2 当前不显示空白应用入口,请打开右上角账户菜单中的 旧版后台,进入 我的应用 后点击 添加空白应用;也可以直接打开 空白应用创建页。
空白应用无法正常安装使用,仅作为占位存在。请在后续补传安装包文件以启用该应用。