7.2 swift test

原文链接: https://docs.swift.org/latest/documentation/packagemanagerdocs/swifttest/

7.2 swift test

构建并运行测试。

test [--package-path=<package-path>]
  [--cache-path=<cache-path>] [--config-path=<config-path>]
  [--security-path=<security-path>]
  [--scratch-path=<scratch-path>]
  [--swift-sdks-path=<swift-sdks-path>]
  [--toolset=<toolset>...]
  [--pkg-config-path=<pkg-config-path>...]
  [--enable-dependency-cache|disable-dependency-cache]
  [--enable-build-manifest-caching|disable-build-manifest-caching]
  [--manifest-cache=<manifest-cache>]
  [--enable-experimental-prebuilts|disable-experimental-prebuilts]
  [--verbose] [--very-verbose|vv] [--quiet]
  [--color-diagnostics|no-color-diagnostics]
  [--disable-sandbox] [--netrc] 
  [--enable-netrc|disable-netrc] [--netrc-file=<netrc-file>]
  [--enable-keychain|disable-keychain]
  [--resolver-fingerprint-checking=<resolver-fingerprint-checking>]
  [--resolver-signing-entity-checking=<resolver-signing-entity-checking>]
  [--enable-signature-validation|disable-signature-validation]
  [--enable-prefetching|disable-prefetching]
  [--force-resolved-versions|disable-automatic-resolution|only-use-versions-from-resolved-file]
  [--skip-update] [--disable-scm-to-registry-transformation]
  [--use-registry-identity-for-scm]
  [--replace-scm-with-registry]
  [--default-registry-url=<default-registry-url>]
  [--configuration=<configuration>] [--=<Xcc>...]
  [--=<Xswiftc>...] [--=<Xlinker>...] [--=<Xcxx>...]
  [--triple=<triple>] [--sdk=<sdk>]
  [--toolchain=<toolchain>] [--swift-sdk=<swift-sdk>]
  [--sanitize=<sanitize>...]
  [--auto-index-store|enable-index-store|disable-index-store]
  [--enable-parseable-module-interfaces] [--jobs=<jobs>]
  [--use-integrated-swift-driver]
  [--explicit-target-dependency-import-check=<explicit-target-dependency-import-check>]
  [--build-system=<build-system>] [--=<debug-info-format>]
  [--enable-dead-strip|disable-dead-strip]
  [--disable-local-rpath] [--skip-build]
  [--enable-xctest|disable-xctest]
  [--enable-swift-testing|disable-swift-testing]
  [--attachments-path=<attachments-path>]
  [--parallel|no-parallel] [--num-workers=<num-workers>]
  [--list-tests]
  [--show-coverage-path=[<mode>]]
  [--show-codecov-path|show-code-coverage-path]
  [--specifier=<specifier>] [--filter=<filter>...]
  [--skip=<skip>...] [--xunit-output=<xunit-output>]
  [--enable-testable-imports|disable-testable-imports]
  [--enable-coverage|disable-coverage]
  [--enable-code-coverage|disable-code-coverage]
  [--coverage-format=<format>...]
  [-Xcov=<Xcov>...]
  [--debugger]
  [--traits=<traits>] [--enable-all-traits]
  [--disable-default-traits] [--version] [--help]

另见：swift build、swift run、swift package

• –package-path=<package-path>：

指定要操作的包路径（默认为当前目录）。这会先切换工作目录，然后再执行其他任何操作。

• –cache-path=<cache-path>：

指定共享缓存目录的路径。

• –config-path=<config-path>：

指定共享配置目录的路径。

• –security-path=<security-path>：

指定共享安全目录的路径。

• –scratch-path=<scratch-path>：

指定自定义的临时构建目录路径。（默认 .build）

• –swift-sdks-path=<swift-sdks-path>：

包含已安装 Swift SDK 的目录路径。

• –toolset=<toolset>：

指定为目标平台构建时使用的工具集 JSON 文件。可以多次使用该选项来指定多个工具集。各个工具集会按指定顺序合并为当前构建的单个最终工具集。

• –pkg-config-path=<pkg-config-path>：

指定搜索 pkg-config .pc 文件的替代路径。可以多次使用该选项来指定多个路径。

