로컬 디바이스에서 녹화 및 테스트 실행을 위한 설정 절차 (Android)

로컬 디바이스 설정 방법

0. 준비물 (Korean / 한국어)

1. Android Studio 설치 및 초기 설정 (약 1시간)

Android 디바이스를 사용하려면 Android Studio와 Android SDK가 필요합니다.

Android Studio 설치

여기에서 Android Studio를 다운로드해 설치하세요.

SDK 설치

Android Studio를 실행하면 Android SDK 설치 대화상자가 나타납니다.
Standard 옵션을 선택해 SDK를 설치하세요.

디바이스에서 USB 디버깅 활성화 (약 15분)

테스트를 실행하려면 디바이스에서 USB 디버깅을 켜야 합니다.

##### USB 디버깅 활성화

아래 가이드를 참고해 디바이스에서 USB 디버깅을 켜세요.
https://developer.android.com/studio/debug/dev-options?hl=ja

##### 디바이스와 PC 연결

USB 디버깅을 켠 상태에서 디바이스를 PC에 연결하면 “USB 디버깅을 허용하시겠습니까?” 대화상자가 표시됩니다. 허용을 선택하세요.

연결 모드를 파일 전송(MTP) 또는 PTP로 변경합니다.

2. Autify CLI 설치 (약 15분)

디바이스를 NoCode Mobile과 연결하는 데 필요한 애플리케이션을 설치합니다.

Mac의 경우

##### Homebrew 설치

Autify CLI는 Homebrew로 설치합니다.
Homebrew가 없다면 터미널을 열고 https://brew.sh/ 페이지의 Install Homebrew 명령어를 실행하세요.

##### PATH 설정

Homebrew 설치 후 다음 명령어로 PATH를 설정합니다(경로는 PC마다 다를 수 있음).

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/$USER/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Autify CLI 설치

Homebrew를 사용하여 Autify CLI를 설치합니다. 터미널에서 다음 명령어를 실행하세요.

brew install autifyhq/tap/autify-cli

설치 중 오류가 발생하면 지원팀에 문의해 주세요.

명령이 완료되면 다음 명령어로 Autify CLI가 올바르게 설치되었는지 확인합니다.

autify help

정상적으로 설치되면 Autify Command Line Interface (CLI) 메시지와 버전, 사용 가능한 명령어 목록이 표시됩니다.

command not found 오류가 표시되면 PATH 변수가 설정되지 않았을 수 있습니다. PATH 설정을 확인하세요.

Windows의 경우

다음 페이지에서 Autify CLI를 다운로드하여 설치하세요.
https://help.autify.com/docs/ja/autify-command-line-interface#native-installer

설치 및 PATH 설정 후 다음 명령어로 Autify CLI가 정상적으로 동작하는지 확인합니다.

autify help

정상적으로 설치되면 Autify Command Line Interface (CLI) 메시지와 버전, 사용 가능한 명령어 목록이 표시됩니다.

3. NoCode Mobile에서 Personal Access Token 생성 (≈ 5 분)

설정 페이지(https://mobile-app.autify.com/settings/token)에서 Personal Access Token을 생성해 안전하게 보관하세요. 이후 단계에서 사용됩니다.

4. 디바이스 연결 준비 (≈ 15 분)

모바일 디바이스 연결 설정

먼저 이전 단계에서 생성한 Personal Access Token을 Autify CLI에 등록합니다. 터미널(Windows의 경우 Command Prompt / PowerShell)에서 아래 명령어를 실행하여 퍼스널 액세스 토큰을 설정해주세요.

autify mobile auth login

그다음 모바일 디바이스를 NoCode Mobile에 연결하기 위한 구성 요소를 설치하고 정보를 입력합니다.

autify mobile link setup

화면 안내에 따라 설정을 완료하세요.

• Workspace ID 입력
  • http://mobile-app.autify.com/에 로그인하면 URL이 https://mobile-app.autify.com/projects/XXXXXXX?by=test_plan 형식으로 바뀝니다.
  • XXXXXXX 부분이 Workspace ID입니다.
• 로그 전송 동의
  • Yes를 입력하면 녹화·테스트 실행 로그가 NoCode Mobile로 전송되어 지원 속도가 빨라집니다.

5. 연결 확인

터미널(Windows의 경우 Command Prompt / PowerShell)에서 아래 명령어를 실행하면 NoCode Mobile과 디바이스가 연결됩니다

autify mobile link start

명령 실행 후 NoCode Mobile에서 새 시나리오 만들기 화면을 열고 모달 하단의 Local Device 드롭다운을 선택하면 디바이스 이름이 표시됩니다.

로컬 디바이스로 녹화 및 테스트 실행

사전 조건

• USB 연결이 정상이고 디바이스 잠금이 해제되어 있어야 합니다.
• 장시간 사용할 경우 디바이스의 설정 ▸ 디스플레이 및 밝기에서 자동 잠금을 없음으로 설정하면 편리합니다.

녹화

연결 확인 후 표시된 디바이스를 선택해 녹화를 시작합니다.
준비 과정에서 오류가 발생하면 빌드 설치 가능 여부를 개발자에게 확인하고, 해결되지 않으면 지원팀에 문의하세요.

테스트 실행

클라우드 디바이스와 마찬가지로 시나리오 상세 화면의 Run Now 버튼이나 테스트 플랜에서 로컬 디바이스를 대상으로 테스트를 실행할 수 있습니다.

Troubleshooting

이 문서를 참조하세요.