蒲公英 App 内测分发平台 是面向 App 安装包的内测托管、下载分发平台,支持上传:
- iOS 安装包:
.ipa - Android 安装包:
.apk - HarmonyOS 安装包:
.hap
本项目演示如何通过蒲公英新版上传 API 上传 iOS、Android、HarmonyOS 安装包,并获取上传后的构建结果和下载地址。
新版上传 API 采用“获取上传凭证 -> 上传安装包 -> 查询构建结果”的流程,相比旧版 v1、v2 上传接口速度更快。旧版接口仍可使用,但新项目建议优先接入新版上传 API。
如果只是希望在命令行或 CI 中快速上传,可以直接使用 Shell 示例:
cd shell-demo
chmod +x ./pgyer_upload.sh
./pgyer_upload.sh -k <your-pgyer-api-key> <your-ipa-or-apk-or-hap-file-path>上传成功后会输出应用名称、版本号和下载页面 URL。如需完整 JSON 响应,可增加 -j 参数:
./pgyer_upload.sh -k <your-pgyer-api-key> -j <your-app-file-path>各语言目录中包含可运行 Demo、参数说明和返回结果示例:
| 语言 | 目录 | 说明 |
|---|---|---|
| Shell | shell-demo | 适合命令行、CI/CD 和一行命令上传 |
| Java | java-demo | Maven 项目示例 |
| Node.js | nodejs-demo | 支持 Promise 和 Callback 调用方式 |
| PHP | php-demo | PHP 7.4+ 示例 |
| Python | python-demo | Python 3 脚本示例 |
| C# | csharp-demo | .NET 示例 |
新版上传 API 的核心流程如下:
- 调用蒲公英接口获取上传凭证。
- 使用上传凭证将
.ipa、.apk或.hap文件上传到存储服务。 - 轮询查询构建结果,获取应用名称、版本号、短链接、二维码等信息。
各语言示例都已经封装了上述流程,通常只需要传入 API Key、安装包路径和可选发布参数。
更完整的参数列表请查看各语言目录中的 README,或参考 蒲公英 API 上传文档。
欢迎提交新的语言示例、问题修复或文档优化。新增语言示例时,建议同时提供:
- 可直接运行的 Demo
- 依赖安装说明
- API 参数说明
- 成功返回示例
- 常见错误处理说明