• –enable-dependency-cache|disable-dependency-cache：

获取依赖时使用共享缓存。

• –enable-build-manifest-caching|disable-build-manifest-caching：

• –manifest-cache=<manifest-cache>：

Package.swift 清单的缓存模式。有效取值：shared（共享缓存）、local（包的构建目录）、none（禁用）

• –enable-experimental-prebuilts|disable-experimental-prebuilts：

是否对宏使用预编译的 swift-syntax 库。

• –verbose：

提高详细程度，包含信息性输出。

• –very-verbose|vv：

提高详细程度，包含调试输出。

• –quiet：

降低详细程度，只包含错误输出。

• –color-diagnostics|no-color-diagnostics：

在向 TTY 输出时启用或禁用彩色诊断信息。默认情况下，连接到 TTY 时启用彩色诊断，否则禁用。

• –disable-sandbox：

执行子进程时禁用沙箱。

• –netrc：

即使在其他凭据存储更优先的情况下也使用 netrc 文件。

• –enable-netrc|disable-netrc：

从 netrc 文件加载凭据。

• –netrc-file=<netrc-file>：

指定 netrc 文件的路径。

• –enable-keychain|disable-keychain：

在 macOS 钥匙串中查找凭据。

• –resolver-fingerprint-checking=<resolver-fingerprint-checking>：

• –resolver-signing-entity-checking=<resolver-signing-entity-checking>：

• –enable-signature-validation|disable-signature-validation：

验证从注册表下载的已签名包发布的签名。

• –enable-prefetching|disable-prefetching：

• –force-resolved-versions|disable-automatic-resolution|only-use-versions-from-resolved-file：

只使用 Package.resolved 文件中的版本，如果该文件已过期则解析失败。

• –skip-update：

在解析期间跳过从远程更新依赖。

• –disable-scm-to-registry-transformation：

禁用从源代码管理到注册表的转换。

• –use-registry-identity-for-scm：

在注册表中查找源代码管理依赖，并尽可能使用它们的注册表标识，以帮助在两种来源之间去重。

• –replace-scm-with-registry：

在注册表中查找源代码管理依赖，并尽可能改用注册表来获取它们，而不是用源代码管理。

• –default-registry-url=<default-registry-url>：

要使用的默认注册表 URL，用于替代 registries.json 配置文件。

• –configuration=<configuration>：

以指定配置构建

• –=<Xcc>：

把标志传递给所有 C 编译器调用。

• –=<Xswiftc>：

把标志传递给所有 Swift 编译器调用。

• –=<Xlinker>：

把标志传递给所有链接器调用。

• –=<Xcxx>：

把标志传递给所有 C++ 编译器调用。

• –triple=<triple>：

• –sdk=<sdk>：

• –toolchain=<toolchain>：

• –swift-sdk=<swift-sdk>：

筛选构建时要使用的特定 Swift SDK。

• –sanitize=<sanitize>：

打开针对错误行为的运行时检查，可能取值：address、thread、undefined、scudo。

• –auto-index-store|enable-index-store|disable-index-store：

启用或禁用构建期间建立索引的特性。

• –enable-parseable-module-interfaces：

• –jobs=<jobs>：

构建过程中并行启动的任务数量。

• –use-integrated-swift-driver：

• –explicit-target-dependency-import-check=<explicit-target-dependency-import-check>：

一个标志，表明本次构建应检查各个目标是否只导入它们显式声明的依赖。

• –build-system=<build-system>：

• –=<debug-info-format>：

要使用的调试信息格式。

• –enable-dead-strip|disable-dead-strip：

禁用/启用链接器的死代码剥离。

• –disable-local-rpath：

默认不再把 $ORIGIN/@loader_path 加入 rpath。

• –skip-build：

跳过构建测试目标。

• –enable-xctest|disable-xctest：

启用对 XCTest 的支持。

• –enable-swift-testing|disable-swift-testing：

启用对 Swift Testing 的支持。

• –attachments-path=<attachments-path>：

附件应写入的路径（仅 Swift Testing）。该路径必须是当前用户可写的已存在目录。如果未指定，测试期间创建的任何附件都会被丢弃。

• –parallel|no-parallel：

并行运行测试。

