蒲公英 App 内测分发平台 是面向 App 安装包的内测托管、下载分发平台，支持上传：
- iOS 安装包：
.ipa - Android 安装包：
.apk - HarmonyOS 安装包：
.hap
本项目演示如何通过蒲公英新版上传 API 上传 iOS、Android、HarmonyOS 安装包，并获取上传后的构建结果和下载地址。
新版上传 API 采用“获取上传凭证 -> 上传安装包 -> 查询构建结果”的流程，相比旧版 v1、v2 上传接口速度更快。旧版接口仍可使用，但新项目建议优先接入新版上传 API。
如果只是希望通过命令行快速上传和管理应用，推荐使用官方 pgyer-cli：
npm install -g @pgyer/cli
pgyer auth login
pgyer upload <your-ipa-or-apk-or-hap-file-path>pgyer-cli 需要 Node.js 18 或更高版本，并且还支持应用列表、详情和删除等管理功能。
各语言目录中包含可运行 Demo、参数说明和返回结果示例：
| 语言 | 目录 | 说明 |
|---|---|---|
| Shell | shell-demo | 适合学习上传流程或集成到现有 Shell/CI 脚本 |
| 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、安装包路径和可选发布参数。
| 参数 | 必填 | 说明 |
|---|---|---|
| API Key | 是 | 可在蒲公英账号后台获取 |
| 文件路径 | 是 | .ipa、.apk 或 .hap 安装包路径 |
| 安装方式 | 否 | 1 公开安装，2 密码安装，3 邀请安装 |
| 安装密码 | 否 | 安装方式为密码安装时使用 |
| 更新说明 | 否 | 本次上传版本的更新描述 |
| 渠道短链接 | 否 | 指定要更新的渠道短链接 |
更完整的参数列表请查看各语言目录中的 README，或参考 蒲公英 API 上传文档。
- 蒲公英官方命令行工具 pgyer-cli
- Shell 一行命令上传脚本
- Postman API 调用模板
- GitHub Actions 工作流
- Fastlane 插件
- MCP 服务器
- Agent Skill
欢迎提交新的语言示例、问题修复或文档优化。新增语言示例时，建议同时提供：
- 可直接运行的 Demo
- 依赖安装说明
- API 参数说明
- 成功返回示例
- 常见错误处理说明