为 AndroidX 测试设置项目

AndroidX 测试是一组 Jetpack 库，可让您对 Android 应用运行测试。它还提供了一系列工具来帮助您编写这些测试。

例如，AndroidX 测试提供 JUnit4 规则，可在 JUnit4 测试中启动活动并与之交互。它还包含 UI 测试框架，例如 Espresso、UI Automator 和 Robolectric 模拟器。

添加 AndroidX 测试库

为了使用 AndroidX 测试，您必须在开发环境中修改应用项目的依赖项。

添加 Gradle 依赖项

要修改应用项目的依赖项，请完成以下步骤

  • 步骤 1：打开 Gradle 模块的 build.gradle 文件。
  • 步骤 2：在存储库部分，确保出现了 Google 的 Maven 存储库
  allprojects {
    repositories {
      jcenter()
      google()
    }
  }
  • 步骤 3：对于要使用的每个 AndroidX 测试包，将它的包名添加到依赖项部分。例如，要添加 espresso-core 包，请添加以下行

Groovy

dependencies {
        ...
        androidTestImplementation "androidx.test.espresso:espresso-core:$espressoVersion"
    }

Kotlin

dependencies {
        ...
        androidTestImplementation('androidx.test.espresso:espresso-core:$espressoVersion')
    }

以下是可用的最常见的 AndroidX 测试依赖项

Groovy

dependencies {
    // Core library
    androidTestImplementation "androidx.test:core:$androidXTestVersion0"

    // AndroidJUnitRunner and JUnit Rules
    androidTestImplementation "androidx.test:runner:$testRunnerVersion"
    androidTestImplementation "androidx.test:rules:$testRulesVersion"

    // Assertions
    androidTestImplementation "androidx.test.ext:junit:$testJunitVersion"
    androidTestImplementation "androidx.test.ext:truth:$truthVersion"

    // Espresso dependencies
    androidTestImplementation "androidx.test.espresso:espresso-core:$espressoVersion"
    androidTestImplementation "androidx.test.espresso:espresso-contrib:$espressoVersion"
    androidTestImplementation "androidx.test.espresso:espresso-intents:$espressoVersion"
    androidTestImplementation "androidx.test.espresso:espresso-accessibility:$espressoVersion"
    androidTestImplementation "androidx.test.espresso:espresso-web:$espressoVersion"
    androidTestImplementation "androidx.test.espresso.idling:idling-concurrent:$espressoVersion"

    // The following Espresso dependency can be either "implementation",
    // or "androidTestImplementation", depending on whether you want the
    // dependency to appear on your APK’"s compile classpath or the test APK
    // classpath.
    androidTestImplementation "androidx.test.espresso:espresso-idling-resource:$espressoVersion"
}

Kotlin

dependencies {
    // Core library
    androidTestImplementation("androidx.test:core:$androidXTestVersion")

    // AndroidJUnitRunner and JUnit Rules
    androidTestImplementation("androidx.test:runner:$testRunnerVersion")
    androidTestImplementation("androidx.test:rules:$testRulesVersion")

    // Assertions
    androidTestImplementation("androidx.test.ext:junit:$testJunitVersion")
    androidTestImplementation("androidx.test.ext:truth:$truthVersion")

    // Espresso dependencies
    androidTestImplementation( "androidx.test.espresso:espresso-core:$espressoVersion")
    androidTestImplementation( "androidx.test.espresso:espresso-contrib:$espressoVersion")
    androidTestImplementation( "androidx.test.espresso:espresso-intents:$espressoVersion")
    androidTestImplementation( "androidx.test.espresso:espresso-accessibility:$espressoVersion")
    androidTestImplementation( "androidx.test.espresso:espresso-web:$espressoVersion")
    androidTestImplementation( "androidx.test.espresso.idling:idling-concurrent:$espressoVersion")

    // The following Espresso dependency can be either "implementation",
    // or "androidTestImplementation", depending on whether you want the
    // dependency to appear on your APK"s compile classpath or the test APK
    // classpath.
    androidTestImplementation( "androidx.test.espresso:espresso-idling-resource:$espressoVersion")
}

版本说明 页面包含一个表格，其中列出了每个构件的最新版本。

有关这些库的特定参考文档，请参阅 包索引 或 类索引。

使用已弃用类的项目

如果您的应用程序使用依赖于已弃用的基于 JUnit3 的 android.test 类（例如 InstrumentationTestCase 和 TestSuiteLoader）的测试，请在文件中的 android 部分添加以下行

android {
    ...
    useLibrary 'android.test.runner'

    useLibrary 'android.test.base'
    useLibrary 'android.test.mock'
  }

添加清单声明

要运行依赖于已弃用的基于 JUnit3 的 android.test 类的测试，请将必要的 <uses-library> 元素添加到测试应用程序的清单中。例如，如果您添加依赖于 android.test.runner 库的测试，请将以下元素添加到应用程序的清单中

<!-- You don't need to include android:required="false" if your app's

   minSdkVersion is 28 or higher. -->

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

       android:required="false" />

要确定包含给定基于 JUnit 的类的库，请参阅 基于 JUnit 的库。

使用已弃用的类和面向 Android 9 或更高版本时的注意事项

更高

本节中的指南仅适用于您面向 Android 9（API 级别 28）或更高版本且应用程序的最低 SDK 版本设置为 Android 9 的情况。

该 android.test.runner 库隐式依赖于 android.test.base 和 android.test.mock 库。如果您的应用程序仅使用来自 android.test.base 或 android.test.mock 的类，您可以自己包含这些库

<!-- For both of these declarations, you don't need to include
   android:required="false" if your app's minSdkVersion is 28
   or higher. -->

<uses-library android:name="android.test.base"
       android:required="false" />
<uses-library android:name="android.test.mock"
       android:required="false" />