• –num-workers=<num-workers>：

并行执行的测试数量。

• –list-tests：

以说明符格式列出测试方法。

• –show-coverage-path=[<mode>]：

打印导出的代码覆盖率文件的路径。mode 指定如何显示所选代码覆盖率文件格式的路径。取值：json、text。作为标志传入时的默认值：text。

• –show-codecov-path|show-code-coverage-path：

打印导出的代码覆盖率文件的路径。（已弃用。请改用 --show-coverage-path [<mode>]）

• –specifier=<specifier>：

• –filter=<filter>：

运行与正则表达式匹配的测试用例，格式：’.’ 或 ‘./’。

• –skip=<skip>：

跳过与正则表达式匹配的测试用例，例如：’–skip PerformanceTests’。

• –xunit-output=<xunit-output>：

应生成 xUnit xml 文件的路径。

• –enable-testable-imports|disable-testable-imports：

启用或禁用可测试导入。默认启用。

• –enable-code-coverage|disable-code-coverage：

启用代码覆盖率。（已弃用。请改用 ‘–enable-coverage/–disable-coverage’）

• –enable-coverage|disable-coverage：

启用代码覆盖率。

• –coverage-format=<format>：

代码覆盖率输出的格式。可以指定多次。（默认：json）取值：json（通过执行 llvm-cov export 生成 JSON 覆盖率报告）、html（通过执行 llvm-cov show 生成 HTML 报告）。

• -Xcov=<Xcov>：

把标志（可选择带上格式说明）传递给底层的覆盖率报告工具。语法：[<coverage-format>=]<value>。可以指定多次。

• –debugger：

在 LLDB 调试会话中启动测试。使用 failbreak 别名来附加那些会在测试失败时触发的断点。

• –traits=<traits>：

启用传入的包特性。可以通过逗号分隔的列表指定多个特性，例如 --traits Trait1,Trait2。在启用特定特性时，还需要通过向该命令传递 defaults 来显式启用默认特性。

• –enable-all-traits：

启用包的所有特性。

• –disable-default-traits：

禁用包的所有默认特性。

• –version：

显示版本。

• –help：

显示帮助信息。

swift.test.list

以说明符格式列出测试方法

test list [--package-path=<package-path>] [--cache-path=<cache-path>] [--config-path=<config-path>] [--security-path=<security-path>] [--scratch-path=<scratch-path>]     [--swift-sdks-path=<swift-sdks-path>] [--toolset=<toolset>...] [--pkg-config-path=<pkg-config-path>...]   [--enable-dependency-cache|disable-dependency-cache]  [--enable-build-manifest-caching|disable-build-manifest-caching] [--manifest-cache=<manifest-cache>] [--enable-experimental-prebuilts|disable-experimental-prebuilts] [--verbose] [--very-verbose|vv] [--quiet] [--color-diagnostics|no-color-diagnostics] [--disable-sandbox] [--netrc] [--enable-netrc|disable-netrc] [--netrc-file=<netrc-file>] [--enable-keychain|disable-keychain] [--resolver-fingerprint-checking=<resolver-fingerprint-checking>] [--resolver-signing-entity-checking=<resolver-signing-entity-checking>] [--enable-signature-validation|disable-signature-validation] [--enable-prefetching|disable-prefetching] [--force-resolved-versions|disable-automatic-resolution|only-use-versions-from-resolved-file] [--skip-update] [--disable-scm-to-registry-transformation] [--use-registry-identity-for-scm] [--replace-scm-with-registry]  [--default-registry-url=<default-registry-url>] [--configuration=<configuration>] [--=<Xcc>...] [--=<Xswiftc>...] [--=<Xlinker>...] [--=<Xcxx>...]    [--triple=<triple>] [--sdk=<sdk>] [--toolchain=<toolchain>]   [--swift-sdk=<swift-sdk>] [--sanitize=<sanitize>...] [--auto-index-store|enable-index-store|disable-index-store]   [--enable-parseable-module-interfaces] [--jobs=<jobs>] [--use-integrated-swift-driver] [--explicit-target-dependency-import-check=<explicit-target-dependency-import-check>] [--build-system=<build-system>] [--=<debug-info-format>]      [--enable-dead-strip|disable-dead-strip] [--disable-local-rpath] [--skip-build]  [--enable-xctest|disable-xctest] [--enable-swift-testing|disable-swift-testing]         [--attachments-path=<attachments-path>] [--traits=<traits>] [--enable-all-traits] [--disable-default-traits]  [--version] [--help]

