기기 조작

iOS Android

QA 세션의 기기는 마우스와 키보드로 실제 폰처럼 다룹니다. 따로 켤 설정은 없고 세션을 시작하면 바로 쓸 수 있습니다. 버튼은 기기 오른쪽 툴바에 있고 마우스를 올리면 이름과 단축키가 보입니다.

화면 조작

• 터치: 기기 화면을 클릭합니다.
• 스와이프: 클릭한 채로 드래그합니다.
• 핀치: Option(Alt) 키를 누른 채 드래그합니다. 키를 누르면 두 손가락 위치가 화면에 표시되고 드래그하는 동안 두 손가락이 벌어지거나 모입니다. 키를 떼면 핀치가 끝납니다.

키 입력

기기 화면을 한 번 클릭하면 그때부터 키 입력이 기기로 갑니다. 정보 카드의 Focus 표시가 초록색으로 바뀌면 입력을 받는 상태입니다. 기기 밖의 대시보드 영역을 클릭하면 입력 전달이 멈춥니다.

앱 실행

기기가 켜지면 빌드가 자동으로 설치됩니다. 설치가 끝나면 툴바 맨 위에 재생 아이콘의 Launch app 버튼이 나타납니다. 이 버튼을 누르면 앱이 실행됩니다. 앱을 닫은 뒤 다시 실행할 때도 이 버튼을 씁니다.

기기 버튼

플랫폼	버튼
iOS	툴바의 Home(⌘ ⇧ U), 기기 테두리에 그려진 측면 버튼
Android	툴바의 Home, Back, Recent Apps, Volume Up, Volume Down, Power

iOS는 기기 테두리에 그려진 측면 버튼(전원, 볼륨 등)을 클릭하면 그 버튼이 눌립니다.

소프트웨어 키보드

iOS

툴바의 키보드 버튼(Software keyboard, ⌘ ⇧ K)을 누르면 iOS 시뮬레이터의 화면 키보드가 올라오거나 내려갑니다. 화면 키보드가 가린 레이아웃을 확인할 때 씁니다. 기기가 응답하지 않으면 키보드 상태가 바뀌지 않았다는 알림이 뜹니다.

회전

Rotate(⌘ ⇧ O)를 누를 때마다 기기가 가로와 세로로 번갈아 돌아갑니다. 가로로 둔 채 세션을 떠나면 기기를 세로로 되돌린 뒤 종료합니다.

접기와 펼치기

Android

폴더블 Android 에뮬레이터에서는 툴바에 접기·펼치기 버튼이 나타납니다. 누를 때마다 접힌 상태와 펼친 상태가 바뀌고 버튼 이름은 Unfold나 Fold 뒤에 현재 상태와 바뀔 상태를 붙여 표시합니다. 상태가 바뀌는 동안에는 버튼에 로딩 아이콘이 돕니다.

기기 재시작

Restart the device 버튼을 누르면 확인 창(Restart this device?)이 뜹니다. Restart를 누르면 기기가 꺼졌다 다시 켜집니다.

• 열려 있던 앱과 화면에 띄워 둔 상태는 사라집니다.
• 테스트 중인 빌드는 기기가 다시 켜진 뒤 새로 설치되므로 그 앱의 데이터는 지워집니다.
• 다른 앱과 그 데이터는 남습니다.

기기의 데이터를 모두 지우고 싶다면 기기를 고르기 전에 Full reset을 켭니다(QA 세션 참고).

클립보드

기기 화면을 클릭해 키 입력이 기기로 가는 상태에서 동작합니다.

• 기기 → 내 컴퓨터: 기기에서 텍스트를 선택하고 ⌘ C(또는 Ctrl C)를 누르면 내 컴퓨터 클립보드에 복사됩니다. X를 쓰면 잘라내기입니다.
• 내 컴퓨터 → 기기: 내 컴퓨터에서 복사한 텍스트는 ⌘ V(또는 Ctrl V)로 기기의 입력란에 붙여 넣습니다.

대시보드를 HTTP로 열었다면 기기에서 복사한 텍스트는 기기 안에만 남고 Copied on the device. Serving the dashboard over HTTPS also brings it to your clipboard. 알림이 뜹니다. 브라우저는 보안 연결(HTTPS 또는 localhost)에서만 이런 클립보드 쓰기를 허용하기 때문입니다. HTTPS 설정은 운영자에게 요청하세요.

플랫폼 지원

기능	iOS	Android
터치, 스와이프, 핀치, 키 입력	지원	지원
기기 버튼	Home, 기기 테두리의 측면 버튼	Home, Back, Recent Apps, Volume Up, Volume Down, Power
소프트웨어 키보드 버튼	지원	없음
회전	지원	지원
접기와 펼치기	없음	접힘 상태가 둘인 폴더블 에뮬레이터
기기 재시작, 클립보드	지원	지원

제한 사항

• 단축키는 ⌘(Command) 키 기준입니다. 클립보드만 Ctrl도 받습니다.
• 대시보드의 입력창에 커서가 있을 때는 단축키가 동작하지 않습니다.
• 대시보드에서 텍스트를 선택한 상태로 누른 ⌘ C는 기기가 아니라 브라우저의 일반 복사로 처리됩니다.
• 기기로 붙여 넣는 텍스트는 1MB까지입니다. 넘으면 That text is too large to send to the device 알림이 뜹니다.

문제 해결

• 키를 눌러도 기기에 입력되지 않습니다. 기기 화면을 한 번 클릭하고 Focus가 초록색인지 확인합니다.
• 기기에서 복사한 텍스트가 내 클립보드에 없습니다. 대시보드 주소가 http://로 시작하면 위 클립보드 설명처럼 복사가 기기 안에 머뭅니다.
• The device is taking too long — try again 알림이 뜹니다. 기기가 제시간에 응답하지 않았으므로 다시 시도합니다.

관련 문서

• QA 세션: 세션 시작과 기능 목록, 키보드 단축키
• 딥 링크: URL로 앱의 특정 화면을 여는 방법
• HTTPS 보안 컨텍스트: 클립보드와 Smooth 프로파일에 필요한 HTTPS 설정