XCTest 실행

이 가이드에서는 Firebase Test Lab에서 테스트할 XCTest를 준비하는 방법을 설명합니다.

1단계: 프로젝트의 파생 데이터 위치 구성

Xcode는 컴파일된 iOS 아티팩트(빌드한 모든 테스트 포함)를 파생 데이터 디렉터리에 저장합니다. 원하는 경우 이 디렉터리의 기본 위치를 유지할 수 있지만 특히 Test Lab을 사용하여 테스트를 자주 실행하려는 경우 파일에 보다 쉽게 액세스할 수 있는 위치를 선택하는 것이 도움이 됩니다.

Xcode에서 프로젝트를 엽니다.
macOS 메뉴 바에서 파일 > 프로젝트 설정...을 선택합니다.
파생 데이터 드롭다운을 기본 위치에서 사용자 지정 위치로 변경합니다.
드롭다운 아래의 필드에서 테스트를 출력할 Xcode 위치를 선택합니다.

2단계: 일반 테스트 파일 빌드

Test Lab은 XCTest 프레임워크를 사용하여 단위 테스트 및 UI 테스트를 실행합니다. Test Lab 기기에서 앱의 XCTest를 실행하려면 일반 iOS 기기에서 테스트할 수 있도록 앱을 빌드합니다.

Xcode 작업공간 창 상단에 있는 기기 드롭다운에서 일반 iOS 기기를 선택합니다.
macOS 메뉴 바에서 제품 > 빌드 대상 > 테스트를 선택합니다.

3단계: 업로드할 앱 패키징

마지막으로, Test Lab에 업로드할 테스트를 빌드하고 빌드한 테스트 파일을 .zip 파일로 압축하여 패키징합니다.

XCTest를 빌드하려면 터미널에서 다음 명령어를 사용합니다.

프로젝트

xcodebuild -project PATH/TO/YOUR_WORKSPACE.xcodeproj \
-scheme YOUR_SCHEME \
-derivedDataPath FOLDER_WITH_TEST_OUTPUT \
-sdk iphoneos build-for-testing

작업공간

xcodebuild -workspace PATH/TO/YOUR_WORKSPACE.xcworkspace \
-scheme YOUR_SCHEME \
-derivedDataPath FOLDER_WITH_TEST_OUTPUT \
-sdk iphoneos build-for-testing

테스트가 성공적으로 빌드되면 압축하여 Test Lab에 업로드합니다.

cd FOLDER_WITH_TEST_OUTPUT/Build/Products : \
zip -r MyTests.zip Debug-iphoneos   YOUR_SCHEME_iphoneosDEPLOYMENT_TARGET-arm64.xctestrun

테스트 파일을 수동으로 압축하여 테스트를 패키징할 수도 있습니다.

Finder를 열고 파생 데이터 출력을 위해 지정한 디렉터리로 이동합니다.
프로젝트에 선택한 폴더를 열고 그 안에 있는 Build/Products 폴더를 엽니다.
Debug-iphoneos 및 PROJECT_NAME_iphoneosDEVELOPMENT_TARGET-arm64.xctestrun 폴더를 선택한 후 압축합니다.

4단계: (선택사항) 로컬에서 테스트 실행

Test Lab으로 테스트를 실행하기 전에 다음과 같이 USB 연결 기기로 로컬에서 테스트를 실행하여 동작의 품질을 검사할 수 있습니다.

xcodebuild test-without-building \
    -xctestrun "Derived Data/Build/Products/YourApp.xctestrun" \
    -destination id=your-phone-id

다음 단계

Firebase Console 또는 gcloud CLI에서 테스트를 업로드하고 실행합니다.