# 유닛 테스트

> Enable and configure unit tests in Unity Build Automation to catch issues early and ensure code quality.

**빌드 타겟** 설정에서 유닛 테스트를 활성화하여 문제를 초기에 발견하고 코드 품질을 보장하고 배포 전에 회귀를 방지할 수 있습니다. Unity Build Automation(UBA)은 빌드 프로세스의 일부로 유닛 테스트를 실행하는 연동 지원을 제공합니다. UBA는 테스트 실행을 관리하고 오류를 처리하는 옵션을 제공하는 **편집 모드**와 **플레이 모드** 테스트를 모두 지원합니다.

Unity 에디터 매뉴얼에서 [편집 모드와 플레이 모드 테스트](https://docs.unity3d.com/Packages/com.unity.test-framework@1.0/manual/edit-mode-vs-play-mode-tests.html)에 대한 자세한 내용을 참고하십시오.

## 유닛 테스트 활성화##enable-unit-tests

[Unity Dashboard](https://cloud.unity.com/home/organizations/default/projects/default/cloud-build/config)에서 유닛 테스트를 활성화하고 설정합니다.

1. **Build Automation** > **Configurations**를 선택합니다.
2. 편집(연필 모양) 아이콘을 선택하여 빌드 타겟 설정을 엽니다.
3. **Advanced Settings**를 선택합니다.
4. **Tests** 섹션에서 활성화할 [테스트 옵션](#test-configuration-options)을 선택합니다.
5. **Save changes**를 선택합니다.

테스트를 활성화할 때 문제가 발생하면 프로젝트의 테스트 어셈블리를 올바르게 설정하고 스크립트를 적절한 디렉토리(예: `Assets/Tests`)에 배치했는지 확인합니다. Unity 에디터의 **테스트 러너**를 사용하여 UBA에서 빌드를 실행하기 전에 테스트가 감지되었는지 확인합니다.

### 테스트 구성 옵션##test-configuration-options

다음 테스트 옵션을 사용할 수 있습니다.

| 테스트 구성 옵션                | 설명                                                  |
| ------------------------ | --------------------------------------------------- |
| **빌드 시 프로젝트의 유닛 테스트 실행** | 빌드를 실행할 때 유닛 테스트를 실행합니다.                            |
| **EditMode 테스트 실행**      | 빌드를 실행할 때 편집 모드 테스트를 실행합니다.                         |
| **PlayMode 테스트 실행**      | 빌드를 실행할 때 플레이 모드 테스트를 실행합니다.                        |
| **테스트 실패 시 빌드를 실패로 표시**  | UBA는 빌드가 완료되었더라도 유닛 테스트 제품군에서 실패한 모든 빌드를 실패로 표시합니다. |

## 테스트 결과에 액세스 및 검토##access-and-review-test-results

UBA는 빌드 로그와 아티팩트의 테스트 결과를 제공합니다. 빌드 완료 후 다음 단계를 따릅니다.

1. Unity Dashboard의 [**Build History**](https://cloud.unity.com/home/organizations/default/projects/default/cloud-build/history) 섹션으로 이동합니다.
2. 완료된 빌드를 선택하여 세부 정보를 확인합니다.
3. 테스트 요약을 검토하여 완료된 테스트 수, 실패한 테스트 수, 건너뛴 테스트 수를 확인합니다.
4. 자세한 테스트 리포트를 다운로드해 심층 분석합니다.


**UBA 유닛 테스트 보기:**
![UBA 유닛 테스트 보기](/api/media?file=/build-automation/media/images/build-automation/build-history-tests.png "UBA 유닛 테스트 보기")

결과가 누락되거나 불완전한 경우 다음 해결 방법을 확인합니다.

* 테스트 실행과 관련된 경고나 오류는 [**빌드 로그**](../check-build-results/overview#view-logs)를 확인합니다.
* 테스트를 알고 있는 테스트 폴더에 적절하게 위치를 지정하고 태그를 지정했는지 확인합니다.

> **Note:**
>
> **참고:** 테스트가 예기치 않게 실패하면 최근 코드 변경 사항을 검토하고 모든 종속성(예: 씬이나 에셋)을 올바르게 설정했는지 확인합니다.