TapSDK 集成
本文介绍如何快速接入 TapSDK 。
环境要求
- Unity
- Android Java
- Android Kotlin
- iOS Swift
- iOS Objective-C
- Unity 2019.4 或更高版本,Target API Level 33 及以下
- iOS 11 或更高版本,Xcode 版本 15.3 或更高版本
- Android 5.0(API level 21)或更高版本
- Android 5.0(API level 21)或更高版本
- Android 5.0(API level 21)或更高版本
- iOS 11 或更高版本,Xcode 版本 15.3 或更高版本
- iOS 11 或更高版本,Xcode 版本 15.3 或更高版本
编译工具链
Unity & Android 一般通过 Gradle & AGP 进行构建,所以对于 Unity & Android 项目,需要确保 Gradle 和 AGP 的版本兼容,TapSDK 对 Gradle 和 AGP 的版本要求如下:
最低版本要求:
- GRADLE_VERSION: 6.1.1+
- AGP_VERSION: 4.0.1+
项目配置
- Unity
- Android Java
- Android Kotlin
- iOS Swift
- iOS Objective-C
第一步:添加 SDK 所需的外部依赖
SDK 内部使用了部分第三方库,开发者接入时需先确保 SDK 外部依赖库已正常接入,具体设置如下:
- SDK 使用的 JSON 解析库为
Newtonsoft-json
,如果当前工程已接入该依赖库,则不需额外处理,否则需在Packages/manifest.json
添加如下依赖:
"com.unity.nuget.newtonsoft-json":"3.2.1"
- SDK 使用
com.google.external-dependency-manager
管理 Android、iOS 依赖,如果当前工程已接入该依赖库,则不需额外处理,否则需在Packages/manifest.json
添加如下依赖:
{
"dependencies": {
"com.google.external-dependency-manager": "1.2.179"
},
"scopedRegistries": [
{
"name": "package.openupm.com",
"url": "https://package.openupm.com",
"scopes": [
"com.google.external-dependency-manager"
]
}
]
}
第二步:添加 SDK 依赖
SDK 支持 Unity Package Manager 及本地文件导入两种集成方式,开发者根据需求选择其中一种即可,推荐使用远程依赖。
远程依赖
SDK 支持通过 NPMJS 及 GitHub 两种方式,开发者选择其中一种即可。
1. NPMJS 接入
在项目的 Packages/manifest.json
文件中添加以下依赖:
"dependencies":{
"com.taptap.sdk.core":"4.5.9",
}
但需要注意的是,需在 Packages/manifest.json
中 dependencies
同级下声明 scopedRegistries
:
"scopedRegistries":[
{
"name": "NPMJS",
"url": "https://registry.npmjs.org/",
"scopes": ["com.taptap"]
}
]
2. GitHub 接入
在项目的 Packages/manifest.json
文件中 添加以下依赖:
"dependencies":{
"com.taptap.sdk.core":"https://github.com/taptap/TapSDKCore-Unity.git#4.5.9",
}
在 Unity 顶部菜单中选择 Window > Package Manager 可查看已经安装在项目中的包。