Microsoft.Testing.Platform 配置设置

Microsoft.Testing.Platform 支持使用配置文件和环境变量来配置测试平台的行为。 本文介绍可用于配置测试平台的配置设置。

testconfig.json

测试平台使用名为 [appname].testconfig.json 的配置文件来配置测试平台的行为。 testconfig.json 文件是一个 JSON 文件,其中包含测试平台的配置设置。

testconfig.json 文件具有以下结构:

{
    "platformOptions": {
        "config-property-name1": "config-value1",
        "config-property-name2": "config-value2"
    }
}

平台将自动检测并加载位于测试项目的输出目录中的 [appname].testconfig.json 文件(靠近可执行文件)。

使用 Microsoft.Testing.Platform.MSBuild 时,只需创建 testconfig.json 文件,该文件将自动重命名为 [appname].testconfig.json,并移动到测试项目的输出目录。

从 Microsoft.Testing.Platform 1.5 开始,可以使用命令行参数 --config-file 指定 testconfig.json的路径。 此文件优先于 [appname].testconfig.json 文件。

注意

在后续生成中,[appname].testconfig.json 文件将被覆盖。

环境变量

环境变量可用于提供一些运行时配置信息。

注意

环境变量优先于 testconfig.json 文件中的配置设置。

TESTINGPLATFORM_UI_LANGUAGE 环境变量

从 Microsoft.Testing.Platform 1.5 开始,此环境变量设置平台的语言,以便使用区域设置值(如 en-us)显示消息和日志。 此语言优先于 Visual Studio 和 .NET SDK 语言。 支持的值与 Visual Studio 的值相同。 有关详细信息,请参阅 Visual Studio 安装文档中更改安装程序语言的部分。