指定應用程式範例

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

這類檢測設備測試與以一般 Android 應用程式為目標的測試並無太大差異。值得注意的是，包含檢測設備的測試應用程式必須使用與目標應用程式相同的憑證簽署。

請注意，本指南假設您已具備平台來源樹工作流程的相關知識。如果沒有，請參閱「規定」一節。本節的範例是撰寫新的檢測設備測試，並將目標套件設為其專屬的測試應用程式套件。如果您不熟悉這個概念，請參閱平台測試簡介。

本指南會使用追蹤測試做為範例：

• frameworks/base/packages/Shell/tests

建議您先瀏覽程式碼，取得大致印象，再繼續操作。

決定來源位置

由於檢測設備測試會指定應用程式，因此慣例是將測試原始碼放在平台來源樹狀結構中元件來源目錄根目錄下的 tests 目錄中。

如要進一步瞭解來源位置，請參閱自檢測設備測試的端對端範例。

資訊清單檔案

就像一般應用程式一樣，每個檢測設備測試模組都需要資訊清單檔案。如果您將檔案命名為 AndroidManifest.xml，並在測試模組的 Android.mk 旁提供該檔案，BUILD_PACKAGE 核心 Makefile 就會自動納入該檔案。

在繼續操作之前，強烈建議您先詳閱「應用程式資訊清單總覽」。

這份文件將概略說明資訊清單檔案的基本元件及其功能。

如要存取範例 gerrit 變更的最新版資訊清單檔案，請前往以下網址：https://android.googlesource.com/platform/frameworks/base/+/main/packages/Shell/tests/AndroidManifest.xml

為了方便您操作，我們已隨附快照：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.android.shell.tests">

    <application>
        <uses-library android:name="android.test.runner" />

        <activity
            android:name="com.android.shell.ActionSendMultipleConsumerActivity"
            android:label="ActionSendMultipleConsumer"
            android:theme="@android:style/Theme.NoDisplay"
            android:noHistory="true"
            android:excludeFromRecents="true">
            <intent-filter>
                <action android:name="android.intent.action.SEND_MULTIPLE" />
                <category android:name="android.intent.category.DEFAULT" />
                <data android:mimeType="*/*" />
            </intent-filter>
        </activity>
    </application>

    <instrumentation android:name="android.support.test.runner.AndroidJUnitRunner"
        android:targetPackage="com.android.shell"
        android:label="Tests for Shell" />

</manifest>

資訊清單檔案的部分選取備註：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.android.shell.tests">

package 屬性是應用程式套件名稱：這是 Android 應用程式架構用來識別應用程式 (或在本例中：測試應用程式) 的專屬 ID。系統中的每位使用者只能安裝一個套件名稱相同的應用程式。

由於這是測試應用程式套件，與測試中的應用程式套件無關，因此必須使用不同的套件名稱：常見的慣例是新增後置字串 .test。

此外，這個 package 屬性與 ComponentName#getPackageName() 傳回的值相同，也與您透過 adb shell 與各種 pm 子指令互動的值相同。

另外請注意，雖然套件名稱通常與 Java 套件名稱採用相同的樣式，但實際上兩者之間的關聯性很低。換句話說，應用程式 (或測試) 套件可包含任何套件名稱的類別，但您也可以選擇簡化方式，讓應用程式或測試中的頂層 Java 套件名稱與應用程式套件名稱相同。

<uses-library android:name="android.test.runner" />

由於相關的類別會封裝在個別的架構 JAR 程式庫檔案中，因此當應用程式架構叫用測試套件時，就需要額外的類別路徑項目，因此所有檢測工具測試都需要這項功能。

android:targetPackage="com.android.shell"

這會將檢測作業的目標套件設為 com.android.shell。透過 am instrument 指令叫用檢測設備時，架構會重新啟動 com.android.shell 程序，並將檢測設備程式碼插入程序中執行測試。這也表示測試程式碼可存取在測試應用程式中執行的所有類別例項，並且可能會根據公開的測試鉤子操控狀態。

簡易設定檔

每個新測試模組都必須有設定檔，以便透過模組中繼資料、編譯時依附元件和封裝指示，引導建構系統。在大多數情況下，以 Soong 為基礎的藍圖檔案選項就足夠了。詳情請參閱「簡易測試設定」。

複雜的設定檔

對於較複雜的測試，您還需要為 Android 的測試裝置 Trade Federation 編寫測試設定檔案。

