TapDB安卓SDK详细接入步骤

0. 在TapDB后台创建应用

创建TapDB账号
登录后台
创建企业
创建项目

获取项目的应用id，后边需要用到。

注意
新创建的项目是调试状态。

1.下载并添加TapDB SDK包

在TapDB官网下载SDK包
https://www.tapdb.com/docs/zh_CN/download/SDK.html

注意
认准官网标志哈，不要从第三方下载。

与很多sdk不同，TapDB的sdk提供的是aar的包，而不是maven之类的网络库，所以下载后，解压，然后复制到工程里。

2.在Gradle中引用TapDB SDK

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])
    // 其他lib...
}

3.在AndroidManifest.xml设置必要的权限

<!--必选权限-->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

<!--强烈建议权限  sdk 获取 IMEI 时会需要此权限；获取不到不影响功能正常使用，IMEI 用于辅助数据分析，使统计结果更加精确--> 
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

4.初始化TapDB SDK

注意
必须使用以下两个方法之一来初始化TapDB SDK

// 1). 
public static void init(Context context, String appId, String channel, String appVersion)

// 2). 
public static void init(Context context, String appId, String channel, String appVersion, JSONObject properties)

5.测试TapDB SDK

1). 添加测试设备

下载并安装TapDB客户端，然后在企业管理界面中，扫描二维码来添加测试设备。

2). 运行测试应用

使用添加到后台的测试设备进入游戏，如果一切正常，TapDB后台会显示激活的设备数量，并提示
调试完成，进入项目

6. 常见问题

6.1. TapDB后台显示项目一直处于调试状态，始终无法变成正式项目。

检查以下几点：

1). 必须用测试设备进行游戏
2). 保证测试设备可以联网
3). 检查初始化TapDB时的id是否正确
4). 检查初始化TapDB的init方法是否正确
TapDB的初始化方法有好几个，必须用带version参数的那两个：

TapDB.init(app, TAPDB_ID, CHANNEL_ID, version, null);

如果在日志中看到以下信息，表示使用的init方法不对：

正确姿势

官方技术支持

如果接入一直遇到问题，可以联系TapDB的官方技术支持，在网站上可以找到他们的企业微信联系方式。