蒲公英文档中心

开发者常见问题

开发者在蒲公英发布应用时常见的疑问,涵盖 SDK 使用、下载额度、访问控制、iOS / Android 安装失败排查等。

汇总开发者在使用蒲公英过程中经常遇到的问题与对应解决思路。

如果只是发布 App 给用户安装,需要集成蒲公英 SDK 吗?

不需要。蒲公英 SDK 已于 2023 年停止维护,详见 SDK 归档说明。如果希望为 App 添加版本更新功能,推荐直接使用官方代码片段仓库 PGYER/AppUpdateChecker,其中包含 Android、iOS 与 uni-app 三端示例,可直接复制使用。

在蒲公英上传的应用,可以下载安装多少次?可以保存多久?

应用上传后默认处于 内测模式,下载次数受限。具体额度请登录蒲公英平台,在 应用管理 页面中查看相关提示。如希望获得更多下载次数,可在 应用管理 页面申请切换至 分发模式

关于应用的保存时长,与所选套餐有关,详见 价格方案

如何实现应用只有指定的人员才能访问?

可选择以下任一方式:

  1. 如果可访问人员不确定,或希望对其他人隐藏应用信息,可在应用的 App 设置 中将安装方式设置为 密码安装,用户安装时需要输入密码。
  2. 如果可访问人员仅限项目成员中的开发者,可将安装方式设置为 邀请安装,测试用户无法安装。
  3. 蒲公英也提供授权码安装、问题答案安装等方式,可按需选择。

怎么生成应用测试短链接并查看?

上传应用后,系统会自动生成一个 6 字符的随机短地址,格式为 https://www.pgyer.com/XXXXXX,其中 XXXXXX 为大小写字母与数字的随机组合。您也可以在应用的 设置 页面手动指定短地址。

同一个应用,不同版本是同一个地址吗?

同一个应用的短地址永远指向最新版本;其他历史版本则拥有各自固定且独立的完整链接。

为什么下载应用时提示下载失败?

请依次检查以下几项:

  1. 当前网络是否可用;
  2. 手机内存是否足够;
  3. 下载 .apk 时所用的应用(如 QQ 浏览器等)是否已获取读写权限。

为什么下载 Android 应用时提示安装失败?

请依次检查以下几项:

  1. 同一手机上是否安装了包名相同但签名不同的应用。如有,请先卸载原 App 再重新安装。
  2. 若手机提示"无法安装未知来源的应用程序",请进入系统设置,开启"未知来源"的应用安装权限。

为什么 iOS 应用安装到一半时提示"无法下载应用程序"?

最常见的原因有以下三种:

  1. 签名该 iOS App 的证书失效:证书或配置文件失效都会导致无法下载。证书失效时需更换有效证书重新打包上传;证书有效时需重新导出配置文件再打包上传。
  2. Ad Hoc 版本的 App 未添加 UDID:以 Ad Hoc 方式打包的应用,必须在打包时将目标设备的 UDID 加入 .mobileprovision 文件,才可以在该设备上正常安装。
  3. 打包方式错误:若导出 .ipa 时选择了 App Store 方式,该安装包仅可用于上传至 Apple App Store,无法通过蒲公英安装。这种方式导出的 .ipa 上传后,蒲公英会显示"App Store 版"。

更多原因请参见 iOS 应用安装失败原因排查

为什么 Ad Hoc 的 iOS 应用已添加 UDID,仍然无法安装?

请先在应用管理页面中查看 UDID 明细,确认该 UDID 是否已在列表中。如果不在列表中,可能是打包时使用的证书未更新,建议重新打包上传。

在蒲公英上发布的 iOS 应用,支持 APNs(推送)吗?

支持。蒲公英不会修改应用的原有功能。

上传 iOS 应用时,应该使用什么开发者账号、什么证书打包 ipa?

可以使用任意类型的苹果开发者账号与证书,通过 Xcode 打包。只要该证书可以通过 Xcode 正常生成 .ipa 安装包,即可上传到蒲公英。

蒲公英支持 iOS 的 Swift 应用吗?

支持。Swift 编写的 iOS 应用可正常上传与分发。

为什么下载 App 时下载成了别的应用?

受国内手机环境影响,这种情况在 Android 上较为常见。当系统在下载时弹出 安全下载高速下载普通下载 等选项时,请选择 普通下载本地下载

如果选择本地下载后仍下载到其他应用,则可能是网络 DNS 劫持导致,建议更换网络尝试,例如断开 Wi-Fi 切换至手机蜂窝数据。

应用被下架、账号被封怎么办?

此类情况一般会有邮件通知。您可以根据邮件提示,发送邮件至 review@pgyer.com 进行申诉,也可以通过蒲公英网页右下角的在线聊天窗口咨询。

本页目录