Quick Tracking:SDK の導入と構成

基本的な SDK 情報

1 クイック統合

QuickTracking のバックグラウンドでは、App ごとに専用の統合コードが生成され、プロダクトのガイダンスに従って統合できます。Umeng + SDK を使用したことがあるかどうかを確認してください。SDK を使用したことがある場合は、SDK ファイルパスを速やかに変更してください。詳細については、このドキュメントの「1.2」をご参照ください。

1.1 プロダクトパス

Quick Tracking の [ホーム] - [管理コンソール] に移動し、[管理コンソール] で [組織リスト] 機能に移動します。組織リストには現在作成されている組織が表示されます。アプリケーションが属する組織を見つけ、[アプリケーションの管理] 機能をクリックして [アプリケーション管理] ページに移動します。作成したアプリケーションの右側にある [統合解除] をクリックします。

[統合解除] ボタンをクリックして新しいページに移動し、専用の統合コードを取得します。[次へ] をクリックして [統合検証] に入り、コードをスキャンしてアプリを呼び出し、統合が成功したかどうかを確認します。

1.2 Umeng + SDK と競合するかどうかの確認

すでに Umeng + SDK を使用しているかどうかを確認する必要があることに注意してください。すでに使用している場合は、必ず SDK ファイルパスの変更を設定してください。

2 統合コードの詳細

特定の理由で前のページにアクセスできない場合は、統合する前にドキュメントを確認する必要があります。具体的な統合コードは次のとおりです。

2.1 パラメータの準備

appKey：アプリケーションリストから取得

収集ドメイン名：「管理コンソール - 収集情報」モジュールで取得

SDK 情報: [管理コンソール] の [情報収集] セクションで Web ページリンクの追加 を取得できます。

2.2 SDK の導入

2.2.1 自動統合

プロジェクトの build.gradle 構成スクリプトの buildscript セクションと allprojects セクションに、QuickTracking SDK 用の新しい Maven リポジトリの URL を追加します。

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

プロジェクトに対応する build.gradle 構成スクリプトの repositories セクションに、SDK Maven リポジトリアドレスを追加します。

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/' }
    }
}

プロジェクトアプリに対応する build.gradle 構成スクリプトの dependencies セクションに、統計 SDK ライブラリと他のライブラリの依存関係を追加します。

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

    // QuickTracking 統計分析 SDK
    implementation 'com.lydaas.qtsdk:qt-px-common:1.8.5.PX'
  
}

Android Studio 3.1 以降の開発環境では、依存関係 "latest.de velopment" の最新バージョンを指定すると、ダウンロードタイムアウトが発生する場合があります。この場合は、バージョン番号を指定する必要があります。

2.2.2 手動統合

SDK 機能コンポーネントを選択してダウンロードし、.zip ファイルを解凍して対応するコンポーネントパッケージを取得します。

• qt-px-common-1.x.x.PX.aar // 統計 SDK。統合必須。

• 関連するコンポーネント jar パッケージを Android Studio のプロジェクト libs ディレクトリにコピーし、Android Studio のプロジェクトを右クリックして、[モジュール設定を開く] -> ポップアップボックスの [プロジェクト構造] -> [依存関係] タブを選択 -> 左下の「+」をクリック -> コンポーネントパッケージタイプを選択 -> 対応するパッケージを導入します。

• Eclipse でプロジェクトのルートディレクトリを右クリックし、[プロパティ] -> [Java ビルドパス] -> [ライブラリ] を選択し、[外部 JAR の追加...] をクリックして JAR を指すパスを選択し、[OK] をクリックします。これでインポートは成功です（ADT17 以降は手動でインポートする必要はありません）。

• プロジェクトアプリケーションレベルに対応する build.gradle 構成スクリプトの dependencies セクションに、統計 SDK ライブラリを追加します。

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 では、ホストアプリケーションに次の権限が付与されている必要があります。

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 [your app package name]. R$*{
public static final int *;
} 

2.5 タグ検証の構成

AndroidManifest.xml ファイルで android.intent.action.MAIN に応答するアクティビティ（つまり、アプリケーションを外部から呼び出すことができる最初のアクティビティ）を見つけ、次のコードを追加して、アプリケーションを指定された接続スキームで呼び出すことができるようにします。

<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. Your appKey" />
</intent-filter>

注：

1. 別の intent-filter を使用し、他の intent-filter と並べて配置してください。上記のコードを他の intent-filter に入力しないでください。

2. 「Your appKey」をアプリケーションの appKey に置き換えます。