檢測設備測試

首先，請參閱 developer.android.com 上的「測試應用程式」。請注意，在平台測試中使用檢測設備測試的方式有所不同。

簡單來說，檢測設備測試會提供透過 am instrument 指令啟動的特殊測試執行環境，其中指定的應用程式程序會在基本應用程式結構定義下重新啟動並初始化，而在應用程式程序 VM 內啟動檢測執行緒。測試程式碼會在這個檢測設備執行緒上開始執行，並提供 Instrumentation 例項，可存取應用程式內容和 API，以便操作受測試的應用程式程序。

核心概念

  • 您必須在應用程式套件中宣告檢測工具，並在應用程式套件資訊清單的 <manifest> 標記下方嵌套 <instrumentation> 標記。
  • 應用程式套件資訊清單在技術上可包含多個 <instrumentation> 標記，但通常不會以這種方式使用。
  • 每個 <instrumentation> 都必須包含：
    • android:name 屬性：應為測試應用程式中包含的 Instrumentation 子類別名稱，通常是指測試執行工具，例如：android.support.test.runner.AndroidJUnitRunner
    • 必須定義 android:targetPackage 屬性。其值應設為測試中的應用程式套件。

步驟摘要

  1. 以下是針對架構服務的語意測試的常見目的地：

    frameworks/base/core/tests/coretests
frameworks/base/services/tests/servicestests

    如果您要為元件新增全新的檢測模組，請參閱

  2. 如果您要在上述任一位置新增測試，請遵循現有的慣例。如果您要設定新的測試模組，請按照上述任一位置中的 AndroidManifest.xml 和 Android.mk 設定

  3. 如需範例，請參閱 frameworks/base/core/tests/coretests/。請注意，這些行會安裝額外的應用程式：

    <option name="test-file-name" value="FrameworksCoreTests.apk" />
<option name="test-file-name" value="BstatsTestApp.apk" />

  4. 別忘了將測試標示為 @SmallTest、@MediumTest 或 @LargeTest

  5. 使用 m 建構測試模組，例如：

    m FrameworksCoreTests

  6. 執行測試：

    • 最簡單的解決方法是使用 Atest，如下所示：

      atest FrameworksCoreTests

    • 如要進行較複雜的測試，請使用貿易聯盟測試 Harness：

    m tradefed-all
tradefed.sh run template/local_min --template:map test=FrameworksCoreTests

  7. 如果您未使用 Tradefed，請手動安裝及執行測試：

    1. 安裝產生的 APK：
    adb install -r ${OUT}/data/app/FrameworksCoreTests/FrameworksCoreTests.apk

    1. 使用各種選項執行測試：

      1. APK 中的所有測試

        adb shell am instrument -w com.android.frameworks.coretests\
  /android.support.test.runner.AndroidJUnitRunner

      2. 特定 Java 套件下的所有測試

        adb shell am instrument -w -e package android.animation \
  com.android.frameworks.coretests\
  /android.support.test.runner.AndroidJUnitRunner

      3. 特定類別下的所有測試

        adb shell am instrument -w -e class \
  android.animation.AnimatorSetEventsTest \
  com.android.frameworks.coretests\
  /android.support.test.runner.AndroidJUnitRunner

      4. 特定測試方法

        adb shell am instrument -w -e class \
  android.animation.AnimatorSetEventsTest#testCancel \
  com.android.frameworks.coretests\
  /android.support.test.runner.AndroidJUnitRunner

您的測試可以使用 JUnit API 明確斷言測試是否通過或失敗；此外，任何未偵測到的例外狀況也會導致功能失敗。

如要產生成效指標，測試程式碼可以呼叫 Instrumentation#sendStatus 傳送鍵/值組合清單。請注意以下事項：

  1. 指標可以是整數或浮點
  2. 所有非數字的值都會遭到捨棄
  3. 您的測試 APK 可以是功能測試或指標測試，但目前不支援混合兩者