執行試用版應用程式

本頁面說明如何使用試用版應用程式和 Google Play 管理中心執行端對端測試。

操作步驟

如要下載 SDK、執行試用版應用程式、驗證應用程式是否正常運作,以及在 Google Play 管理中心查看該應用程式的影格時間資訊,請按照下列步驟操作:

  1. 下載 SDK .zip 檔案並解壓縮。
  2. 建構並執行試用版應用程式。
  3. 執行監控應用程式。
  4. 建立發布子版本。
  5. 執行發布子版本。
  6. 在 Google Play 管理中心查看圖表。

建構並執行試用版應用程式

在 Android Studio 中執行 APT Insights Demo 應用程式,確保所有建構作業都能正確進行。這項專案使用 CMake 進行原生程式碼建構,並示範如何使用 gamesdk.cmake 檔案 (這是最簡單的入門方式)。

如要執行試用版應用程式,請進行下列步驟:

  1. 將 .zip 檔案內容解壓縮至資料夾。
  2. 開啟 Android Studio。
  3. 按一下「File」>「Open」,然後選取 gamesdk/samples/tuningfork/insightsdemo/build.gradle
  4. 等待 Android Studio 同步處理專案。
  5. 連結裝置 (或建立虛擬裝置) 來執行這個範例。在裝置上啟用開發人員選項和 USB 偵錯
  6. 選取目標裝置,然後按一下「Run」Android Studio 執行按鈕。詳情請參閱建構並執行應用程式

    圖 1. 測試應用程式執行成功
  7. 範例 APK 應該會在目標裝置上建構及安裝。如果發生錯誤,請確認下列項目:

    • 您擁有 Android SDK 支援的版本;詳情請參閱應用程式模組 build.gradle 檔案中的 compileSdkVersion 欄位。您可以從 SDK Manager 的「SDK Platforms」分頁更新 SDK 版本
    • 您擁有 Android NDK 支援的版本;詳情請參閱應用程式模組 build.gradle 檔案中的 ndkVersion 欄位。您可以從 SDK Manager 的「SDK Tools」分頁安裝特定版本的 NDK
    • 專案中的 local.properties 檔案「並未」擁有 ndk.dir 的項目。這個位置是由 Android Studio 指定,且使用上述的 NDK 版本。如果擁有這個項目,請清除這一整行。
    • 在變更任何建構設定之後,請清理專案 (依序點選「Build」>「Clean Project」),然後重新整理已連結的 C++ 專案 (依序點選「Build」>「Refresh Linked C++ Projects」)。

執行監控應用程式

使用試用版應用程式的偵錯版本或任何其他已啟用 Tuning Fork 的應用程式,您可以將應用程式設定為從本機端點傳送及接收資料,而不是透過 Google Play 伺服器。方法是在 Tuning Fork 設定中設定 endpoint_uri_override

#ifndef NDEBUG
   settings.endpoint_uri_override = "http://localhost:9000";
#endif

您也必須在 AndroidManifest.xml 檔案中納入下列權限:

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

試用版應用程式已進行了這些變更 (請參閱 insightsdemo.cpp)。

您可以使用這項功能驗證應用程式是否正在傳送和接收正確的資料。如要加以驗證,請同時執行試用版應用程式和 Tuning Fork Monitor 應用程式。此監控應用程式可做為本機伺服器使用,並顯示已啟用 Tuning Fork 的應用程式所產生的資料。

如要同時執行監控應用程式和試用版應用程式,以驗證試用版應用程式是否正常運作,請按照下列步驟操作:

  1. 使用以下程式碼在目標裝置上安裝 Tuning Fork Monitor 應用程式 APK ADB
    adb install gamesdk/gamesdk/apks/tools/TuningForkMonitor.apk
    
  2. 開啟監控應用程式。
  3. 按下 Android 主畫面按鈕,將 Tuning Fork Monitor 應用程式傳送到裝置的背景。
  4. 在前景再次執行試用版應用程式約 30 秒。
  5. 切換回 Tuning Fork Monitor 應用程式。
  6. 試用版應用程式會在「Live Applications」下方顯示為 com.tuningfork.insightsdemo 16。輕觸這個項目即可查看應用程式詳細資料和即時遙測資料。
