휴대폰과 태블릿
VMPal은 iPhone, iPad, Android 기기의 화면을 Mac의 창에 보여 주며, 마우스와 키보드로 기기를 사용할 수 있습니다. 케이블이나 Wi-Fi로 연결하며, iOS 시뮬레이터에서도 동작합니다. AI 에이전트도 기기를 사용할 수 있습니다. 화면을 읽고, 앱을 탭하며 둘러보고, 빌드를 설치하고, 로그와 충돌 보고서를 읽습니다.
휴대폰과 태블릿을 사용하려면 VMPal 0.119 이상이 필요합니다. App Store나 Google Play에서 따로 설치할 것은 없습니다.
iPhone과 iPad
Apple은 자사의 테스트 도구만 iPhone을 제어할 수 있게 하므로, VMPal은 Xcode의 테스트 도구를 사용합니다. Mac에는 다음이 필요합니다.
- App Store에서 설치한 Xcode.
- Xcode › Settings › Accounts에 로그인한 Apple 계정. 무료 계정도 되지만, 무료 계정으로 서명한 앱은 7일 동안만 유효합니다.
iPhone이나 iPad에서는 다음을 하세요.
- 케이블로 Mac에 한 번 연결하고 잠금을 해제한 다음 신뢰(Trust)를 선택하세요. 그 뒤에는 Mac과 같은 네트워크에 있으면 Wi-Fi로도 동작합니다.
- 설정 › 개인정보 보호 및 보안 › 개발자 모드(Settings › Privacy & Security › Developer Mode)에서 개발자 모드를 켜세요. 기기가 재시작됩니다.
- VMPal이 연결하는 동안 잠금 해제 상태를 유지하세요.
처음 연결하면 Xcode가 작은 테스트 앱을 빌드하고, 내 계정으로 서명해 기기에서 시작합니다. 1~2분 정도 걸립니다. 그러면 기기에 Automation Running이 표시됩니다. iOS에 개발자를 신뢰하지 않는다는 메시지가 나오면 설정 › 일반 › VPN 및 기기 관리(Settings › General › VPN & Device Management)로 이동해 내 계정을 선택한 다음 신뢰를 선택하세요.
iOS 시뮬레이터
Xcode에 있는 시뮬레이터도 같은 목록에 표시됩니다. 시뮬레이터에는 Apple 계정이 필요 없습니다. VMPal은 Simulator 창 없이 시뮬레이터를 시작하고, 시뮬레이터의 화면을 VMPal 창에 보여 줍니다.
Android 휴대폰과 태블릿
- 기기에서 개발자 옵션(Developer options)을 켜세요. 설정 › 휴대전화 정보(Settings › About phone)에서 빌드 번호(Build number)를 7번 탭하면 됩니다.
- 설정 › 시스템 › 개발자 옵션(Settings › System › Developer options)에서 USB 디버깅(USB debugging)을 켜세요.
- 케이블로 Mac에 연결하고 잠금을 해제한 다음, USB 디버깅을 허용할지 물으면 허용(Allow)을 선택하세요. Wi-Fi로 연결하려면 무선 디버깅(Wireless debugging)을 켜고 터미널에서
adb pair와adb connect로 연결하세요.
Mac에는 Android의 adb가 필요합니다. adb는 Android Studio에 포함되어 있으며, Homebrew에서 brew install android-platform-tools로 설치할 수도 있습니다. 처음 연결하면 VMPal은 오픈 소스 화면 미러링 도구인 scrcpy의 서버를 내려받아 검증한 다음 기기에서 시작합니다.
VMPal에 추가하기
- File › Add Phone or Tablet… 메뉴를 선택하거나, Remote 섹션의 도구 막대에서 + 버튼을 클릭한 다음 Add Phone or Tablet… 항목을 선택하세요.
- 기기를 선택하세요. VMPal이 기기가 준비되었는지, 준비되지 않았다면 기기에서 무엇을 해야 하는지 알려 줍니다. 무언가를 바꾼 뒤에는 Refresh를 클릭하세요.
- iPhone이나 iPad라면 Sign with에서 VMPal의 테스트 앱에 서명할 Apple 계정을 선택하세요.
- Add를 클릭하세요.
그러면 기기가 Remote 섹션에 표시되고 기기의 창이 열립니다.
창
| Mac에서 | iPhone과 iPad | Android |
|---|---|---|
| 클릭 | 탭 | 탭 |
| 드래그 | 스와이프(버튼을 놓을 때 실행) | 스와이프(움직이는 대로 실행) |
| 오른쪽 클릭 | 길게 누르기 | 뒤로 |
| 가운데 클릭 | 홈 | |
| 스크롤 | 짧은 스와이프 | 스크롤 |
| 입력 | 포커스가 있는 필드에 입력 | 포커스가 있는 필드에 입력 |
Android 기기의 화면은 비디오로 전송됩니다. iPhone의 화면은 이미지로 전송되며, 화면이 바뀔 때만 초당 최대 20장까지 보냅니다. 도구 막대의 Quality는 Mac에서와 같이 동작합니다.
AI 에이전트로 앱 테스트하기
AI 에이전트는 Mac이나 VM에서와 같은 도구로 휴대폰을 사용합니다. 화면을 버튼과 텍스트 목록으로 읽고, 탭하고, 입력하고, 스크린샷을 찍습니다. 앱을 테스트할 때는 빌드를 설치하고, 실행하고, 앱이 출력한 내용과 충돌 원인을 읽을 수도 있습니다. 예를 들어 이렇게 요청하세요. "./build에 있는 빌드를 내 iPhone에 설치하고, 열어서 테스트 계정으로 로그인한 다음, 무엇이 문제인지 알려 주세요."
터미널에서 vmpal로도 같은 작업을 할 수 있습니다.
vmpal device "My iPhone" install ./build/MyApp.app
vmpal device "My iPhone" launch com.example.MyApp
vmpal ui "My iPhone" tree
vmpal device "My iPhone" logs com.example.MyApp
vmpal device "My iPhone" crashes com.example.MyApp
vmpal help device에서 모든 동작을 확인할 수 있습니다. install, launch, terminate, uninstall, apps, logs, crashes, crash, rotate, pinch, button, open-url, release가 있습니다.
- 설치할 파일: iPhone이나 iPad에는 해당 기기용으로 서명한
.app이나.ipa, 시뮬레이터에는 시뮬레이터용으로 빌드한.app, Android에는.apk를 설치합니다. 먼저 Xcode나 Gradle로 빌드하세요. - 로그:
launch는 그때부터 앱이 출력하는 내용을 보관하며,logs로 이 내용을 읽습니다. Android에서는logs가 앱의 logcat을 읽습니다. - 직접 작성한 UI 테스트: iPhone은 한 번에 테스트 세션 하나만 실행합니다.
vmpal device "My iPhone" release로 VMPal의 세션을 끝내면 Xcode에서 내 테스트를 실행할 수 있습니다. 기기의 창을 열면 VMPal의 세션이 다시 시작됩니다.
알아 두기
- iPhone에서 드래그는 하나의 완성된 제스처입니다. Xcode의 테스트 도구는 스와이프를 처음부터 끝까지 한 번에 재생하므로, iPhone이나 iPad에서는 마우스 버튼을 놓을 때 드래그가 실행됩니다. Android는 마우스를 움직이는 대로 따라갑니다.
- iPhone의 홈 버튼:
vmpal device "My iPhone" button home을 실행하거나 AI 에이전트에게 요청하세요. - 잠긴 기기: VMPal이 연결할 때 iPhone이나 iPad의 잠금이 해제되어 있어야 합니다. 연결된 뒤에는 계속 사용할 수 있습니다.