打造檢測設備測試

設備測試會在 Android 裝置上執行，包括實體或模擬。阿斯 以便運用 Android 架構 API檢測設備測試 因此準確度會比本機測試更高 。

建議您只在必須進行測試時，才使用檢測設備測試 模擬真實裝置的行為AndroidX Test 提供多個程式庫 可讓您在必要時更輕鬆地編寫檢測設備測試

注意： 檢測設備測試 (也稱為「檢測設備」) 經過初始化調整 先可以在特殊環境中存取 檢測。這個類別可讓您存取應用程式結構定義。 運用 API 操控受測的應用程式，並提供檢測設備測試名稱。

設定測試環境

在 Android Studio 專案中，儲存用於檢測的來源檔案 module-name/src/androidTest/java/ 中的測試。這個目錄已存在 請先建立一項新專案，並加入檢測設備測試範例

開始之前，您應新增 AndroidX Test API，以便快速 為應用程式建立並執行檢測設備測試程式碼。AndroidX Test 內含 JUnit 4 測試執行器、AndroidJUnitRunner 和用於功能 UI 測試的 API ，例如 Espresso、UI Automator 和 Compose 測試。

您也需要為專案設定 Android 測試依附元件，才能 請使用測試執行器和 AndroidX Test 提供的規則 API。

在應用程式的頂層 build.gradle 檔案中，您必須指定這些程式庫 做為依附元件：

dependencies {
    androidTestImplementation "androidx.test:runner:$androidXTestVersion"
    androidTestImplementation "androidx.test:rules:$androidXTestVersion"
    // Optional -- UI testing with Espresso
    androidTestImplementation "androidx.test.espresso:espresso-core:$espressoVersion"
    // Optional -- UI testing with UI Automator
    androidTestImplementation "androidx.test.uiautomator:uiautomator:$uiAutomatorVersion"
    // Optional -- UI testing with Compose
    androidTestImplementation "androidx.compose.ui:ui-test-junit4:$compose_version"
}

您可以在 AndroidX 版本資訊和 Compose 中找到最新版本 UI 版本資訊。

如要使用 JUnit 4 測試類別並存取測試篩選等功能， 請務必將 AndroidJUnitRunner 指定為預設的測試檢測設備 將下列設定加入應用程式的 模組層級 build.gradle 檔案：

android {
    defaultConfig {
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
}

建立檢測設備測試類別

您的檢測設備測試類別應是與以下類似的 JUnit 4 測試類別： 請參閱建構本機測試一節所述的類別。

如要建立檢測 JUnit 4 測試類別，請將 AndroidJUnit4 指定為 預設測試執行器

注意： 如果您的測試套件採用 JUnit3 和 JUnit4 程式庫，請將 測試開頭的 @RunWith(AndroidJUnit4::class) 註解 類別定義。

以下範例說明如何編寫檢測設備測試來進行驗證 Parcelable 介面正確導入， LogHistory 類別：

Kotlin

import android.os.Parcel
import android.text.TextUtils.writeToParcel
import androidx.test.filters.SmallTest
import androidx.test.runner.AndroidJUnit4
import com.google.common.truth.Truth.assertThat
import org.junit.Before
import org.junit.Test
import org.junit.runner.RunWith

const val TEST_STRING = "This is a string"
const val TEST_LONG = 12345678L

// @RunWith is required only if you use a mix of JUnit3 and JUnit4.
@RunWith(AndroidJUnit4::class)
@SmallTest
class LogHistoryAndroidUnitTest {
    private lateinit var logHistory: LogHistory

    @Before
    fun createLogHistory() {
        logHistory = LogHistory()
    }

    @Test
    fun logHistory_ParcelableWriteRead() {
        val parcel = Parcel.obtain()
        logHistory.apply {
            // Set up the Parcelable object to send and receive.
            addEntry(TEST_STRING, TEST_LONG)

            // Write the data.
            writeToParcel(parcel, describeContents())
        }

        // After you're done with writing, you need to reset the parcel for reading.
        parcel.setDataPosition(0)

        // Read the data.
        val createdFromParcel: LogHistory = LogHistory.CREATOR.createFromParcel(parcel)
        createdFromParcel.getData().also { createdFromParcelData: List<Pair<String, Long>> ->

            // Verify that the received data is correct.
            assertThat(createdFromParcelData.size).isEqualTo(1)
            assertThat(createdFromParcelData[0].first).isEqualTo(TEST_STRING)
            assertThat(createdFromParcelData[0].second).isEqualTo(TEST_LONG)
        }
    }
}

Java

import android.os.Parcel;
import android.util.Pair;
import androidx.test.runner.AndroidJUnit4;
import com.google.common.truth.Truth.assertThat;
import java.util.List;
import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;

// @RunWith is required only if you use a mix of JUnit3 and JUnit4.
@RunWith(AndroidJUnit4.class)
public class LogHistoryAndroidUnitTest {

    public static final String TEST_STRING = "This is a string";
    public static final long TEST_LONG = 12345678L;
    private LogHistory mLogHistory;

    @Before
    public void createLogHistory() {
        mLogHistory = new LogHistory();
    }

    @Test
    public void logHistory_ParcelableWriteRead() {
        // Set up the Parcelable object to send and receive.
        mLogHistory.addEntry(TEST_STRING, TEST_LONG);

        // Write the data.
        Parcel parcel = Parcel.obtain();
        mLogHistory.writeToParcel(parcel, mLogHistory.describeContents());

        // After you're done with writing, you need to reset the parcel for reading.
        parcel.setDataPosition(0);

        // Read the data.
        LogHistory createdFromParcel = LogHistory.CREATOR.createFromParcel(parcel);
        List<Pair<String, Long>> createdFromParcelData
                = createdFromParcel.getData();

        // Verify that the received data is correct.
        assertThat(createdFromParcelData.size()).isEqualTo(1);
        assertThat(createdFromParcelData.get(0).first).isEqualTo(TEST_STRING);
        assertThat(createdFromParcelData.get(0).second).isEqaulTo(TEST_LONG);
    }
}

注意： 只有裝置支援在 Kotlin 中使用倒引號進行名稱測試 執行 API 30 以上版本例如： @Test fun `everything works`() { ... }

執行檢測設備測試

您可以在實體裝置或模擬器上執行設備測試。在 Android Studio 指南提供以下功能：

• 從 Android Studio 進行測試
• 透過指令列進行測試

其他資源

UI 測試通常是檢測設備測試，可驗證 以及如何透過使用者介面他們會使用 Espresso 或 Compose Test 等架構。學習 詳情請參閱 UI 測試指南。

如要進一步瞭解如何使用檢測設備測試，請參閱下列資源 再複習一下，機構節點 是所有 Google Cloud Platform 資源的根節點

範例

• 檢測設備單元測試程式碼範例

程式碼研究室

• Android 測試程式碼研究室