1 快速集成

在QuickTracking后臺，為每一個App生成了專屬的集成代碼，可以根據(jù)產(chǎn)品內(nèi)的引導(dǎo)進(jìn)行集成。注意，需要檢查目前是否已經(jīng)使用了友盟+SDK，如果已經(jīng)使用，請及時設(shè)置更改SDK文件路徑，具體設(shè)置方式請參考本文檔中1.2章節(jié)部分內(nèi)容。

1.1 產(chǎn)品路徑

Quick Tracking「首頁」-「管理控制臺」，在「管理控制臺」進(jìn)入「組織列表」功能，組織列表展示當(dāng)前已創(chuàng)建的組織，找到應(yīng)用歸屬組織，點擊「管理應(yīng)用」功能跳轉(zhuǎn)到「應(yīng)用管理]頁面，在已創(chuàng)建好的應(yīng)用右側(cè)點擊去「去集成」。

點擊「去集成」按鈕跳轉(zhuǎn)到新頁面可以獲取專屬集成代碼，點擊下一步按引導(dǎo)進(jìn)入到「集成校驗」，掃碼喚起APP，確認(rèn)集成是否成功。

1.2 檢查是否與友盟+SDK沖突

注意，需要檢查目前是否已經(jīng)使用了友盟+SDK，如果已經(jīng)使用，請務(wù)必設(shè)置更改SDK文件路徑。

2 集成代碼明細(xì)

如果因為特定原因，無法抵達(dá)上述頁面，需要觀看文檔才可以進(jìn)行集成，具體集成代碼如下：

2.1 參數(shù)準(zhǔn)備

appKey：在應(yīng)用列表中獲取

收數(shù)域名：在“管理控制臺-采集信息”模塊中獲取

SDK信息：在“管理控制臺-采集信息”模塊中獲取添加網(wǎng)頁鏈接

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統(tǒng)計分析SDK
    implementation 'com.lydaas.qtsdk:qt-px-common:1.6.2.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 配置權(quán)限

統(tǒng)計SDK需要宿主APP授予如下權(quán)限：

下面給出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 混淆配置

如果您的應(yīng)用使用了代碼混淆，請?zhí)砑尤缦屡渲茫员苊釷uick Tracking SDK被錯誤混淆導(dǎo)致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需要引用導(dǎo)入工程的資源文件，通過了反射機(jī)制得到資源引用文件R.java，但是在開發(fā)者通過proguard等混淆/優(yōu)化工具處理apk時，proguard可能會將R.java刪除，如果遇到這個問題，請?zhí)砑尤缦屡渲茫?/p>

-keep public class [您的應(yīng)用包名].R$*{
public static final int *;
} 

2.5 埋點驗證配置

在AndroidManifest.xml文件中找到響應(yīng)android.intent.action.MAIN的activity（也就是應(yīng)用可以被外部喚起的第一個Activity），加上如下代碼，讓應(yīng)用能被指定連接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、請使用單獨(dú)intent-filter，和其他intent-filter并列，不要將上述代碼填入其他intent-filter里；

2、請將“您的appKey”替換成您的應(yīng)用的appKey。