• –package-path=<package-path>：

指定要操作的包路径（默认为当前目录）。这会先切换工作目录，然后再执行其他任何操作。

• –cache-path=<cache-path>：

指定共享缓存目录的路径。

• –config-path=<config-path>：

指定共享配置目录的路径。

• –security-path=<security-path>：

指定共享安全目录的路径。

• –scratch-path=<scratch-path>：

指定自定义的临时构建目录路径。（默认 .build）

• –swift-sdks-path=<swift-sdks-path>：

包含已安装 Swift SDK 的目录路径。

• –toolset=<toolset>：

指定为目标平台构建时使用的工具集 JSON 文件。可以多次使用该选项来指定多个工具集。各个工具集会按指定顺序合并为当前构建的单个最终工具集。

• –pkg-config-path=<pkg-config-path>：

指定搜索 pkg-config .pc 文件的替代路径。可以多次使用该选项来指定多个路径。

• –enable-dependency-cache|disable-dependency-cache：

获取依赖时使用共享缓存。

• –enable-build-manifest-caching|disable-build-manifest-caching：

• –manifest-cache=<manifest-cache>：

Package.swift 清单的缓存模式。有效取值：shared（共享缓存）、local（包的构建目录）、none（禁用）

• –enable-experimental-prebuilts|disable-experimental-prebuilts：

是否对宏使用预编译的 swift-syntax 库。

• –verbose：

提高详细程度，包含信息性输出。

• –very-verbose|vv：

提高详细程度，包含调试输出。

• –quiet：

降低详细程度，只包含错误输出。

• –color-diagnostics|no-color-diagnostics：

在向 TTY 输出时启用或禁用彩色诊断信息。默认情况下，连接到 TTY 时启用彩色诊断，否则禁用。

• –disable-sandbox：

执行子进程时禁用沙箱。

• –netrc：

即使在其他凭据存储更优先的情况下也使用 netrc 文件。

• –enable-netrc|disable-netrc：

从 netrc 文件加载凭据。

• –netrc-file=<netrc-file>：

指定 netrc 文件的路径。

• –enable-keychain|disable-keychain：

在 macOS 钥匙串中查找凭据。

• –resolver-fingerprint-checking=<resolver-fingerprint-checking>：

• –resolver-signing-entity-checking=<resolver-signing-entity-checking>：

• –enable-signature-validation|disable-signature-validation：

验证从注册表下载的已签名包发布的签名。

• –enable-prefetching|disable-prefetching：

• –force-resolved-versions|disable-automatic-resolution|only-use-versions-from-resolved-file：

只使用 Package.resolved 文件中的版本，如果该文件已过期则解析失败。

• –skip-update：

在解析期间跳过从远程更新依赖。

• –disable-scm-to-registry-transformation：

禁用从源代码管理到注册表的转换。

• –use-registry-identity-for-scm：

在注册表中查找源代码管理依赖，并尽可能使用它们的注册表标识，以帮助在两种来源之间去重。

• –replace-scm-with-registry：

在注册表中查找源代码管理依赖，并尽可能改用注册表来获取它们，而不是用源代码管理。

• –default-registry-url=<default-registry-url>：

要使用的默认注册表 URL，用于替代 registries.json 配置文件。

• –configuration=<configuration>：

以指定配置构建

• –=<Xcc>：

把标志传递给所有 C 编译器调用。

• –=<Xswiftc>：

把标志传递给所有 Swift 编译器调用。

• –=<Xlinker>：

把标志传递给所有链接器调用。

• –=<Xcxx>：

把标志传递给所有 C++ 编译器调用。

• –triple=<triple>：

• –sdk=<sdk>：

• –toolchain=<toolchain>：

• –swift-sdk=<swift-sdk>：

筛选构建时要使用的特定 Swift SDK。

• –sanitize=<sanitize>：

打开针对错误行为的运行时检查，可能取值：address、thread、undefined、scudo。

