기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

iOS용 XCTest UI를 Device Farm과 통합

Device Farm은 XCTest UI 테스트 프레임워크를 지원합니다. 특히, Device Farm은 Objective-C와 Swift로 작성된 XCTest UI 테스트를 지원합니다.

XCTest UI 프레임워크는 XCTest를 기반으로 구축된 iOS 개발에서 UI 테스트를 지원합니다. 자세한 내용은 iOS 개발자 라이브러리의 사용자 인터페이스 테스트를 참조하세요.

Device Farm의 테스트에 대한 일반적인 정보는 AWS Device Farm의 테스트 프레임워크 및 내장 테스트 섹션을 참조하세요.

다음 지침에 따라 Device Farm을 iOS용 XCTest UI 테스트 프레임워크와 통합합니다.

iOS XCTest UI 테스트 준비

.ipa XCTEST_UI 테스트 패키지에 대한 파일 또는 .zip 파일을 업로드할 수 있습니다.

.ipa 파일은 iOS Runner 앱을 번들 형식으로 포함하는 애플리케이션 아카이브입니다. 추가 파일은 .ipa 파일에 포함될 수 없습니다.

.zip 파일을 업로드하는 경우 iOS Runner 앱 또는 .ipa 파일을 직접 포함할 수 있습니다. 테스트 중에 사용하려는 경우 파일 내에 다른 .zip 파일을 포함할 수도 있습니다. 예를 들어 .zip 파일 내의 .xctestrun, .xcworkspace 또는 .xcodeproj 같은 파일을 포함하여 Device Farm에서 XCUI 테스트 계획을 실행할 수 있습니다. 테스트 계획을 실행하는 방법에 대한 자세한 지침은 XCUI 테스트 유형의 기본 테스트 사양 파일에서 확인할 수 있습니다.

옵션 1: XCTest UI .ipa 패키지 생성

yourAppNameUITest-Runner.app 번들은 테스트용 프로젝트를 빌드할 때 Xcode에서 생성합니다. 프로젝트의 제품 디렉터리에서 찾을 수 있습니다.

.ipa 파일을 생성하는 방법:

다음 폴더 구조는 my-project-nameUITest-Runner.app이라는 예제 앱을 .ipa 파일로 패키징하는 방법을 보여줍니다.

.
└── my-project-nameUITest.ipa
    └── Payload (directory)
        └── my-project-nameUITest-Runner.app 

옵션 2: XCTest UI .zip 패키지 생성

Device Farm은 전체 XCTest UI 테스트 제품군을 실행하기 위한 .xctestrun 파일을 자동으로 생성합니다. Device Farm에서 자체 .xctestrun 파일을 사용하려면 .xctestrun 파일과 앱 디렉터리를 .zip 파일로 압축하면 됩니다. 테스트 패키지에 대한 .ipa 파일이 이미 있는 경우 *-Runner.app 대신 여기에 포함할 수 있습니다.

.
└── swift-sample-UI.zip (directory)
   ├── my-project-nameUITest-Runner.app [OR] my-project-nameUITest.ipa
   ├── SampleTestPlan_2.xctestrun
   ├── SampleTestPlan_1.xctestrun
   └── (any other files)

Device Farm에서 XCUI 테스트에 대한 Xcode 테스트 계획을 실행하려면 my-project-nameUITest-Runner.app 또는 my-project-nameUITest.ipa 파일과 테스트 계획으로 XCTEST_UI를 실행하는 데 필요한 xcode 소스 코드 파일(.xcworkspace 또는 .xcodeproj 파일 포함)이 포함된 zip을 생성할 수 있습니다.

다음은 .xcodeproj 파일을 사용하는 샘플 zip입니다.

.
└── swift-sample-UI.zip (directory)
   ├── my-project-nameUITest-Runner.app [OR] my-project-nameUITest.ipa
   ├── (any directory)
   └── SampleXcodeProject.xcodeproj
        ├── Testplan_1.xctestplan
        ├── Testplan_2.xctestplan
        └── (any other source code files created by xcode with .xcodeproj)
	

