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

# Device Farm 시작하기
<a name="getting-started"></a>

Device Farm을 사용하여 기본 Android 또는 iOS 앱을 테스트하는 방법을 자세히 알아보세요. Device Farm 콘솔을 사용하여 프로젝트를 만들고, .apk 또는 .ipa 파일을 업로드하고, 표준 테스트 스위트를 실행한 다음 결과를 확인합니다.

**참고**  
Device Farm은(`us-west-2`오레곤) AWS 리전에서만 사용할 수 있습니다.

**Topics**
+ [사전 조건](#getting-started-prepare)
+ [1단계: 콘솔에 로그인](#getting-started-console)
+ [2단계: 프로젝트 생성](#getting-started-create-project)
+ [3단계: 실행 만들고 시작하기](#getting-started-create-run)
+ [4단계: 실행 결과 보기](#getting-started-view-run-results)
+ [다음 단계](#getting-started-next-steps)

## 사전 조건
<a name="getting-started-prepare"></a>

시작하기 전에 먼저 다음 요구 사항을 완료해야 합니다.
+ [설정](setting-up.md)의 단계를 수행하세요. Device Farm에 액세스할 수 있는 권한이 있는 AWS 계정과 AWS Identity and Access Management (IAM) 사용자가 필요합니다.
+ Android의 경우 .apk(Android 앱 패키지) 파일을 가져오거나 제공하는 샘플 애플리케이션을 사용할 수 있습니다. iOS의 경우 .ipa(iOS 앱 아카이브) 파일이 필요합니다. 이 연습의 뒷부분에서 파일을 Device Farm에 업로드하세요.
**참고**  
.ipa 파일은 시뮬레이터가 아닌 iOS 디바이스용으로 빌드되어야 합니다.
+ (선택 사항) Device Farm이 지원하는 테스트 프레임워크 중 하나의 테스트가 필요합니다. 이 테스트 패키지를 Device Farm에 업로드한 다음, 이 연습의 뒷부분에 테스트를 실행합니다. 사용할 테스트 패키지가 없는 경우 표준 기본 제공 테스트 제품군을 지정하고 실행할 수 있습니다. 자세한 내용은 [AWS Device Farm의 테스트 프레임워크 및 내장 테스트](test-types.md) 단원을 참조하세요.

## 1단계: 콘솔에 로그인
<a name="getting-started-console"></a>

Device Farm 콘솔을 사용하여 테스트용 프로젝트와 실행을 만들고 관리할 수 있습니다. 이 연습의 뒷부분에 프로젝트와 실행을 학습합니다.
+ [https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm)에서 Device Farm 콘솔에 로그인하세요.

## 2단계: 프로젝트 생성
<a name="getting-started-create-project"></a>

Device Farm에서 앱을 테스트하려면 먼저 프로젝트를 만들어야 합니다.

1. 탐색 창에서 **모바일 디바이스 테스트**를 선택하고 **프로젝트**를 선택하세요.

1. **모바일 디바이스 테스트 프로젝트**에서 **프로젝트 생성**을 선택하세요.

1. **프로젝트 만들기**에서 **프로젝트 이름**(예: **MyDemoProject**)을 입력하세요.

1. **생성**을 선택하세요.

   콘솔은 새로 만든 프로젝트의 **자동 테스트** 페이지를 엽니다.

## 3단계: 실행 만들고 시작하기
<a name="getting-started-create-run"></a>

이제 프로젝트가 있으므로 실행을 만들어 시작할 수 있습니다. 자세한 내용은 [실행](test-runs.md) 단원을 참조하십시오.

1. **자동 테스트** 페이지에서 **실행 생성**을 선택하세요. 또는 **자습서를 사용하여 실행 생성**을 선택하여 콘솔 내 자습서를 따를 수 있습니다.

1. (선택 사항) **실행 설정**의 **실행 이름** 섹션에 실행 이름을 입력합니다. 이름이 입력되지 않으면 Device Farm 콘솔은 기본적으로 실행된 'My Device Farm run'의 이름을 지정합니다.

1. **실행 설정**의 **실행 유형** 섹션에서 실행 유형을 선택합니다. 테스트할 앱이 없거나 Android(.apk) 앱을 테스트하는 경우 **Android 앱**을 선택합니다. iOS(.ipa) 앱을 테스트하는 경우 **iOS 앱**을 선택합니다.

1. **앱 선택**의 **앱 선택 옵션** 섹션에서 테스트할 수 있는 앱이 없는 경우 **Device Farm에서 제공하는 샘플 앱 선택**을 선택합니다. 자체 앱을 가져오는 경우 **자체 앱 업로드**를 선택하고 애플리케이션 파일을 선택합니다. iOS 앱을 업로드하는 경우 시뮬레이터와 달리 **iOS 디바이스**를 선택해야 합니다.

1. **구성 테스트** 페이지의 **테스트 프레임워크 선택** 섹션에서 테스트 프레임워크 또는 내장 테스트 제품군 중 하나를 선택하세요. 각 옵션에 대한 자세한 내용은 [AWS Device Farm의 테스트 프레임워크 및 내장 테스트](test-types.md) 섹션을 참조하세요.
   + 아직 Device Farm용으로 테스트를 패키징하지 않은 경우 **내장: Fuzz**를 선택하여 기본 제공 테스트 스위트를 실행하십시오. **이벤트 수**, **이벤트 스로틀** 및 **Randomizer 시드**의 기본값을 유지할 수 있습니다. 자세한 내용은 [Device Farm의 내장 fuzz 테스트 실행(Android 및 iOS)](test-types-built-in-fuzz.md) 단원을 참조하세요.
   + 지원되는 테스트 프레임워크 중 하나의 테스트 패키지가 있는 경우 해당 테스트 프레임워크를 선택한 다음 테스트가 포함된 파일을 업로드하십시오.

1. **디바이스 선택**에서 **디바이스 풀 사용** 및 **상위 디바이스**를 선택합니다. 

1. (선택 사항) 구성을 추가하려면 **추가 구성** 드롭다운을 엽니다. 이 섹션에서는 다음 작업을 수행합니다.
   + 실행 중에 Device Farm이 사용할 다른 데이터를 입력하려면 **데이터 추가** 옆의 **파일 선택** 클릭 후, 해당 데이터가 포함된 .zip 파일을 찾아 선택하세요.
   + 실행 중 Device Farm에 사용할 추가 앱을 설치하려면 **다른 앱 설치** 옆의 **파일 선택** 클릭 후 해당 앱이 들어 있는 .apk 또는 .ipa 파일을 찾아 선택하세요. 설치할 다른 앱에 대해서도 이 절차를 반복하세요. 앱을 업로드한 후 끌어서 놓는 방법으로 설치 순서를 변경할 수 있습니다.
   + 실행 중에 Wi-Fi, Bluetooth, GPS 또는 NFC 활성화 여부를 지정하려면 **무선 상태 설정** 옆의 알맞은 확인란을 선택하세요.
   + 실행을 위해 디바이스 위도 및 경도를 미리 설정하려면 **디바이스 위치** 옆에 좌표를 입력합니다.
   + 실행을 위해 디바이스 로캘을 미리 설정하려면 **디바이스 로캘**에서 로캘을 선택하세요.
   + 테스트 실행 중에 동영상 녹화하려면 **동영상 녹화 활성화**를 선택하세요.
   + 디바이스에서 성능 데이터 캡처하려면 **앱 성능 데이터 캡처 활성화**를 선택하세요.
**참고**  
디바이스 무선 상태 및 로캘 설정은 현재 Android 기본 테스트에만 사용 가능한 옵션입니다.
**참고**  
프라이빗 디바이스가 있는 경우 프라이빗 디바이스 구성도 표시됩니다.

1. 페이지 하단에서 **실행 생성**을 선택하여 실행을 예약합니다.

디바이스를 사용할 수 있게 되면 일반적으로 몇 분 이내에 Device Farm이 실행을 시작합니다. 실행 상태를 보려면 프로젝트의 **자동 테스트** 페이지에서 실행 이름을 선택하세요. 실행 페이지의 **디바이스** 아래에 있는 각 디바이스는 디바이스 테이블의 보류 중 아이콘 ![\[Device Farm scheduled a job.\]](http://docs.aws.amazon.com/ko_kr/devicefarm/latest/developerguide/images/df-run-calendar.png)로 시작하다가 테스트가 시작되면 실행 중 아이콘 ![\[Device Farm progress indicator.\]](http://docs.aws.amazon.com/ko_kr/devicefarm/latest/developerguide/images/df-run-progress.png)으로 전환됩니다. 각 테스트가 완료되면 콘솔에 디바이스 이름 옆에 테스트 결과 아이콘이 표시됩니다. 모든 테스트가 완료되면 실행 옆에 있는 보류 중 아이콘이 테스트 결과 아이콘으로 바뀝니다.

## 4단계: 실행 결과 보기
<a name="getting-started-view-run-results"></a>

실행의 테스트 결과를 보려면 프로젝트의 **자동 테스트** 페이지에서 실행 이름을 선택하세요. 요약 페이지에 다음이 표시됩니다.
+ 결과별 총 테스트 수
+ 고유한 경고가 있거나 실패한 테스트 목록
+ 각각에 대한 디바이스 및 테스트 결과 목록
+ 디바이스별로 그룹화한 실행 중 캡처한 스크린샷
+ 파싱 결과를 다운로드할 수 있는 단원

자세한 내용은 [Device Farm에서 테스트 보고서 보기](how-to-use-reports.md) 단원을 참조하세요.

## 다음 단계
<a name="getting-started-next-steps"></a>

Device Farm에 관한 자세한 내용은 [개념](concepts.md) 단원을 참조하세요.