准备用于上传的 Espresso 测试

重要

Visual Studio App Center 计划于 2025 年 3 月 31 日停用。 虽然可以继续使用 Visual Studio App Center,直到它完全停用,但你可以考虑迁移到几个建议的替代方法。

详细了解支持时间线和替代方案。

本文档提供有关准备要上传到测试的 Espresso 测试的说明。 有关创作 Espresso 测试的指南,请参阅 Espresso 文档

1. 对生成系统的更改

添加 Maven Central 存储库。 请确保项目根目录中的 build.gradle 中有一个mavenCentral()条目:

allprojects {
    repositories {
        mavenCentral()
    }
}

在应用模块的 build.gradle 文件中添加以下依赖项:

androidTestImplementation('com.microsoft.appcenter:espresso-test-extension:1.4')

此代码将 Test Espresso Extensions 作为依赖项添加到项目,这可确保 ReportHelper 在编译时可用。 启用ReportHelperlabel该功能。 有关该功能的更多详细信息, label 请参阅步骤 3。

如果使用低于 3.0 的 Gradle 版本,则可能需要按照 gradle 文档中的说明将 替换为 androidTestImplementationandroidTestCompile

2. 测试的更改

步骤 1 - 添加导入

将这些包导入测试类:

import org.junit.Rule;
import org.junit.After;
import com.microsoft.appcenter.espresso.Factory;
import com.microsoft.appcenter.espresso.ReportHelper;

步骤 2 - 实例化 ReportHelper

在每个测试类中插入此声明:

@Rule
public ReportHelper reportHelper = Factory.getReportHelper();

步骤 3 - 更新测试用例

使用帮助程序仍允许在本地运行测试,而无需进行其他修改,但允许使用 reportHelper.label("myTestStepLabel")标记测试执行中的测试步骤。 标签文本用于导航测试报告中的测试步骤和相应的屏幕截图。

建议在 方法中@After调用label,此调用会获取测试报告的应用最终状态的屏幕截图。 即使测试失败,也会拍摄屏幕截图。 测试的示例 @After 方法可能如下所示:

@After
public void TearDown(){
    reportHelper.label("Stopping App");
}

若要生成项目并测试 apk 文件,请运行以下命令。

./gradlew assembleDebug
./gradlew assembleDebugAndroidTest

注意

系统 path 变量必须包括对计算机的 Java 安装的访问权限。

使用 Test Cloud 扩展检测测试套件后, 将其上传到 Test Cloud