From 0479219ce663d02d9cdc8267e92f85187cbad800 Mon Sep 17 00:00:00 2001
From: WatchMan-Wang <514504765@qq.com>
Date: Fri, 27 Sep 2024 17:29:55 +0800
Subject: [PATCH] feat: add share&review docs
---
cn/docs/sdk/review/_category_.json | 5 +
cn/docs/sdk/review/features.mdx | 36 ++++
cn/docs/sdk/review/guide.mdx | 294 ++++++++++++++++++++++++++
cn/docs/sdk/share/_category_.json | 5 +
cn/docs/sdk/share/faq.mdx | 34 +++
cn/docs/sdk/share/features.mdx | 46 ++++
cn/docs/sdk/share/guide.mdx | 324 +++++++++++++++++++++++++++++
7 files changed, 744 insertions(+)
create mode 100644 cn/docs/sdk/review/_category_.json
create mode 100644 cn/docs/sdk/review/features.mdx
create mode 100644 cn/docs/sdk/review/guide.mdx
create mode 100644 cn/docs/sdk/share/_category_.json
create mode 100644 cn/docs/sdk/share/faq.mdx
create mode 100644 cn/docs/sdk/share/features.mdx
create mode 100644 cn/docs/sdk/share/guide.mdx
diff --git a/cn/docs/sdk/review/_category_.json b/cn/docs/sdk/review/_category_.json
new file mode 100644
index 000000000..2793e5d57
--- /dev/null
+++ b/cn/docs/sdk/review/_category_.json
@@ -0,0 +1,5 @@
+{
+ "label": "TapTap 评价",
+ "collapsed": true,
+ "position": 3
+}
diff --git a/cn/docs/sdk/review/features.mdx b/cn/docs/sdk/review/features.mdx
new file mode 100644
index 000000000..ba456ce3f
--- /dev/null
+++ b/cn/docs/sdk/review/features.mdx
@@ -0,0 +1,36 @@
+---
+title: 评价功能介绍
+sidebar_label: 功能介绍
+sidebar_position: 1
+---
+
+评价功能支持游戏调起 TapTap 的评价编辑器，帮助用户快捷发布对本游戏的评价。
+
+
+
+## 服务优势
+- 快速积累真实评价
+ - 获得真实玩家评分评价，提高站内热度，收集玩家反馈，吸引潜在用户。
+- 流程短，效率高
+ - 一键直接调起游戏评价编辑，免去玩家多步操作。
+
+## 用户使用流程
+1. 玩家在游戏中点击「去 TapTap 评价」按钮（该按钮及相关UI由开发者自行绘制）。
+2. 有 TapTap 客户端则调起客户端评价编辑页；无客户端则打开游戏的 TapTap 网页版的查看评价页。
+
+
+## 注意事项
+使用评价功能时，请勿诱导好评，否则游戏将受到相应处罚。
+
+- 调用评价功能时诱导好评倾向包括：
+ - 邀请评价界面使用「好评」「五星」等诱导字样。
+ - 承诺好评奖励。
+ - 在调起评价前，先询问玩家对游戏满意度，仅为满意度高的用户调起评价。
+- 诱导好评行为根据严重程度、影响范围、违规次数，可能面临以下处罚：
+ - 清除所有诱导好评，回溯游戏评分。
+ - 游戏详情页展示诱导好评标识。
+ - 限制流量、暂停分发。
+
+- 建议的引导评价方式：
+ - 平实的引导玩家「去 TapTap 评价」。
+ - 有诚意的表述期望玩家客观评价，游戏将根据反馈不断改进游戏。
diff --git a/cn/docs/sdk/review/guide.mdx b/cn/docs/sdk/review/guide.mdx
new file mode 100644
index 000000000..220360090
--- /dev/null
+++ b/cn/docs/sdk/review/guide.mdx
@@ -0,0 +1,294 @@
+---
+title: 评价开发指南
+sidebar_label: 开发指南
+sidebar_position: 2
+---
+
+import MultiLang from "/src/docComponents/MultiLang";
+import CodeBlock from "@theme/CodeBlock";
+import v4SDKVersions from '/src/docComponents/v4SDKVersions';
+import { Conditional } from "/src/docComponents/conditional";
+import AndroidFaq from "../_partials/android-package-visibility.mdx";
+import UnitySDKInstallation from "../_partials/unity-sdk-installation.mdx";
+
+## 权限说明
+
+
+
+<>
+该模块依赖权限如下：
+
+| 权限 | 使用目的 | 权限申请时机 |
+| ---------------------- | ---------------------- | ---------------------- |
+| 安装 APK 权限 | 用于安装 Tap 客户端 | 用户首次使用该功能时会申请权限 |
+
+
+<>
+
+该模块依赖权限如下：
+
+| 权限 | 使用目的 | 权限申请时机 |
+| ---------------------- | ---------------------- | ---------------------- |
+| 安装 APK 权限 | 用于安装 Tap 客户端 | 用户首次使用该功能时会申请权限 |
+
+同时该模块也会访问设备已安装的 Tap 客户端信息，所以接入 SDK 后将在应用 `AndroidManifest.xml` 中添加如下配置：
+
+```xml
+
+
+
+
+```
+
+
+
+<>
+
+该模块依赖权限如下：
+
+| 权限 | 使用目的 | 权限申请时机 |
+| ---------------------- | ---------------------- | ---------------------- |
+| 安装 APK 权限 | 用于安装 Tap 客户端 | 用户首次使用该功能时会申请权限 |
+
+同时该模块也会访问设备已安装的 Tap 客户端信息，所以接入 SDK 后将在应用 `AndroidManifest.xml` 中添加如下配置：
+
+```xml
+
+
+
+
+```
+
+
+
+
+
+## 集成前准备
+
+使用Tap评价功能前提需要通过 **TapTap 开发者中心 > 商店 > 游戏资料 > 商店资料** 中已经上传 APK， 发布设置为 **立即上线** 并通过 **审核**（开发者包如果暂时不想对外，发布状态选 **敬请期待** 或者 **预约**）。
+
+
+## SDK 获取
+
+
+
+<>
+
+
+
+
+
+<>
+
+1. 项目根目录的 build.gradle 添加仓库地址:
+
+{
+ `allprojects {
+ repositories {
+ google()
+ mavenCentral()
+ }
+}`
+}
+
+2. app module 的 build.gradle 添加对应依赖：
+
+{
+`dependencies {
+ implementation 'com.taptap.sdk:tap-core:${v4SDKVersions.taptap.android}'
+ implementation 'com.taptap.sdk:tap-review:${v4SDKVersions.taptap.android}'
+}`
+}
+
+
+
+<>
+
+1. 项目根目录的 build.gradle 添加仓库地址:
+
+{
+`allprojects {
+ repositories {
+ google()
+ mavenCentral()
+ }
+}`
+}
+
+2. app module 的 build.gradle 添加对应依赖：
+
+{
+`dependencies {
+ implementation 'com.taptap.sdk:tap-core:${v4SDKVersions.taptap.android}'
+ implementation 'com.taptap.sdk:tap-review:${v4SDKVersions.taptap.android}'
+}`
+}
+
+
+
+<>
+
+
+
+
+
+## 初始化
+
+### TapSDK 初始化
+
+
+
+<>
+
+`TapTapSdkOptions` 详细参数见 [入门指南#快速开始](/sdk/access/quickstart/#初始化)
+
+```cs
+using TapSDK.Core;
+using TapSDK.Compliance;
+
+// 核心配置 详细参数见 [入门指南#快速开始]
+TapTapSdkOptions coreOptions = new TapTapSdkOptions();
+// TapSDK 初始化
+TapTapSDK.Init(coreOptions);
+```
+
+
+
+<>
+
+`TapTapSdkOptions` 详细参数见 [入门指南#快速开始](/sdk/access/quickstart/#初始化)
+
+```java
+import com.taptap.sdk.core.TapTapLanguage;
+import com.taptap.sdk.core.TapTapRegion;
+import com.taptap.sdk.core.TapTapSdk;
+import com.taptap.sdk.core.TapTapSdkOptions;
+
+/* 必选配置 */
+// 开发者中心对应 Client ID
+String clientId = "";
+// 开发者中心对应 Client Token
+String clientToken = "";
+// 是否开启 log，建议 Debug 开启，Release 关闭，默认关闭 log
+boolean enableLog = BuildConfig.DEBUG;
+
+TapTapSdkOptions tapSdkOptions = new TapTapSdkOptions(
+ clientId, // 游戏 Client ID
+ clientToken, // 游戏 Client Token
+ TapTapRegion.CN, // 游戏可玩区域: [TapTapRegion.CN]=国内 [TapTapRegion.GLOBAL]=海外
+ null, // 分包渠道名称 , 可为空
+ null, // 游戏版本号
+ false, // 是否自动上报 GooglePlay 内购支付成功事件 仅 [TapTapRegion.GLOBAL] 生效
+ false, // 自定义字段是否能覆盖内置字段
+ null, // 自定义属性，启动首个预置事件（device_login）会带上这些属性
+ null, // OAID 证书内容, 用于上报 OAID 仅 [TapTapRegion.CN] 生效
+ enableLog, // 是否开启 log，建议 Debug 开启，Release 关闭，默认关闭 log
+ TapTapLanguage.AUTO // TapSDK 首选语言 默认为 TapTapLanguage.AUTO
+);
+// 初始化 TapSDK
+TapTapSdk.init(context, tapSdkOptions);
+```
+
+
+
+<>
+
+`TapTapSdkOptions` 详细参数见 [入门指南#快速开始](/sdk/access/quickstart/#初始化)
+
+```kotlin
+import com.taptap.sdk.core.TapTapSdk
+import com.taptap.sdk.core.TapTapSdkOptions
+import com.taptap.sdk.core.TapTapRegion
+import com.taptap.sdk.core.TapTapLanguage
+
+TapTapSdk.init(
+ context = context,
+ sdkOptions = TapTapSdkOptions(
+ clientId = clientId,
+ clientToken = clientToken,
+ region = TapTapRegion.CN,
+ preferredLanguage = TapTapLanguage.ZH_HANS,
+ enableLog = false
+ ),
+)
+```
+
+
+受限于苹果政策，iOS 平台的 TapTap 客户端不提供跳转游戏评价功能
+
+```cpp
+FTapUpdate::Init(TEXT("clientId"), TEXT("clientToken"));
+```
+
+
+
+## 跳转游戏评价
+
+
+
+<>
+
+```cs
+// TODO unity
+```
+
+
+<>
+
+```java
+import com.taptap.sdk.review.TapTapReview;
+
+TapTapReview.openReview();
+```
+
+
+<>
+
+```kotlin
+import com.taptap.sdk.review.TapTapReview
+
+TapTapReview.openReview()
+```
+
+
+<>
+
+受限于苹果政策，iOS 平台的 TapTap 客户端不提供跳转游戏评价功能
+
+
+
+
+
+
+## 测试
+为了保证上线后，游戏对于用户是否正常使用 Tap 评价功能，请务必按照以下说明完成自测。
+
+### 上传 APK
+
+新应用需要上传测试的 APK 至开发者中心，并通过审核。已上架的游戏，需确保更新资料版本中的 APK 包名和已上架的 APK 包名保持一致。
+
+### 应用上线
+
+针对已上架的游戏，开发者需确保**更新资料版本中的包名和已上架的游戏包名保持一致**，否则会导致玩家因包名不一致而更新失败。
+
+针对新游戏，开发者需要在 TapTap 上线一个包含 APK 包并且通过审核**（用于平台获取游戏包名，包名需与后续更新的包名保持一致）**的商店资料版本，如果 APK 包当前无法对外，可将发布状态设置为「敬请期待」或「预约」。
+
+### 开始测试
+
+触发跳转游戏评价功能后正常状态是可以唤起 TapTap 应用对应游戏详情的评价页面。
+
+
+
+
diff --git a/cn/docs/sdk/share/_category_.json b/cn/docs/sdk/share/_category_.json
new file mode 100644
index 000000000..4ae5a2479
--- /dev/null
+++ b/cn/docs/sdk/share/_category_.json
@@ -0,0 +1,5 @@
+{
+ "label": "TapTap 分享",
+ "collapsed": true,
+ "position": 3
+}
diff --git a/cn/docs/sdk/share/faq.mdx b/cn/docs/sdk/share/faq.mdx
new file mode 100644
index 000000000..a47a36e68
--- /dev/null
+++ b/cn/docs/sdk/share/faq.mdx
@@ -0,0 +1,34 @@
+---
+title: 常见问题
+sidebar_label: 常见问题
+sidebar_position: 3
+---
+
+## 为什么分享内容中图片内容不显示？
+
+通常情况是 [Android FileProvider](https://developer.android.com/reference/androidx/core/content/FileProvider) 配置不对导致，需要检查 [Android FileProvider](https://developer.android.com/reference/androidx/core/content/FileProvider) 配置是否正确
+
+## 分享后直接闪退什么原因？
+
+检查是否是 contents 字段携带的文本数据里过大导致，Android 系统对于 intent 传递的数据内容大小是有限制的。通常是 1Mb。
+
+## 如何判断当前 TapTap 版本是否支持分享？
+
+SDK 有提供相应 API，示列如下：
+
+```
+if (TapTapShareUtil.checkTapTapInstall(this)
+ && TapTapShareUtil.checkTapTapSupportShare(this)) {
+ // 当前已安装 TapTap 且 支持分享功能
+}
+```
+
+## 已经安装最新版 TapTap，TapTapShareUtil.checkTapTapInstall(this) 还是返回 -1，提示没有安装。
+
+检查当前项目SDK版本Android 11（API 30）以后需要再 AndroidManifest.xml 添加安装包可见性权限:
+
+```
+
+
+
+```
diff --git a/cn/docs/sdk/share/features.mdx b/cn/docs/sdk/share/features.mdx
new file mode 100644
index 000000000..af53dedb7
--- /dev/null
+++ b/cn/docs/sdk/share/features.mdx
@@ -0,0 +1,46 @@
+---
+title: 分享功能介绍
+sidebar_label: 功能介绍
+sidebar_position: 1
+---
+
+分享功能支持游戏调起 TapTap 的内容编辑器快捷发布内容。
+支持预置绑定内容的标题、正文、话题、论坛标签信息，以更好的聚类、管理分享内容。
+
+
+
+## 服务优势
+- 获得「资源置换」流量扶持
+ - 即刻 [开启 REP 流量置换](https://rep.taptap.cn/) ，用户通过分享进入 TapTap ，将带给开发者对应拉新拉活的价值奖励，可用于换取游戏在 TapTap 的曝光流量。
+- 直接拉起内容编辑器，减少用户流失
+ - 用户截图后将可直接拉起 TapTap 内容编辑器，直接发布内容，减少内容分享步骤带来的流失。
+- 预置绑定游戏相关信息，内容征集流程流畅
+ - 支持预置论坛标签 ID、话题、标题、正文。
+
+## 推荐使用场景
+### 形式一：任务系统+论坛活动+游戏内整体接入
+| 任务系统 | 论坛活动 | 游戏内整体接入 |
+|---------------------------|--------------------------|----------------------|
+|单独给分享能力加一个任务，并提供额外奖励，给玩家创造分享动力，引导玩家前往分享|配合在 Tap 论坛做有奖分享活动，引导玩家产出优质内容 👉 https://www.taptap.cn/moment/400717429900052867 |游戏内所有页面接入 TapTap 的分享|
+||||
+
+### 形式二：形式二：指定页面接入+论坛活动
+| 指定页面接入+额外礼包 | 论坛活动 |
+|-------------------------------------|--------------------------|
+|单独给分享能力加一个任务，并提供额外奖励，给玩家创造分享动力，引导玩家前往分享|配合在 Tap 论坛做有奖分享活动，引导玩家产出优质内容 👉 https://www.taptap.cn/moment/400717429900052867 |
+|||
+
+## 预置绑定信息
+| 绑定信息 | 说明 | 编辑器展示 | 站内示例 |
+|---------------|-----------------------|-----------------|------------|
+|游戏|默认自动选中分享来源游戏，将发布在该游戏论坛|||
+|论坛标签|将发布在该游戏论坛标签下。通过 TapTap 论坛标签页的网址末尾网址数字，可获取该 ID。|||
+|话题|将带上该话题，该话题列表中将包含该内容。话题 ID 请通过工单选择分类「TDS 游戏服务 - 分享 - 查询话题 ID」，提供具体话题名称进行人工查询。|||
+|标题与正文|将预填充所设置的标题与正文。||即正常发布的内容标题与正文|
+
+## 注意事项
+当用户没有 TapTap 客户端而导致分享失败时，默认将打开网页版的游戏详情页。
+
+你可以自定义该场景跳转的链接，建议使用 REP 生成的游戏详情页效果链接，详情可前往 [REP 资源置换平台](https://rep.taptap.cn/) 查看。
+
+
diff --git a/cn/docs/sdk/share/guide.mdx b/cn/docs/sdk/share/guide.mdx
new file mode 100644
index 000000000..bea622903
--- /dev/null
+++ b/cn/docs/sdk/share/guide.mdx
@@ -0,0 +1,324 @@
+---
+title: TapTap 分享开发指南
+sidebar_label: 开发指南
+sidebar_position: 2
+---
+
+import MultiLang from "/src/docComponents/MultiLang";
+import CodeBlock from "@theme/CodeBlock";
+import v4SDKVersions from '/src/docComponents/v4SDKVersions';
+import { Conditional } from "/src/docComponents/conditional";
+import AndroidFaq from "../_partials/android-package-visibility.mdx";
+import UnitySDKInstallation from "../_partials/unity-sdk-installation.mdx";
+
+## 权限说明
+
+
+
+<>
+该模块依赖权限如下：
+
+| 权限 | 使用目的 | 权限申请时机 |
+| ---------------------- | ---------------------- | ---------------------- |
+| 安装 APK 权限 | 用于安装 Tap 客户端 | 用户首次使用该功能时会申请权限 |
+
+
+<>
+
+该模块依赖权限如下：
+
+| 权限 | 使用目的 | 权限申请时机 |
+| ---------------------- | ---------------------- | ---------------------- |
+| 安装 APK 权限 | 用于安装 Tap 客户端 | 用户首次使用该功能时会申请权限 |
+
+同时该模块也会访问设备已安装的 Tap 客户端信息，所以接入 SDK 后将在应用 `AndroidManifest.xml` 中添加如下配置：
+
+```xml
+
+
+
+
+```
+
+
+
+<>
+
+该模块依赖权限如下：
+
+| 权限 | 使用目的 | 权限申请时机 |
+| ---------------------- | ---------------------- | ---------------------- |
+| 安装 APK 权限 | 用于安装 Tap 客户端 | 用户首次使用该功能时会申请权限 |
+
+同时该模块也会访问设备已安装的 Tap 客户端信息，所以接入 SDK 后将在应用 `AndroidManifest.xml` 中添加如下配置：
+
+```xml
+
+
+
+
+```
+
+
+
+
+
+## 集成前准备
+
+使用Tap分享功能前提需要通过 **TapTap 开发者中心 > 商店 > 游戏资料 > 商店资料** 中已经上传 APK， 发布设置为 **立即上线** 并通过 **审核**（开发者包如果暂时不想对外，发布状态选 **敬请期待** 或者 **预约**）。
+
+
+## SDK 获取
+
+
+
+<>
+
+
+
+
+
+<>
+
+1. 项目根目录的 build.gradle 添加仓库地址:
+
+{
+ `allprojects {
+ repositories {
+ google()
+ mavenCentral()
+ }
+}`
+}
+
+2. app module 的 build.gradle 添加对应依赖：
+
+{
+`dependencies {
+ implementation 'com.taptap.sdk:tap-core:${v4SDKVersions.taptap.android}'
+ implementation 'com.taptap.sdk:tap-share:${v4SDKVersions.taptap.android}'
+}`
+}
+
+
+
+<>
+
+1. 项目根目录的 build.gradle 添加仓库地址:
+
+{
+`allprojects {
+ repositories {
+ google()
+ mavenCentral()
+ }
+}`
+}
+
+2. app module 的 build.gradle 添加对应依赖：
+
+{
+`dependencies {
+ implementation 'com.taptap.sdk:tap-core:${v4SDKVersions.taptap.android}'
+ implementation 'com.taptap.sdk:tap-share:${v4SDKVersions.taptap.android}'
+}`
+}
+
+
+
+<>
+
+
+
+
+
+## 初始化
+
+### TapSDK 初始化
+
+
+
+<>
+
+`TapTapSdkOptions` 详细参数见 [入门指南#快速开始](/sdk/access/quickstart/#初始化)
+
+```cs
+using TapSDK.Core;
+using TapSDK.Compliance;
+
+// 核心配置 详细参数见 [入门指南#快速开始]
+TapTapSdkOptions coreOptions = new TapTapSdkOptions();
+// TapSDK 初始化
+TapTapSDK.Init(coreOptions);
+```
+
+
+
+<>
+
+`TapTapSdkOptions` 详细参数见 [入门指南#快速开始](/sdk/access/quickstart/#初始化)
+
+```java
+import com.taptap.sdk.core.TapTapLanguage;
+import com.taptap.sdk.core.TapTapRegion;
+import com.taptap.sdk.core.TapTapSdk;
+import com.taptap.sdk.core.TapTapSdkOptions;
+
+/* 必选配置 */
+// 开发者中心对应 Client ID
+String clientId = "";
+// 开发者中心对应 Client Token
+String clientToken = "";
+// 是否开启 log，建议 Debug 开启，Release 关闭，默认关闭 log
+boolean enableLog = BuildConfig.DEBUG;
+
+TapTapSdkOptions tapSdkOptions = new TapTapSdkOptions(
+ clientId, // 游戏 Client ID
+ clientToken, // 游戏 Client Token
+ TapTapRegion.CN, // 游戏可玩区域: [TapTapRegion.CN]=国内 [TapTapRegion.GLOBAL]=海外
+ null, // 分包渠道名称 , 可为空
+ null, // 游戏版本号
+ false, // 是否自动上报 GooglePlay 内购支付成功事件 仅 [TapTapRegion.GLOBAL] 生效
+ false, // 自定义字段是否能覆盖内置字段
+ null, // 自定义属性，启动首个预置事件（device_login）会带上这些属性
+ null, // OAID 证书内容, 用于上报 OAID 仅 [TapTapRegion.CN] 生效
+ enableLog, // 是否开启 log，建议 Debug 开启，Release 关闭，默认关闭 log
+ TapTapLanguage.AUTO // TapSDK 首选语言 默认为 TapTapLanguage.AUTO
+);
+// 初始化 TapSDK
+TapTapSdk.init(context, tapSdkOptions);
+```
+
+
+
+<>
+
+`TapTapSdkOptions` 详细参数见 [入门指南#快速开始](/sdk/access/quickstart/#初始化)
+
+```kotlin
+import com.taptap.sdk.core.TapTapSdk
+import com.taptap.sdk.core.TapTapSdkOptions
+import com.taptap.sdk.core.TapTapRegion
+import com.taptap.sdk.core.TapTapLanguage
+
+TapTapSdk.init(
+ context = context,
+ sdkOptions = TapTapSdkOptions(
+ clientId = clientId,
+ clientToken = clientToken,
+ region = TapTapRegion.CN,
+ preferredLanguage = TapTapLanguage.ZH_HANS,
+ enableLog = false
+ ),
+)
+```
+
+
+// TODO iOS 初始化
+
+```cpp
+FTapUpdate::Init(TEXT("clientId"), TEXT("clientToken"));
+```
+
+
+
+## 调起分享
+
+
+
+<>
+
+```cs
+// TODO unity
+```
+
+
+<>
+
+```java
+import com.taptap.sdk.share.TapTapShareBuilder;
+import com.taptap.sdk.share.TapTapShareCode;
+
+int resultCode = new TapTapShareBuilder()
+ .addTitle("title") // 分享标题
+ .addContents("content") // 分享内容
+ .addHashtagIds("hashtag ids") // HashTag 和活动 Id
+ .addGroupLabelId("group ids") // 论坛标签 Id
+ .addFooterImageUrls(new ArrayList(uri1, uri2)) // 分享的图片
+ .build()
+ .share(activity);
+
+switch (resultCode){
+ case TapTapShareCode.Success_Code: // 分享成功
+ case TapTapShareCode.Error_NotInstall: // 分享失败：未安装 TapTap 应用
+ default: // 分享失败：TapTap 应用不支持
+}
+
+```
+
+
+<>
+
+```kotlin
+import com.taptap.sdk.share.TapTapShareBuilder
+import com.taptap.sdk.share.TapTapShareCode
+
+val resultCode: Int = TapTapShareBuilder()
+ .addTitle(title) // 分享标题
+ .addContents(content) // 分享内容
+ .addHashtagIds(hashtag) // HashTag 和活动 Id
+ .addGroupLabelId(group) // 论坛标签 Id
+ .addFailUrl("fail url") // 未安装 TapTap 应用时跳转链接
+ .addFooterImageUrls(picList) // 分享的图片
+ .build()
+ .share(this)
+
+when (resultCode) {
+ TapTapShareCode.Success_Code -> // 分享成功
+ TapTapShareCode.Error_NotInstall -> // 分享失败: 未安装 TapTap 应用
+ else -> // 分享失败: TapTap 应用不支持
+}
+```
+
+
+<>
+
+// TODO iOS 文档
+
+
+
+
+
+
+## 测试
+为了保证上线后，游戏对于用户是否正常使用 Tap 分享功能，请务必按照以下说明完成自测。
+
+### 上传 APK
+
+新应用需要上传测试的 APK 至开发者中心，并通过审核。已上架的游戏，需确保更新资料版本中的 APK 包名和已上架的 APK 包名保持一致。
+
+### 应用上线
+
+针对已上架的游戏，开发者需确保**更新资料版本中的包名和已上架的游戏包名保持一致**，否则会导致玩家因包名不一致而更新失败。
+
+针对新游戏，开发者需要在 TapTap 上线一个包含 APK 包并且通过审核**（用于平台获取游戏包名，包名需与后续更新的包名保持一致）**的商店资料版本，如果 APK 包当前无法对外，可将发布状态设置为「敬请期待」或「预约」。
+
+### 开始测试
+
+触发分享功能后正常状态是可以唤起 TapTap 应用的分享页面。
+
+
+
+