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。