开发者常见问题
开发者在蒲公英发布应用时常见的疑问,涵盖 SDK 使用、下载额度、访问控制、iOS / Android 安装失败排查等。
汇总开发者在使用蒲公英过程中经常遇到的问题与对应解决思路。
如果只是发布 App 给用户安装,需要集成蒲公英 SDK 吗?
不需要。蒲公英 SDK 已于 2023 年停止维护,详见 SDK 归档说明。如果希望为 App 添加版本更新功能,推荐直接使用官方代码片段仓库 PGYER/AppUpdateChecker,其中包含 Android、iOS 与 uni-app 三端示例,可直接复制使用。
在蒲公英上传的应用,可以下载安装多少次?可以保存多久?
应用上传后默认处于 内测模式,下载次数受限。具体额度请登录蒲公英平台,在 应用管理 页面中查看相关提示。如希望获得更多下载次数,可在 应用管理 页面申请切换至 分发模式。
关于应用的保存时长,与所选套餐有关,详见 价格方案。
如何实现应用只有指定的人员才能访问?
可选择以下任一方式:
- 如果可访问人员不确定,或希望对其他人隐藏应用信息,可在应用的 App 设置 中将安装方式设置为 密码安装,用户安装时需要输入密码。
- 如果可访问人员仅限项目成员中的开发者,可将安装方式设置为 邀请安装,测试用户无法安装。
- 蒲公英也提供授权码安装、问题答案安装等方式,可按需选择。
怎么生成应用测试短链接并查看?
上传应用后,系统会自动生成一个 6 字符的随机短地址,格式为 https://www.pgyer.com/XXXXXX,其中 XXXXXX 为大小写字母与数字的随机组合。您也可以在应用的 设置 页面手动指定短地址。
同一个应用,不同版本是同一个地址吗?
同一个应用的短地址永远指向最新版本;其他历史版本则拥有各自固定且独立的完整链接。
为什么下载应用时提示下载失败?
请依次检查以下几项:
- 当前网络是否可用;
- 手机内存是否足够;
- 下载
.apk时所用的应用(如 QQ 浏览器等)是否已获取读写权限。
为什么下载 Android 应用时提示安装失败?
请依次检查以下几项:
- 同一手机上是否安装了包名相同但签名不同的应用。如有,请先卸载原 App 再重新安装。
- 若手机提示"无法安装未知来源的应用程序",请进入系统设置,开启"未知来源"的应用安装权限。
为什么 iOS 应用安装到一半时提示"无法下载应用程序"?
最常见的原因有以下三种:
- 签名该 iOS App 的证书失效:证书或配置文件失效都会导致无法下载。证书失效时需更换有效证书重新打包上传;证书有效时需重新导出配置文件再打包上传。
- Ad Hoc 版本的 App 未添加 UDID:以 Ad Hoc 方式打包的应用,必须在打包时将目标设备的 UDID 加入
.mobileprovision文件,才可以在该设备上正常安装。 - 打包方式错误:若导出
.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 进行申诉,也可以通过蒲公英网页右下角的在线聊天窗口咨询。