圖 2. 監控應用程式會偵測試用版應用程式
圖 3. 監控應用程式會顯示試用版應用程式的資料

建立發布子版本

在 Android Studio 中建立試用版應用程式的發布子版本。將這個版本上傳至 Google Play 管理中心,即可在 Android Vitals 中啟用影格時間圖表。

  1. 在 Google Cloud Console 中啟用 Android Performance Parameters API。這個 API 可讓應用程式與 Google Play 通訊。您不需要限制試用版應用程式的 API 金鑰。

  2. 請務必將上一個步驟的 API 金鑰複製到 gamesdk/samples/tuningfork/insightsdemo/app/src/main/assets/tuningfork/tuningfork_settings.txtapi_key 欄位中。

  3. 試用版應用程式的應用程式 ID 已預留,因此無法上傳使用此 ID 的 APK。在應用程式的 build.gradle 檔案中變更這個 ID:

    applicationId "com.tuningfork.your-unique-identifier"
    
  4. 清理專案 (依序點選「Build」>「Clean Project」),然後重新整理已連結的 C++ 專案 (依序點選「Build」>「Refresh Linked C++ Projects」)。

  5. 建立發布子版本的簽署設定。

    1. 依序選取「File」>「Project Structure」>「Modules」
    2. 選取「Signing Configs」分頁標籤。
    3. 新增名為 release 的新設定。
    4. 為設定建立 KeyStore
  6. 將版本簽署設定與發布版建構變數建立關聯。

    1. 依序選取「File」>「Project Structure」>「Build Variants」
    2. 選取「Build Types」分頁標籤。
    3. 選取名為 release 的建構類型。
    4. 在「Signing Config」方塊中,選取版本設定變數。
  7. 在 Android Studio 專案視窗中選取「app」目錄 (選取這個目錄後,就能在下個步驟選取選單)。

  8. 將使用中的建構變數變更為 release (依序點選「Build」>「Select Build Variant」)。

  9. 依序選取「Build」>「Build Bundles(s)/APK(s)」>「Build APK(s)」。建構完成後,按一下「locate」連結來尋找發布版 APK。

  10. 在 Google Play 管理中心為試用版應用程式建立新的應用程式。詳情請參閱上傳應用程式

  11. 將發布版 APK 上傳到內部測試群組。詳情請參閱準備作業與發布版本一文。

執行發布子版本

選取目標裝置,然後按一下「Run」Android Studio 執行按鈕。您必須使用之前上傳到 Google Play 管理中心的發布版 APK。

讓版應用程式執行一段時間。Google Play 管理中心最多可能要 30 分鐘才能開始顯示資料。在「Logcat」視窗中選取「Info」記錄層級,確認資料會上傳到伺服器。如果在記錄中發現錯誤,請參閱「排解常見錯誤」。

... I/TuningFork:Web: Connecting to:
    https://performanceparameters.googleapis.com/v1/applications/com.tuningfork.yourapp/apks/24:uploadTelemetry
... I/TuningFork: Scene loading 30 (true) took 166 ms
... I/TuningFork:Web: Response code: 200
... I/TuningFork:Web: Response message: OK
... I/TuningFork.GE: UPLOAD request returned 200 {}

在 Google Play 管理中心查看圖表

開啟 Google Play 管理中心,然後選取測試應用程式。依序選取「Android Vitals」>「Performance」>「Insights」,即可查看影格時間圖表。

圖 4. Android Vitals 圖表

您已成功使用 Tuning Fork 程式庫執行端對端測試。你將不再需要使用測試應用程式的專案,因此可以在 Google Play 管理中心將其刪除。