다음은 .xcworkspace 파일을 사용하는 샘플 zip입니다.

.
└──swift-sample-UI.zip (directory)
   ├── my-project-nameUITest-Runner.app [OR] my-project-nameUITest.ipa
   └── (any directory)
   │   ├── SampleXcodeProject.xcodeproj
   │   ├── Testplan_1.xctestplan
   │   ├── Testplan_2.xctestplan
   |   └── (any other source code files created by xcode with .xcodeproj)
   └── SampleWorkspace.xcworkspace
       └── contents.xcworkspacedata
  

iOS XCTest UI 테스트 실행(콘솔)

Device Farm 콘솔을 사용하여 테스트를 업로드하세요.

테스트 보고서 보기(콘솔)

테스트 인사이트가 활성화된 경우

작업 결과에는 테스트 보고서 탭이 포함됩니다. 이를 선택하면 총 테스트 수, 통과 및 실패한 테스트 수, 총 테스트 실행 시간, 테스트 실행 시간 중앙값을 포함한 테스트 결과 요약을 볼 수 있습니다. 요약 아래에 테스트 테이블에는 테스트별 분류가 표시됩니다.

테스트 테이블의 각 행에는 다음 열이 포함됩니다.

이름, 클래스 또는 상태별로 테스트를 검색할 수 있습니다. 표시되는 열을 선택하려면 설정 아이콘을 선택합니다. 설정에서 표시할 열을 선택하고 클래스별 그룹화를 켜거나 끌 수 있습니다. 클래스별 그룹화는 기본적으로 켜지며, 테스트 클래스별로 테스트를 그룹화합니다. 다음 스크린샷과 같이 클래스를 확장하여 개별 테스트를 확인합니다.

전체 테스트 보고서를 JSON 파일로 다운로드하려면 작업 세부 정보 상단에서 전체 요약 다운로드를 선택합니다.

테스트 인사이트가 활성화되지 않은 경우

작업 결과에는 스위트, 로그 및 스크린샷 탭과 같은 표준 테스트 출력 및 아티팩트가 표시되지만 테스트 보고서 탭은 표시되지 않습니다. 테스트 보고서를 생성하려면 테스트 인사이트가 활성화된 새 실행을 예약합니다.

테스트 보고서 보기(AWS CLI)

를 실행get-job하고 작업 ARN을 지정합니다.

aws devicefarm get-job --arn arn:aws:devicefarm:us-west-2:123456789012:job:PROJECT_ID/RUN_ID/00000

테스트 인사이트가 활성화되지 않은 경우

테스트 인사이트를 활성화하지 않은 경우 응답에는 작업 상태, 결과, 카운터 및 디바이스와 같은 표준 작업 필드가 포함됩니다.

{
    "job": {
        "arn": "arn:aws:devicefarm:us-west-2:123456789012:job:EXAMPLE-PROJECT/EXAMPLE-RUN/00000",
        "name": "Example Apple iPhone",
        "created": "2026-08-05T14:26:56.959000-07:00",
        "status": "COMPLETED",
        "result": "PASSED",
        "counters": {
            "total": 3,
            "passed": 3,
            "failed": 0,
            "warned": 0,
            "errored": 0,
            "stopped": 0,
            "skipped": 0
        },
        "message": "Successful test lifecycle of Setup Test",
        "device": {
            "arn": "arn:aws:devicefarm:us-west-2::device:EXAMPLEDEVICEID",
            "name": "Example Apple iPhone",
            "platform": "IOS",
            "os": "18",
            "formFactor": "PHONE",
            "fleetType": "PUBLIC"
        },
        "deviceMinutes": {
            "total": 1.38,
            "metered": 0.0,
            "unmetered": 1.13
        },
        "videoCapture": true
    }
}

테스트 인사이트가 활성화된 경우