• –auto-index-store|enable-index-store|disable-index-store：

启用或禁用构建期间建立索引的特性。

• –enable-parseable-module-interfaces：

• –jobs=<jobs>：

构建过程中并行启动的任务数量。

• –use-integrated-swift-driver：

• –explicit-target-dependency-import-check=<explicit-target-dependency-import-check>：

一个标志，表明本次构建应检查各个目标是否只导入它们显式声明的依赖。

• –build-system=<build-system>：

• –=<debug-info-format>：

要使用的调试信息格式。

• –enable-dead-strip|disable-dead-strip：

禁用/启用链接器的死代码剥离。

• –disable-local-rpath：

默认不再把 $ORIGIN/@loader_path 加入 rpath。

• –skip-build：

跳过构建测试目标。

• –enable-xctest|disable-xctest：

启用对 XCTest 的支持。

• –enable-swift-testing|disable-swift-testing：

启用对 Swift Testing 的支持。

• –attachments-path=<attachments-path>：

附件应写入的路径（仅 Swift Testing）。该路径必须是当前用户可写的已存在目录。如果未指定，测试期间创建的任何附件都会被丢弃。

• –traits=<traits>：

启用传入的包特性。可以通过逗号分隔的列表指定多个特性，例如 --traits Trait1,Trait2。在启用特定特性时，还需要通过向该命令传递 defaults 来显式启用默认特性。

• –enable-all-traits：

启用包的所有特性。

• –disable-default-traits：

禁用包的所有默认特性。

• –version：

显示版本。

• –help：

显示帮助信息。

swift.test.last

test last [--package-path=<package-path>] [--cache-path=<cache-path>] [--config-path=<config-path>] [--security-path=<security-path>] [--scratch-path=<scratch-path>]     [--swift-sdks-path=<swift-sdks-path>] [--toolset=<toolset>...] [--pkg-config-path=<pkg-config-path>...]   [--enable-dependency-cache|disable-dependency-cache]  [--enable-build-manifest-caching|disable-build-manifest-caching] [--manifest-cache=<manifest-cache>] [--enable-experimental-prebuilts|disable-experimental-prebuilts] [--verbose] [--very-verbose|vv] [--quiet] [--color-diagnostics|no-color-diagnostics] [--disable-sandbox] [--netrc] [--enable-netrc|disable-netrc] [--netrc-file=<netrc-file>] [--enable-keychain|disable-keychain] [--resolver-fingerprint-checking=<resolver-fingerprint-checking>] [--resolver-signing-entity-checking=<resolver-signing-entity-checking>] [--enable-signature-validation|disable-signature-validation] [--enable-prefetching|disable-prefetching] [--force-resolved-versions|disable-automatic-resolution|only-use-versions-from-resolved-file] [--skip-update] [--disable-scm-to-registry-transformation] [--use-registry-identity-for-scm] [--replace-scm-with-registry]  [--default-registry-url=<default-registry-url>] [--configuration=<configuration>] [--=<Xcc>...] [--=<Xswiftc>...] [--=<Xlinker>...] [--=<Xcxx>...]    [--triple=<triple>] [--sdk=<sdk>] [--toolchain=<toolchain>]   [--swift-sdk=<swift-sdk>] [--sanitize=<sanitize>...] [--auto-index-store|enable-index-store|disable-index-store]   [--enable-parseable-module-interfaces] [--jobs=<jobs>] [--use-integrated-swift-driver] [--explicit-target-dependency-import-check=<explicit-target-dependency-import-check>] [--build-system=<build-system>] [--=<debug-info-format>]      [--enable-dead-strip|disable-dead-strip] [--disable-local-rpath] [--version] [--help]

• –package-path=<package-path>：

指定要操作的包路径（默认为当前目录）。这会先切换工作目录，然后再执行其他任何操作。

• –cache-path=<cache-path>：

指定共享缓存目录的路径。

• –config-path=<config-path>：

指定共享配置目录的路径。

• –security-path=<security-path>：

指定共享安全目录的路径。

• –scratch-path=<scratch-path>：

指定自定义的临时构建目录路径。（默认 .build）

• –swift-sdks-path=<swift-sdks-path>：

