첫 실행

1. 게이트웨이 시작

android-emu-web

게이트웨이는 기본적으로 127.0.0.1의 7300 포트에서 수신합니다. 다른 포트를 사용하려면 명령줄을 참고하세요.

2. Android SDK 확인하게 하기

시작할 때 게이트웨이는 Android SDK, cmdline-tools, emulator, platform-tools, 시스템 이미지 system-images;android-34;google_apis;arm64-v8a, 그리고 가상 기기(AVD)가 하나 이상 있는지 확인합니다. 빠진 항목은 각각 해결 방법과 함께 다음 순서로 출력합니다:

빠진 항목	게이트웨이의 동작
Android SDK 또는 cmdline-tools	Google 명령줄 도구의 다운로드 페이지와 압축을 풀 디렉터리를 출력합니다. 이 항목들은 직접 다운로드하지 않습니다.
emulator, platform-tools, 시스템 이미지	sdkmanager 명령과 대략적인 크기를 출력한 다음 [y/N]으로 묻습니다.
AVD 없음	emu_web_default라는 기본 기기(Pixel 5 프로필, 4096 MB RAM)를 만들겠다고 제안한 다음 [y/N]으로 묻습니다.

기본 응답은 N입니다. y를 입력하지 않으면 아무것도 다운로드하거나 만들지 않습니다. N으로 답하면 게이트웨이는 직접 실행할 수 있도록 명령을 출력하고 계속 시작합니다.

sdkmanager가 패키지를 설치하려면 먼저 Android SDK 라이선스에 동의해야 합니다. sdkmanager --licenses가 터미널에 라이선스를 보여 주며, 동의는 직접 합니다.

예를 들어 시스템 이미지를 직접 설치하려면:

sdkmanager "system-images;android-34;google_apis;arm64-v8a"

3. 페이지 열기

게이트웨이는 시작할 때마다 새 무작위 토큰을 만들고, 다음과 같은 주소로 기본 브라우저를 엽니다:

https://droid.devpier.dev/app/#port=7300&token=<token>

포트와 토큰은 # 뒤에 있으므로 브라우저는 이를 웹 서버로 보내지 않습니다. 페이지는 이 값을 브라우저에 저장하고 주소 표시줄에서 지웁니다. 기본 브라우저가 Chrome이나 Edge가 아니면 터미널에서 주소를 복사해 Chrome이나 Edge에 붙여 넣으세요.

4. 로컬 네트워크 접근 허용

페이지가 처음으로 Mac의 게이트웨이에 연결할 때, Chrome은 droid.devpier.dev가 로컬 네트워크에 접근해도 되는지 묻는 권한 요청을 표시합니다. 허용하세요. Chrome은 이 사이트에 대한 선택을 기억합니다.

거부했다면 문제 해결을 참고하세요.

5. 에뮬레이터 사용

gRPC가 활성화된 에뮬레이터가 이미 실행 중이면 페이지에 그 화면이 표시됩니다.

그렇지 않으면 목록에서 기기를 골라 시작하세요. 기기를 참고하세요.

화면을 클릭해 키보드 포커스를 주세요. 그런 다음:

• 클릭하면 탭, 드래그하면 스와이프입니다.
• Mac 키보드로 입력합니다. 키보드와 입력을 참고하세요.
• 화면 위의 뒤로, 홈, 최근 앱 버튼을 사용합니다.

중지

게이트웨이가 실행 중인 터미널에서 Ctrl+C를 누르세요. 실행 중인 에뮬레이터는 계속 실행됩니다. 다음에 게이트웨이를 시작하면 다시 연결됩니다.

로컬 대체 페이지

게이트웨이는 같은 페이지를 http://127.0.0.1:7300/app/(또는 선택한 포트)에서도 직접 제공합니다. 공개 페이지가 로드되지 않거나 연결할 수 없을 때 사용하세요.