引入&配置SDK

1 快速集成

在QuickTracking后台，为每一个App生成了专属的集成代码，可以根据产品内的引导进行集成。注意，需要检查目前是否已经使用了友盟+SDK，如果已经使用，请及时设置更改SDK文件路径，具体设置方式请参考本文档中1.2章节部分内容。

1.1 产品路径

Quick Tracking「首页」-「管理控制台」，在「管理控制台」进入「组织列表」功能，组织列表展示当前已创建的组织，找到应用归属组织，点击「管理应用」功能跳转到「应用管理]页面，在已创建好的应用右侧点击去「去集成」。

点击「去集成」按钮跳转到新页面可以获取专属集成代码，点击下一步按引导进入到「集成校验」，扫码唤起APP，确认集成是否成功。

1.2 检查是否与友盟+SDK冲突

注意，需要检查目前是否已经使用了友盟+SDK，如果已经使用，请务必设置更改SDK文件路径。

2 集成代码明细

如果因为特定原因，无法抵达上述页面，需要观看文档才可以进行集成，具体集成代码如下：

2.1 参数准备

appKey：在应用列表中获取

收数域名：在“管理控制台-采集信息”模块中获取

SDK信息：在“管理控制台-采集信息”模块中获取添加网页链接

2.2 引入SDK

maven { url 'https://repo1.maven.org/maven2/' }

buildscript {
    repositories {
        google()
        jcenter()
        maven { url 'https://repo1.maven.org/maven2/' }
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:3.4.0'
    }
}

allprojects {
    repositories {
        google()
        jcenter()
        maven { url 'https://repo1.maven.org/maven2/' }
    }
}

dependencies {
    implementation fileTree(include:['*.jar'], dir:'libs')

    //QuickTracking统计分析SDK
    implementation 'com.lydaas.qtsdk:qt-px-common:1.6.3.PX'
  
}

repositories{
    flatDir{
        dirs 'libs'
    }
}

dependencies {
    implementation fileTree(include: ['*.jar'], dir: 'libs')
    implementation files('libs/qt-px-common-1.x.x.PX.aar') // 必选
}

2.3 配置权限

统计SDK需要宿主APP授予如下权限：

下面给出AndroidManifest.xml清单文件示例：

<manifest>
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
    <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
    <uses-permission android:name="android.permission.INTERNET"/>
</manifest>

2.4 混淆配置

如果您的应用使用了代码混淆，请添加如下配置，以避免Quick Tracking SDK被错误混淆导致SDK不可用。

-keep class com.umeng.** {*;}
-keep class org.repackage.** {*;}

-keep class com.quick.qt.** {*;}
-keep class rpk.quick.qt.** {*;}

-keepclassmembers class * {
   public <init> (org.json.JSONObject);
}
-keepclassmembers enum * {
    public static **[] values();
    public static ** valueOf(java.lang.String);
}

SDK需要引用导入工程的资源文件，通过了反射机制得到资源引用文件R.java，但是在开发者通过proguard等混淆/优化工具处理apk时，proguard可能会将R.java删除，如果遇到这个问题，请添加如下配置：

-keep public class [您的应用包名].R$*{
public static final int *;
} 

2.5 埋点验证配置

在AndroidManifest.xml文件中找到响应android.intent.action.MAIN的activity（也就是应用可以被外部唤起的第一个Activity），加上如下代码，让应用能被指定连接scheme唤起：

<intent-filter>
    <action android:name="android.intent.action.VIEW"/>
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="atm.您的appKey" />
</intent-filter>

注意：

1、请使用单独intent-filter，和其他intent-filter并列，不要将上述代码填入其他intent-filter里；

2、请将“您的appKey”替换成您的应用的appKey。