iOS SDK 开发指南

集成前准备

1. 参考 开发者中心配置 创建应用、配置包名与签名证书
2. 参考 iOS 集成指南 完成基础接入
3. 已从 TapTap REP 平台 获取需要打开的页面链接

SDK 获取

远程依赖

1. 在工程 Podfile 文件中对应模块下添加依赖：

 pod 'TapTapSDK/Rep', '~> 4.11.1'

2. 执行 pod install 下载对应依赖文件

本地文件依赖

TapTap REP 依赖于初始化模块，使用本地文件方式添加依赖时，需先参考集成指南 添加对应本地文件依赖项。

1. 在 下载页 下载如下文件：

• TapTapRepSDK.xcframework REP 依赖库

2. 在工程中添加 framework 静态库，注意添加时选择 Embed 方式为 Do Not Embed

tip

由于 SDK 需判断当前设备是否安装 TapTap 客户端，开发者需在 Xcode 工程的 info.plist 文件 LSApplicationQueriesSchemes 字段中添加 taptap 参数

打开链接

Swift

import TapTapRepSDK

// 打开指定 URL
let url = "" // 替换为实际的 URL
TapTapRep.open(openUrl: url) { errorCode, errorMessage in
    if errorCode == 0 {
        // 打开成功
        print("打开成功")
    } else {
        // 打开失败
        print("打开失败: \(errorCode), \(errorMessage ?? "")")
    }
}

Objective-C

#import "TapTapRepSDK/TapTapRepSDK-Swift.h"

// 打开指定 URL
NSString *url = @""; // 替换为实际的 URL
[TapTapRep openWithOpenUrl:url completion:^(NSInteger errorCode, NSString * _Nullable errorMessage) {
    if (errorCode == 0) {
        // 打开成功
        NSLog(@"打开成功");
    } else {
        // 打开失败
        NSLog(@"打开失败: %ld, %@", (long)errorCode, errorMessage);
    }
}];

参数说明

参数	说明
openUrl/url	要打开的 URL 地址，必须是完整的链接（包含 http:// 或 https://）。建议使用 TapTap REP 平台 生成的链接
callback/completion	回调函数，返回打开结果。errorCode 为 0 表示成功，其他值表示失败；errorMessage 为错误信息

错误码说明

错误码	说明
0	成功
100002	参数错误（URL 为空或格式不正确）
100003	客户端配置错误（SDK 未初始化）
100004	未知错误

测试

为了保证上线后游戏能够正常使用 TapTap REP 功能，请务必按照以下说明完成自测。

测试步骤

1. 准备测试 URL

   • 访问 TapTap REP 平台 获取测试链接
   • 或使用游戏在 TapTap 上的详情页链接进行测试

2. 已安装 TapTap 客户端的情况

   • 调用 open 方法后，应能正确唤起 TapTap 应用
   • 检查打开的页面内容是否正确

3. 未安装 TapTap 客户端的情况

   • 调用 open 方法后，应能在浏览器中打开对应页面
   • 检查网页版页面内容是否正确显示

4. 错误处理

   • 测试传入空 URL 或错误格式 URL 时的错误处理
   • 测试 SDK 未初始化时调用的错误提示