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

로컬 디바이스 설정 가이드

0. 준비물

Ad-hoc 버전의 빌드 파일을 이용하실 경우, 사용 예정인 로컬 실디바이스의 UDID를 사전에 빌드 파일 내에 지정해 두어야 합니다.

1. Xcode 설치 및 초기 설정 (≈ 1시간)

Xcode와 iOS SDK 설치

Xcode가 설치되어 있지 않거나 최신 버전이 아니라면 App Store에서 최신 버전을 다운로드하세요.

iOS SDK도 설치되어 있어야 합니다.
Xcode ▸ Settings ▸ Components에서 SDK 설치 여부를 확인합니다.

Xcode와 iOS SDK는 용량이 크므로 최초 다운로드에 약 1시간이 소요될 수 있습니다.

Apple ID로 로그인

다음으로 Xcode에서 Apple ID로 로그인합니다.
Xcode ▸ Settings ▸ Accounts를 엽니다.

Apple IDs 목록이 비어 있거나 무료 계정으로 로그인된 경우, 유료 Apple Developer 계정을 추가합니다:

왼쪽 하단 + 버튼을 클릭한 뒤 유료 Apple Developer Program에 가입된 Apple ID로 로그인하세요.

2. iPhone에서 개발자 모드 활성화 (≈ 15분)

자동화 테스트를 실행하려면 iPhone에서 개발자 모드를 활성화해야 합니다.

1. iPhone 설정 ▸ 개인정보 보호 및 보안을 열고 맨 아래로 스크롤하여 Developer Mode를 켭니다.

Developer Mode가 보이지 않는다면:

• iPhone을 USB로 Mac에 연결하고 Xcode를 실행합니다.
• Window ▸ Devices and Simulators를 열어 지시에 따라 연결합니다(몇 분 소요).
• iPhone에서 설정 앱을 종료 후 다시 실행합니다.

이후 개발자 모드 항목이 표시됩니다.
개발자 모드를 켜면 디바이스가 재부팅됩니다.

3. Autify CLI 설치 (≈ 15분)

디바이스를 NoCode Mobile과 연결하려면 CLI가 필요합니다.

Homebrew 설치

Autify CLI는 Homebrew로 설치합니다.
Homebrew가 없다면 사이트의 Install Homebrew 명령어를 터미널에 실행하세요.

PATH 설정

Homebrew 설치 후 다음을 실행해 PATH에 추가합니다:
터미널에 다음과 같은 메시지가 표시되어 있을 것입니다. 해당 메시지에 기재된 명령어를 실행해 주십시오(표시 내용은 머신에 따라 다릅니다).

・For MacOS devices

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

・For Linux devices

echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.bashrc
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"

Autify CLI 설치

Autify CLI는 Homebrew로 설치합니다.
터미널에 다음 명령어를 입력하세요:

brew install autifyhq/tap/autify-cli

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

명령어가 정상적으로 완료되면 다음 명령어로 Autify CLI가 올바르게 설치되었는지 확인합니다:

autify help

설치가 성공하면 “Autify Command Line Interface (CLI)” 메시지와 버전·사용 가능한 명령이 표시됩니다.

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

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

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

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

디바이스 연결 설정

먼저 위 단계에서 생성한 토큰을 Autify CLI에 등록합니다.
터미널에서 다음을 실행하세요:

autify mobile auth login

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

autify mobile link setup

화면 안내에 따라 설정을 완료합니다.

• Workspace ID 입력
  • 방법:
    1. http://mobile-app.autify.com/ 에 로그인
    2. URL이 https://mobile-app.autify.com/projects/XXXXXXX?by=test_plan 으로 변경
    3. XXXXXXX 부분이 Workspace ID
• 로그 업로드 동의
  • Yes 입력 시 녹화·테스트 실행 로그가 NoCode Mobile로 전송되어 지원이 원활해집니다.
• Apple Developer Team ID 입력
  • 로그인한 Apple ID에 연결된 Team ID
  • Apple 문서 참고
• Signing ID
  • 기본값 사용(Enter)
• WebDriverAgent Bundle ID
  • 기본값 사용(Enter)
  • WebDriverAgent는 Facebook이 개발한 오픈 소스 자동화 도구로, 테스트와 무관한 항목은 설치되지 않습니다.

연결 확인

터미널에서 다음 명령어로 디바이스와 NoCode Mobile을 연결합니다:

autify mobile link start

명령어가 실행된 후 NoCode Mobile에서 Create New Scenario 화면을 열어 하단 드롭다운에서 Local Device를 선택하면 디바이스 이름이 표시됩니다.

로컬 디바이스 사용법

사전 조건

• iPhone이 USB로 연결되고 잠금이 해제되어 있어야 합니다.
• 장시간 사용 시 설정 ▸ 디스플레이 및 밝기 ▸ 자동 잠금을 안 함으로 설정하면 편리합니다.

녹화

연결 확인 단계에 따라 디바이스를 선택하고 녹화를 시작하세요.
준비 중 오류가 발생하면 빌드 설치 가능 여부를 개발자에게 확인하고, 문제 해결이 되지 않으면 지원팀에 문의하세요.

테스트 실행

클라우드 디바이스와 마찬가지로, 시나리오 세부 정보 페이지에서 Run now 를 클릭하거나 테스트 계획에서 실행하여 로컬 디바이스에서 테스트를 수행할 수 있습니다.

Troubleshooting

이 문서를 참조하세요.