包含已安装 Swift SDK 的目录路径。

• –toolset=<toolset>：

指定为目标平台构建时使用的工具集 JSON 文件。可以多次使用该选项来指定多个工具集。各个工具集会按指定顺序合并为当前构建的单个最终工具集。

• –pkg-config-path=<pkg-config-path>：

指定搜索 pkg-config .pc 文件的替代路径。可以多次使用该选项来指定多个路径。

• –enable-dependency-cache|disable-dependency-cache：

获取依赖时使用共享缓存。

• –enable-build-manifest-caching|disable-build-manifest-caching：

• –manifest-cache=<manifest-cache>：

Package.swift 清单的缓存模式。有效取值：shared（共享缓存）、local（包的构建目录）、none（禁用）

• –enable-experimental-prebuilts|disable-experimental-prebuilts：

是否对宏使用预编译的 swift-syntax 库。

• –verbose：

提高详细程度，包含信息性输出。

• –very-verbose|vv：

提高详细程度，包含调试输出。

• –quiet：

降低详细程度，只包含错误输出。

• –color-diagnostics|no-color-diagnostics：

在向 TTY 输出时启用或禁用彩色诊断信息。默认情况下，连接到 TTY 时启用彩色诊断，否则禁用。

• –disable-sandbox：

执行子进程时禁用沙箱。

• –netrc：

即使在其他凭据存储更优先的情况下也使用 netrc 文件。

• –enable-netrc|disable-netrc：

从 netrc 文件加载凭据。

• –netrc-file=<netrc-file>：

指定 netrc 文件的路径。

• –enable-keychain|disable-keychain：

在 macOS 钥匙串中查找凭据。

• –resolver-fingerprint-checking=<resolver-fingerprint-checking>：

• –resolver-signing-entity-checking=<resolver-signing-entity-checking>：

• –enable-signature-validation|disable-signature-validation：

验证从注册表下载的已签名包发布的签名。

• –enable-prefetching|disable-prefetching：

• –force-resolved-versions|disable-automatic-resolution|only-use-versions-from-resolved-file：

只使用 Package.resolved 文件中的版本，如果该文件已过期则解析失败。

• –skip-update：

在解析期间跳过从远程更新依赖。

• –disable-scm-to-registry-transformation：

禁用从源代码管理到注册表的转换。

• –use-registry-identity-for-scm：

在注册表中查找源代码管理依赖，并尽可能使用它们的注册表标识，以帮助在两种来源之间去重。

• –replace-scm-with-registry：

在注册表中查找源代码管理依赖，并尽可能改用注册表来获取它们，而不是用源代码管理。

• –default-registry-url=<default-registry-url>：

要使用的默认注册表 URL，用于替代 registries.json 配置文件。

• –configuration=<configuration>：

以指定配置构建

• –=<Xcc>：

把标志传递给所有 C 编译器调用。

• –=<Xswiftc>：

把标志传递给所有 Swift 编译器调用。

• –=<Xlinker>：

把标志传递给所有链接器调用。

• –=<Xcxx>：

把标志传递给所有 C++ 编译器调用。

• –triple=<triple>：

• –sdk=<sdk>：

• –toolchain=<toolchain>：

• –swift-sdk=<swift-sdk>：

筛选构建时要使用的特定 Swift SDK。

• –sanitize=<sanitize>：

打开针对错误行为的运行时检查，可能取值：address、thread、undefined、scudo。

• –auto-index-store|enable-index-store|disable-index-store：

启用或禁用构建期间建立索引的特性。

• –enable-parseable-module-interfaces：

• –jobs=<jobs>：

构建过程中并行启动的任务数量。

• –use-integrated-swift-driver：

• –explicit-target-dependency-import-check=<explicit-target-dependency-import-check>：

一个标志，表明本次构建应检查各个目标是否只导入它们显式声明的依赖。

• –build-system=<build-system>：

• –=<debug-info-format>：

要使用的调试信息格式。

• –enable-dead-strip|disable-dead-strip：

禁用/启用链接器的死代码剥离。

• –disable-local-rpath：

默认不再把 $ORIGIN/@loader_path 加入 rpath。

• –version：

显示版本。

• –help：

显示帮助信息。