更新唤起开发指南

集成前准备

1. 参考 开发者中心配置 创建应用、配置包名与签名证书
2. 参考集成指南（Unity、Android、iOS）完成对应平台或引擎的基础接入

权限说明

该模块依赖权限如下：

Android

权限	使用目的	权限申请时机
网络权限	用于正常网络访问	用户首次使用该功能时会申请权限
安装 APK 权限	用于安装 Tap 客户端	用户首次使用该功能时会申请权限

接入 SDK 后，SDK 会在 AndroidManifest.xml 中自动添加如下配置，用于检测设备是否已安装 Tap 客户端：

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
<queries>
    <package android:name="com.taptap" />
    <package android:name="com.taptap.global" />
</queries>

SDK 获取

Unity

远程依赖

NPMJS 方式：在 Packages/manifest.json 中添加：

"dependencies":{
  "com.taptap.sdk.core":"4.9.3",
  "com.taptap.sdk.update":"4.9.3"
}

GitHub 方式：在 Packages/manifest.json 中添加：

"dependencies":{
  "com.taptap.sdk.core":"https://github.com/taptap/tapsdk-unity-dist.git?path=/Core#4.9.3",
  "com.taptap.sdk.update":"https://github.com/taptap/tapsdk-unity-dist.git?path=/Update#4.9.3"
}

本地文件导入

在 下载页 下载并导入以下 unitypackage 文件：

• TapSDK_Core.unitypackage (TapTapSDK 核心模块，必选)
• TapSDK_Update.unitypackage（TapTapSDK 更新唤起模块，必选）

Android

在 app module 的 build.gradle 中添加对应依赖：

dependencies {
  implementation 'com.taptap.sdk:tap-core:4.9.3'
  implementation 'com.taptap.sdk:tap-update:4.9.3'
}

更新游戏

tip

【开发者中心配置更新】与【游戏自行判断更新】两种方式二选一即可。

Android 开发者注意

由于更新唤起 UI 依赖于开发者设置的 Activity 实例，所以为了避免因 Activity 发生重建导致更新唤起功能不可用，开发者应确保在屏幕旋转、配置修改时当前 Activity 不会发生重建，具体设置方式参考 限制 activity 重新创建。

开发者中心配置更新

适用于：无自有版本管理系统的游戏，特别是单机游戏。

Unity

using TapSDK.Update

TapTapUpdate.CheckForceUpdate();

Android Java

import com.taptap.sdk.update.TapTapUpdate;

TapTapUpdate.checkForceUpdate();

Android Kotlin

import com.taptap.sdk.update.TapTapUpdate

TapTapUpdate.checkForceUpdate()

游戏自行判断更新

适用于：自有版本管理系统，期望更灵活触发、展示更新的网游。

Unity

using TapSDK.Update

// 自行维护版本校验逻辑，新版本发布时调用
TapTapUpdate.UpdateGame(() => {
    // 唤醒更新收到[取消]回调
});

Android Java

import com.taptap.sdk.update.TapTapUpdate;
import com.taptap.sdk.update.TapTapUpdateCallback;

// 自行维护版本校验逻辑，新版本发布时调用
TapTapUpdate.updateGame(activity, new TapTapUpdateCallback() {
    @Override
    public void onCancel() {
        // 更新取消
    }
});

Android Kotlin

import com.taptap.sdk.update.TapTapUpdate
import com.taptap.sdk.update.TapTapUpdateCallback

// 自行维护版本校验逻辑，新版本发布时调用
TapTapUpdate.updateGame(
    activity = this,
    callback = object : TapTapUpdateCallback {

        override fun onCancel() {

            Toast.makeText(this@DemoUpdateActivity, "取消更新", Toast.LENGTH_SHORT)
                .show()
        }
    }
)

info

未安装 TapTap 客户端时，SDK 会询问用户是否使用 TapTap 更新，点击「取消」才会触发取消回调。

测试方式

为确保上线后更新唤起功能正常使用，请按照以下说明完成自测。

开发者中心配置更新

1. 在 TapTap 开发者中心 商店 > 版本管理 上线包含 APK 的商店资料版本（需审核通过）。若 APK 暂不对外，可将发布状态设为「敬请期待」或「预约」，在 商店 > 游戏测试 开启封闭式测试、添加测试人员。
2. 构建包名与开发者中心当前 APK 一致、版本号（Version Code）低于当前版本的测试包。
3. 用该测试包触发更新，确认是否唤起 TapTap 商店详情页。

warning

为确保「强制更新」功能正常生效，请在上传新版本时将「APK 更新模式」设置为「强制更新」；若选择「普通更新」，将不会唤起 TapTap 商店页。

游戏自行判断更新

1. 确保已在游戏资料中配置 APK 包名。
2. 构建相同包名的测试包。
3. 游戏自行触发更新，确认是否唤起 TapTap 商店详情页。

tip

如果游戏需要接入海外版本或不通过集成 SDK 实现，请参考 文档