Android SDK 3.0.0 常见问题
蒲公英 Android SDK 3.0.0 版本在集成与使用过程中常见的问题及排查建议。
蒲公英 SDK 已停止维护，新集成请直接使用 蒲公英 API。本文保留用于已集成项目参考。
本文汇总 Android SDK 3.0.0 在集成与使用中常见的问题与排查思路。
集成
jar 包集成后 SDK 功能无法正常使用
AndroidManifest.xml 中缺少以下 provider 配置，导致 SDK 未能正确初始化：
<provider
android:name="com.pgyersdk.PgyerProvider"
android:authorities="${applicationId}.com.pgyer.provider"
android:exported="false"/>集成后提示合并 AndroidManifest.xml 失败
可能原因：
- 项目 Android API 级别低于 16，SDK 要求最低 API 16；
AndroidManifest.xml存在格式错误，请打开文件查看具体报错。
版本更新
自定义更新提示直接复制 Demo 代码不显示 UI
自定义更新提示仅保留最小逻辑与关键数据打印，不内置 UI。界面与下载流程需要您自行实现。
下载完 apk 后没有弹出安装提示
常见原因：
- 手机 允许未知来源安装 开关处于关闭状态；
- Android 8.0 起安装 apk 需要额外权限：
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />SDK 3.0.1 及以上版本的 aar 集成方式已包含上述权限，无需重复添加。
自动更新提示弹出后立即消失
3.0.0 版本会自动解绑更新提示，页面关闭时若使用了延迟关闭或其他框架会触发此现象。升级到最新版本可解决。
日志与错误
如何检查 SDK 是否正常运行？
运行 App 后，在 Android Studio Logcat 中过滤 PgyerSDK，正常会看到：
D/PgyerSDK: PgyerProvider onCreate // SDK 初始化
D/PgyerSDK: There is a new version // 有新版本配置异常时会看到：
E/PgyerSDK: App ID is not correct // App ID 配置错误
W/PgyerSDK: There is no android.permission.WRITE_EXTERNAL_STORAGE // 缺少存储权限
W/PgyerSDK: Please grant permission if you use Pgyer SDK feature. // 功能不可用3.0.0 版本提示 InterruptException
SDK 在短时间内阻止重复请求以避免流量浪费，阻断时会打印该错误，不影响 App 实际运行。3.0.1 及以上版本已修复，不再打印。
3.0.0 之前版本在 Api.class 中打印 NullException
不影响 App 运行。3.0.1 已修复，不再打印。