Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 與 universal-test-runner 整合
<a name="test.universal-test-runner"></a>

測試動作與開放原始碼命令列工具 整合`universal-test-runner`。 `universal-test-runner`使用[測試執行通訊協定](https://github.com/aws/universal-test-runner/blob/main/protocol/README.md)，針對指定架構中的任何語言執行測試。 `universal-test-runner`支援下列架構：
+ [Gradle](https://gradle.org/)
+ [Jest](https://jestjs.io/)
+ [Maven](https://maven.apache.org/)
+ [pytest](https://pytest.org)
+ [.NET](https://learn.microsoft.com/en-us/dotnet/core/tools/)

`universal-test-runner` 只會安裝在針對測試動作策劃的映像上。如果您要設定一個會使用自訂 Docker Hub 或 Amazon ECR 的測試動作，則您必須手動安裝 `universal-test-runner`，才能啟用進階的測試功能。若要這樣做，請在映像上安裝 Node.js (14 或更高版本)，接著透過 `npm` 使用 shell 命令 `- Run: npm install -g @aws/universal-test-runner` 安裝 `universal-test-runner`。如需透過 shell 命令在容器中安裝 Node.js 的詳細資訊，請參閱[安裝和更新 Node Version Manager](https://github.com/nvm-sh/nvm#install--update-script)。

如需 的詳細資訊`universal-test-runner`，請參閱[什麼是 universal-test-runner？](https://github.com/aws/universal-test-runner#-what-is-universal-test-runner)

------
#### [ Visual ]

**在視覺化編輯器中使用 universal-test-runner**

1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

1. 在導覽窗格中，選擇 **CI/CD**，然後選擇**工作流程**。

1. 選擇工作流程的名稱。

1. 選擇**編輯**。

1. 選擇**視覺化**。

1. 選擇**動作**。

1. 在**動作**中，選擇**測試**。

1. 在**組態**索引標籤上，使用您選擇的支援架構更新範例程式碼，以完成 **Shell 命令**欄位。例如，若要使用支援的架構，您可以使用類似以下的`Run`命令。

   ```
   - Run: run-tests <framework>
   ```

   如果不支援您想要的架構，請考慮提供自訂的轉接器或執行器。如需 **Shell 命令**欄位的說明，請參閱 [Steps](build-action-ref.md#build.configuration.steps)。

1. （選用） 選擇**驗證**以在遞交之前驗證工作流程的 YAML 程式碼。

1. 選擇**遞交**，輸入遞交訊息，然後再次選擇**遞交**。

------
#### [ YAML ]

**在 YAML 編輯器中使用 universal-test-runner**

1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

1. 在導覽窗格中，選擇 **CI/CD**，然後選擇**工作流程**。

1. 選擇工作流程的名稱。

1. 選擇**編輯**。

1. 選擇 **YAML**。

1. 選擇**動作**。

1. 在**動作**中，選擇**測試**。

1. 根據您的需求修改 YAML 程式碼。例如，若要使用支援的架構，您可以使用類似以下的`Run`命令。

   ```
   Configuration:
     Steps:
       - Run: run-tests <framework>
   ```

   如果不支援您想要的架構，請考慮提供自訂的轉接器或執行器。如需 **Steps** 屬性的說明，請參閱 [Steps](build-action-ref.md#build.configuration.steps)。

1. （選用） 選擇**驗證**以在遞交之前驗證工作流程的 YAML 程式碼。

1. 選擇**遞交**，輸入遞交訊息，然後再次選擇**遞交**。

------