測試設定可以指定特殊裝置設定選項和預設引數，以提供測試類別。

您可以前往以下位置，查看範例 Gerrit 變更的最新設定檔： frameworks/base/packages/Shell/tests/AndroidTest.xml

為了方便您操作，我們已隨附快照：

<configuration description="Runs Tests for Shell.">
    <target_preparer class="com.android.tradefed.targetprep.TestAppInstallSetup">
        <option name="test-file-name" value="ShellTests.apk" />
    </target_preparer>

    <option name="test-suite-tag" value="apct" />
    <option name="test-tag" value="ShellTests" />
    <test class="com.android.tradefed.testtype.AndroidJUnitTest" >
        <option name="package" value="com.android.shell.tests" />
        <option name="runner" value="android.support.test.runner.AndroidJUnitRunner" />
    </test>
</configuration>

測試設定檔中的部分精選註解：

<target_preparer class="com.android.tradefed.targetprep.TestAppInstallSetup">
  <option name="test-file-name" value="ShellTests.apk"/>
</target_preparer>

這會告訴 Trade Federation 使用指定的 target_preparer 將 ShellTests.apk 安裝到目標裝置上。Trade Federation 提供許多目標準備工具，可讓開發人員在執行測試前確保裝置設定正確。

<test class="com.android.tradefed.testtype.AndroidJUnitTest">
  <option name="package" value="com.android.shell.tests"/>
  <option name="runner" value="android.support.test.runner.AndroidJUnitRunner"/>
</test>

這會指定要用來執行測試的 Trade Federation 測試類別，以及在要執行的裝置上套件中傳遞的測試執行工具架構，在本例中為 JUnit。

如要進一步瞭解「測試模組設定」，請參閱這篇文章

JUnit4 功能

使用 android-support-test 程式庫做為測試執行程式，可採用新的 JUnit4 樣式測試類別，而範例 Gerrit 變更則包含一些非常基本的功能用法。

您可以前往以下位置，查看示例 Gerrit 變更的最新原始碼：frameworks/base/packages/Shell/tests/src/com/android/shell/BugreportReceiverTest.java

雖然測試模式通常是元件團隊專屬，但有些使用模式通常相當實用。

@SmallTest
@RunWith(AndroidJUnit4.class)
public final class FeatureFactoryImplTest {

JUnit4 的一大差異之處在於，測試不再需要繼承自通用的基礎測試類別；而是在純 Java 類別中編寫測試，並使用註解指出特定測試設定和限制。在本例中，我們會指示這個類別應以 Android JUnit4 測試的形式執行。

@SmallTest 註解會為整個測試類別指定測試大小：所有新增至此測試類別的測試方法都會繼承這個測試大小註解。測試類別前置設定、測試結束後和測試類別結束後：類似 JUnit4 中的 setUp 和 tearDown 方法。Test 註解用於標註實際測試。

    @Before
    public void setup() {
    ...
    @Test
    public void testGetProvider_shouldCacheProvider() {
    ...

JUnit4 會在方法上使用 @Before 註解，執行測試前設定。雖然本例未使用，但也有用於測試後拆解的 @After。同樣地，JUnit4 可在方法上使用 @BeforeClass 和 @AfterClass 註解，在執行測試類別中的所有測試之前執行設定，並在之後進行解構。請注意，類別範圍的設定和拆除方法必須是靜態的。

至於測試方法，與早期版本的 JUnit 不同，這些方法的名稱不再需要以 test 開頭，而是必須使用 @Test 標註。如常，測試方法必須是公開的，且不宣告傳回值、不接受參數，且可能擲回例外狀況。

        Context context = InstrumentationRegistry.getTargetContext();

由於 JUnit4 測試不再需要通用的基礎類別，因此您不再需要透過 getContext() 或 getTargetContext() 取得基礎類別方法的 Context 例項；相反地，新的測試執行工具會透過 InstrumentationRegistry 管理這些項目，其中儲存了檢測設備架構建立的內容和環境設定。您也可以透過這個類別呼叫：

• getInstrumentation()：Instrumentation 類別的例項
• getArguments()：透過 -e <key> <value> 傳遞至 am instrument 的指令列引數

在本機建構及測試

針對最常見的用途，請採用 Atest。

如需更複雜的做法，且需要更多自訂功能，請按照檢測器操作說明操作。