核心實作與生命週期。

此資訊可協助您實作 Android 資料庫並收集生命週期量度 (例如：啟動、升級、工作階段、參與的使用者等等)。

下載 SDK

重要

若要下載 SDK，您必須使用 Android 2.2 或更新版本。

  1. 請完成下列章節所述的步驟，以設定開發報表套裝，並下載預先填入的設定檔案版本：

  2. 下載並解壓縮 [Your_App_Name_]AdobeMobileLibrary-4.*-Android.zip 檔案，然後確認您有下列軟體元件：

    • adobeMobileLibrary.jar，此元件為搭配 Android 裝置和模擬器使用的資料庫。

    • ADBMobileConfig.json，此元件為根據您應用程式自訂的 SDK 設定檔案。

    重要

    如果您在 Adobe Mobile Services 使用者介面以外的地方下載 SDK，則必須手動設定 ADBMobileConfig.json 檔案。如果您是初次使用 Analytics 和 Mobile SDK，並且想設定開發報表套裝和下載預先填入版本的設定檔案，請參閱開始之前。

新增 SDK 和設定檔案至您的 IntelliJ IDEA 或 Eclipse 專案

IntelliJ IDEA 專案

新增 SDK 和設定檔案至您的專案：

  1. 將 ADBMobileConfig.json 檔案新增至專案中的 assets 資料夾。

  2. 在專案導覽面板中，以滑鼠右鍵按一下您的專案。

  3. 選取​開啟模組設定。

  4. 在​「專案設定」​下，選取​「資料庫」。

  5. 按一下 ]****[!UICONTROL + 圖示即可新增資料庫。

  6. 選取​「Java」 並導覽至 adobeMobileLibrary.jar 檔案。

  7. 選取您計劃使用行動資料庫所在的模組。

  8. 按一下​「套用」​與​「確定」，以關閉「模組設定」視窗。

Eclipse 專案

新增 SDK 和設定檔案至您的專案：

  1. 將 ADBMobileConfig.json 檔案新增至專案中的 assets 資料夾。
  2. 在 Eclipse IDE 中，以滑鼠右鍵按一下專案名稱。
  3. 按一下​「組建路徑****> 新增外部封存檔」。
  4. 選擇 adobeMobileLibrary.jar。
  5. 按一下​「開啟」。
  6. 再次以滑鼠右鍵按一下專案，然後選取​「組建路徑****> 設定組建路徑」。
  7. 在​「排序和匯出」​標籤上，確認已選取 adobeMobileLibrary.jar。

新增應用程式權限

AppMeasurement 資料庫需要下列權限，才能傳送資料及記錄離線追蹤呼叫：

  • INTERNET
  • ACCESS_NETWORK_STATE

若要新增這些權限，請在位於應用程式專案目錄的 AndroidManifest.xml 檔案中新增下列行：

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

設定應用程式內容

您應在主要活動的 onCreate 方法中新增下列程式碼：

   @Override
   public void onCreate(BundlesavedInstanceState){
     super.onCreate(savedInstanceState)
     setContentView(R.layout.main);
     Config.setContext(this.getApplicationContext());
   }

實作生命週期量度

啟用生命週期後，每當您的應用程式啟動時，就會傳送一次點擊以測量啟動數、升級數、工作階段數、參與使用者數，以及許多其他量度。如需詳細資訊，請參閱生命週期量度。

在應用程式的各個活動中完成下列步驟：

  1. 匯入資料庫：

    import com.adobe.mobile.*;

  2. 在 onResume 函式中，啟動生命週期資料集合：

    @Override
public void onResume() {
    Config.collectLifecycleData(this);
    // -or- Config.collectLifecycleData(this, contextData);
}

  3. 在 onPause 函式中，暫停生命週期資料集合：

    @Override
public void onPause() {
    Config.pauseCollectingLifecycleData();
}
重要

您必須新增此類呼叫至所有活動，以確保當機報告準確。如需詳細資訊，請參閱追蹤應用程式當機。

納入其他資料與生命週期呼叫

若要納入其他資料與生命週期量度呼叫，請將其他參數傳遞至包含內容資料的 collectLifecycleData：

@Override
public void onResume() {
    HashMap<String, Object> contextData = new HashMap<String, Object>();
    contextData.put("myapp.category", "Game");
    Config.collectLifecycleData(this, contextData);
}

與 collectLifecycleData 一併傳送的其他內容資料值，必須對應至 Adobe Mobile Services 中的自訂變數：

系統會自動收集其他生命週期量度。如需詳細資訊，請參閱生命週期量度。

後續步驟

完成下列作業：

本頁內容