游量android SDK接入指南
注： 此SDK文档对应的版本是1.0.0，本文档只针对于Android Studio开发环境提供接入文档
1. 申请你的clientid
请到 开发者应用登记页面 进行登记，登记并选择移动应用进行设置后，将该应用提交审核，由游量平台生成并且提供clientid, 只有审核通过的应用才能进行开发。
2. 下载SDK和对应demo
3. 搭建开发环境
1. 在android studio中建立你的工程
下载完SDK后解压，把下载的SDK开发工具包下面的libs中的JinTuSDK_xxx.aar (xxx是对应的SDK版本号)文件复制到工程下面的libs目录：
2. 添加依赖
在对应的app module的build.gradle中加入以下依赖：
dependencies {
// 这边加入 '*.aar'资源
implementation fileTree(include: ['*.jar', '*.aar'], dir: 'libs')
implementation 'com.android.support:appcompat-v7:28.0.0'
implementation 'com.android.support.constraint:constraint-layout:1.1.3'
implementation 'com.android.support:design:28.0.0'
}
3.设置SDK最小版本
defaultConfig {
...
minSdkVersion 15
...
}
注：若没有设置上面的最小版本为15，会出现构建错误：
Manifest merger failed with multiple errors, see logs
4.设置编译SDK版本
android {
...
compileSdkVersion 28
...
}
注： 若没有设置编译SDK版本为 28, 会出现构建错误：
error: resource android:attr/dialogCornerRadius not found. Message{kind=ERROR, text=error: resource android:attr/dialogCornerRadius not found., sources=[C:\Users\B150M-Am.2\.gradle\caches\transforms-1\files-1.1\appcompat-v7-28.0.0.aar\3226f64da50349bb62338cc62a0d162d\res\values-v28\values-v28.xml:9:5-12:13], original message=, tool name=Optional.of(AAPT)}…
5.添加databinding支持
android {
...
// 游量SDK接入，导入aar包需要配置flatDir
repositories {
flatDir {
dirs 'libs'
}
}
// 游量SDK接入，开放databinding
dataBinding {
enabled true
}
...
}
4. 在代码中使用开发工具包
1. 新建自己的Application类：
在工程项目下新建自己的MyApplication继承Application:
2. 注册游量SDK：
在MyApplication中的onCreate回调方法中对游量的SDK进行注册：
2. 在AndroidManifest.mxl文件中设置application的name属性为自己创建的Application类：
3. 在主活动中注册 游量API：
- 在工程主Activity中的 onCreate回调方法中加入JinTuApi.onCreate(this);
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 初始化游量api
JinTuApi.onCreate(this);
}
- 在工程主Activity的onDestroy回调方法中加入 JinTuApi.onDestroy();
@Override
protected void onDestroy() {
JinTuApi.onDestroy();
super.onDestroy();
}
4. 游量平台登录API
public void jintuLogin(View view) {
//调用游量登录，参数0是登录方式，现在游量只有唯一登录方式：手机登录-0；
JinTuApi.login(0);
}
5. 设置游量平台登录回调
// 务必设置这个监听，在调用游量登录的时候会把返回消息传递到 onLoginNotify
// 方法中，其中主要是accessToken，应用方在登录应用服务器的时候，携带此accessToken
// 给服务端进行验证登录（服务端需要通过accessToken验证用户的合法性）。
JinTuApi.setUserListener(new JinTuUserListener() {
@Override
public void onLoginNotify(UserLoginRet userLoginRet) {
//回调方法中执行应用方应用端登录或其他逻辑
tv.setText("登录成功： " + userLoginRet);
}
});
6. 代码混淆
如果项目工程有开启代码混淆的话，在混淆文件中添加如下代码：
-keep class com.jintu.bz.account.*{*;}
-keep class com.jintu.bz.account.api.** {*;}
-keep class com.jintu.bz.account.model.** {*;}
-keep class com.jintu.bz.account.databinding.** {*;}
-dontwarn okio.**
-dontwarn retrofit2.**
-dontwarn android.databinding.**
至此，你已经能使用游量Android 开发工具包的 API 内容了。如果想更详细了解每个 API 函数的用法，请查阅 Android 平台参考手册 或自行下载阅读锦途 SDK Sample Demo 源码, 源码包含在SDK包中。
