QuickSDK
官方SDK系统-海外版

更新日期：2025-12-31海外版Android接入文档

注意：Facebook SDK 升级到v13.0.0版本，需要配置facebook_client_token参数


在AndroidManifest文件中添加：


在res/values/strings.xml中添加:  

replace your client token


facebook_client_token的值在facebook后台：设置(Settings) --> 高级(Advanced) --> 安全(Security) --> 客户端口令(Client token)中获取：






一、开发环境



1.1.开发工具：Android Studio


1.2.Android Gradle 插件版本最低为3.3.3 


classpath 'com.android.tools.build:gradle:3.3.3'


因Android 11新特性需要，android gradle插件需要升级至对应版本的最新版本





1.3.gradle.properties配置AndroidX 


android.useAndroidX=true
android.enableJetifier=true


1.4.minSdkVersion 版本最低为16，targetSdkVersion根据Google Play的要求设置




二、工程配置




2.1. 拷贝SDK文件、配置域名



将SDK资源libs目录所需资源拷贝到Android项目libs目录，

quickgame_hw_x.x.x.aar为必需资源，x.x.x为具体版本

将SDK资源assets/QHinfo 拷贝到Android项目assets目录

将SDK对应IP解析后的域名写入assets/QHinfo文件中（注意需使用文本编辑器打开写入，域名地址前面要加上http://）

2.2. 修改build.gradle配置，可参考demo 


repositories {
    flatDir {
        dirs 'libs' // aar文件目录
    }
}
dependencies {
    //以下为必需依赖的库
    implementation(name: 'quickgame_hw_x.x.x', ext: 'aar') //x.x.x为具体版本
    implementation 'com.android.billingclient:billing:7.0.0'//google内购
    implementation 'androidx.appcompat:appcompat:1.6.0'
    implementation "org.jetbrains.kotlin:kotlin-stdlib:1.4.10"
    
    //以下为选接库，x.x.x为具体版本，以SDK资源里的对接文档为准
    implementation 'com.google.android.gms:play-services-auth:x.x.x' //谷歌登录
    implementation 'com.google.android.gms:play-services-ads-identifier:x.x.x' // adid获取
    implementation 'com.facebook.android:facebook-android-sdk:x.x.x' //Facebook
    implementation 'com.appsflyer:af-android-sdk:x.x.x' //appsflyer
    implementation 'com.adjust.sdk:adjust-android:x.x.x' //adjust
    implementation 'com.android.installreferrer:installreferrer:x.x.x' //appsflyer、adjust需要
    implementation 'com.twitter.sdk.android:twitter:x.x.x'//Twitter登录
    implementation (name: 'line_sdk_x.x.x',ext: 'aar')//Line登录
    implementation files('libs/libTapDB-x.x.x.aar') //tapdb
    implementation files('libs/TalkingData_GP_GameAnalytics_Vx.x.x.jar') //TalkingData
}


2.3. 修改AndroidManifest文件


在application节点下配置


谷歌登录配置（按需配置） 


 <
meta-data
    android:name="google-signin-client_id"       
    android:value="替换为google后台申请的clientid"/>

注：Google后台有android client 和 web client 两种，这里使用的是web client id，需跟运营人员确认清楚



AppsFlyer配置（按需配置） 


<
meta-data 
    android:name="DEV_KEY" 
    android:value="替换为在AppsFlyer后台申请的Dev_Key" />


Adjust配置（按需配置） 

<
meta-data
    android:name="adjust.Token"
    android:value="替换成adjust_token"/>

<
meta-data
    android:n