테스트 인사이트를 활성화한 경우 응답에는 테스트 보고서 상태, 상위 수준 지표 및 세부 보고서에 대한 미리 서명된 URL이 포함된 insights 객체도 포함됩니다.

{
    "job": {
        "arn": "arn:aws:devicefarm:us-west-2:123456789012:job:EXAMPLE-PROJECT/EXAMPLE-RUN/00000",
        "status": "COMPLETED",
        "result": "PASSED",
        "counters": { ... },
        "device": { ... },
        "deviceMinutes": { ... },
        "videoCapture": true,
        "insights": {
            "status": "COMPLETED",
            "testReport": {
                "message": "Results: 2 Executed | 2 passed, Median test duration: 3.214 seconds.",
                "metrics": {
                    "testsTotal": 2,
                    "testsPassed": 2,
                    "testsFailed": 0,
                    "testsSkipped": 0,
                    "testsErrored": 0,
                    "testsOther": 0,
                    "testsPassedPercentage": 100.0
                },
                "testDetailsUrl": "https://EXAMPLE-PRESIGNED-URL"
            }
        }
    }
}

testDetailsUrl 필드는 전체 테스트 보고서 JSON에 대한 미리 서명된 URL입니다. 다운로드하여 테스트별 분석을 가져옵니다.

curl -o test-report.json "PRESIGNED_URL"

다음은 XCTest UI 작업에 대한 테스트 보고서의 예입니다.

{
  "version": "1.0",
  "jobArn": "arn:aws:devicefarm:us-west-2:123456789012:job:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE/a1b2c3d4-e5f6-4a7b-8c9d-67890EXAMPLE/00000",
  "deviceName": "Apple iPhone 15",
  "deviceArn": "arn:aws:devicefarm:us-west-2::device:A1B2C3D4E5F60718293A4B5C6D7E8F90",
  "deviceOsVersion": "17.5",
  "metrics": {
    "testsTotal": 3,
    "testsPassed": 2,
    "testsFailed": 1,
    "testsSkipped": 0,
    "testsErrored": 0,
    "testsOther": 0,
    "testsPassedPercentage": 66.67,
    "totalTestExecutionDurationSeconds": 6.914,
    "medianTestExecutionDurationSeconds": 2.062
  },
  "testDetails": [
    {
      "testName": "test_execute()",
      "testClass": "AlertsTest",
      "frameworkResult": "Passed",
      "result": "PASSED",
      "durationSeconds": 2.062,
      "startTimestamp": "2026-07-31T16:58:26.646000Z",
      "endTimestamp": "2026-07-31T16:58:28.708000Z",
      "testBundle": "AWSDeviceFarmiOSReferenceAppSwiftUITests",
      "nodeIdentifier": "AlertsTest/test_execute()"
    },
    {
      "testName": "test_login()",
      "testClass": "LoginTest",
      "frameworkResult": "Failed",
      "result": "FAILED",
      "durationSeconds": 3.541,
      "startTimestamp": "2026-07-31T16:58:29.000000Z",
      "endTimestamp": "2026-07-31T16:58:32.541000Z",
      "stackTrace": "LoginTest.swift:88: XCTAssertEqual failed: (\"Welcome\") is not equal to (\"Error\")\nLoginTest.swift:91: XCTAssertTrue failed",
      "testBundle": "AWSDeviceFarmiOSReferenceAppSwiftUITests",
      "nodeIdentifier": "LoginTest/test_login()"
    },
    {
      "testName": "test_themeRendering()",
      "testClass": "ThemeTest",
      "frameworkResult": "Passed",
      "result": "PASSED",
      "durationSeconds": 1.311,
      "testBundle": "AWSDeviceFarmiOSReferenceAppSwiftUITests",
      "nodeIdentifier": "ThemeTest/test_themeRendering()",
      "testArguments": "Dark Appearance, Portrait"
    }
  ]
}

보고서에는 다음과 같은 최상위 필드가 포함되어 있습니다.

의 각 항목에testDetails는 다음 필드가 포함됩니다.