跳到主要内容
版本：v4

常见问题

弹窗提示『请求失败，请重试』​

可以参考集成前准备检查是否已经提交 APK 并通过审核，以及发布设置是否为立即上线状态。

从 v3.23.0 以前的版本更新到新版本的升级流程​

将原先 updateGame 相关的接口代码删除，并重新按 sdk-获取的流程接入

Unity 唤醒更新会增加哪些 Android 依赖库​

首先 Unity 唤醒更新只会在 Android 平台生效，其次唤醒更新新加的依赖库会在打包过程中自动添加到 Unity Gradle Template 中，您可以到 唤醒更新模块/Mobile/Editor/TapTapUpdateDependencies.xml 中查看到，具体来说会增加 3 个依赖库：

  1. com.squareup.okhttp3:okhttp:3.12.1
  2. androidx.core:core:1.6.0
  3. com.google.android.flexbox:flexbox:3.0.0

更新唤起功能支持 iOS 版本吗？​

受限于苹果政策，iOS 平台的 TapTap 客户端无法提供游戏更新功能，更新唤起能力仅支持 Android 平台使用。

更新唤起功能是否只适用于强制更新的游戏版本？​

游戏在强更场景必须使用「更新唤起」服务，当游戏需要包体强更时，请求 SDK 更新接口，唤起 TapTap 更新即可，同时平台也不会干涉游戏自身的热更操作，如果游戏在非强更场景，也希望用户更新的话，可以尝试在公告等场景对用户进行提醒。

接入更新唤起游戏打包报 Android resource linking failed，AAPT:error:resource android:attr/xx/xx not found. 异常​

检查项目打包时 compileSdkVersion 版本号，该异常时 Gradle 版本和 compileSdkVersion 匹配问题导致，建议将 compileSdkVersion 升级到 28 或更高版本。

接入更新唤起游戏打包报 getUpdateInfo error: org.json.JSONExcetion: {"date": "{xxxx}"} 异常​

检查项目是否开启了混淆操作，TapSDK 已经做了混淆处理，再次混淆会导致不可预期的错误，请在项目的混淆脚本中添加如下配置，跳过对 TapSDK 的混淆操作：

-keep class com.tds.** { *;}
-keep class com.taptap.** { *;}
-keep class com.tapsdk.** { *;}
-keep class tds.androidx.** { *;}

引入 TapUpdate 模块后闪退报错：Unable to get provider com.taptap.sdk.update.internal.TapUpdateFileProvider，具体表现是弹出「更新游戏，需安装 TapTap 客户端」页面，点击「安装 TapTap」没有相应。​

检查游戏是否存在二次打包的情况，检查二次打包后 APK 中的 AndroidManifest.xml 文件中如下的 provider 标签里面的 android:authorities 字段值是否为 项目包名.com.taptap.sdk.update.internal.fileProvider，如果不是的话，请手动更正。

<provider
    android:name="com.taptap.sdk.update.internal.TapUpdateFileProvider"
    android:exported="false"
    android:authorities="项目包名.com.taptap.sdk.update.internal.fileProvider"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@ref/0x7f0c0000" />
</provider>