문제 해결

Chrome이 로컬 네트워크 접근을 차단함

droid.devpier.dev의 페이지는 내 Mac의 게이트웨이에 연결합니다. Chrome은 처음에 권한을 요청합니다. 거부했다면 페이지가 연결할 수 없으며, 몇 번 시도에 실패한 뒤 Chrome이 Mac 접근을 차단했다고 알려 줍니다.

다시 허용하려면:

Chrome에서 설정 → 개인정보 보호 및 보안 → 사이트 설정을 엽니다.
droid.devpier.dev를 찾아 로컬 네트워크 접근을 허용합니다.
페이지를 새로고침합니다.

그래도 연결할 수 없으면 로컬 대체 페이지를 사용하세요.

포트가 이미 사용 중임

게이트웨이는 기본적으로 7300 포트에서 수신합니다. 다른 프로그램이 이미 그 포트를 사용 중이면 게이트웨이는 그 포트로 시작할 수 없습니다. 해당 프로그램을 찾으세요:

lsof -nP -iTCP:7300 -sTCP:LISTEN

그 프로그램을 중지하거나, 다른 포트로 게이트웨이를 시작하세요:

android-emu-web --port 7301

게이트웨이는 여는 주소에 새 포트를 넣으므로, 페이지가 올바른 포트에 연결합니다.

에뮬레이터를 찾을 수 없음

페이지에 실행 중인 에뮬레이터를 찾을 수 없다고 표시되면:

에뮬레이터가 실행 중인지 확인하세요. adb devices에 emulator-5554 같은 항목이 나와야 합니다.
gRPC를 활성화해(-grpc <port>) 시작했는지 확인하세요. 게이트웨이는 gRPC가 없는 에뮬레이터의 화면을 읽을 수 없습니다.

페이지의 목록에서 기기를 시작할 수도 있습니다. 기기를 참고하세요.

에뮬레이터를 찾지 못해도 게이트웨이는 계속 실행되며, 터미널에 이유를 출력합니다.

게이트웨이가 Android SDK, emulator, platform-tools 또는 시스템 이미지가 없다고 보고하면, 출력된 해결 방법을 따르세요. 첫 실행을 참고하세요.

“sdkmanager”가 없음

Android Studio로 설치한 SDK에는 sdkmanager와 avdmanager를 제공하는 cmdline-tools가 없을 수 있습니다. 게이트웨이는 이를 다운로드하지 않습니다. developer.android.com에서 Google의 명령줄 도구를 다운로드하고, 다음 경로가 존재하도록 압축을 푸세요:

<your SDK>/cmdline-tools/latest/bin/sdkmanager

토큰이 만료됨

게이트웨이는 시작할 때마다 새 토큰을 만듭니다. 게이트웨이를 다시 시작하면, 아직 이전 토큰을 가진 페이지는 토큰이 더 이상 유효하지 않다고 표시하고 재시도를 멈춥니다. 게이트웨이가 출력한 새 링크를 열거나, 게이트웨이를 다시 실행하세요.

페이지에 게이트웨이 또는 페이지가 오래되었다고 표시됨

게이트웨이가 오래됨: 페이지에 표시된 업그레이드 명령을 실행하세요. 설치 명령과 같습니다.
페이지가 오래됨: Cmd+Shift+R로 페이지를 강력 새로고침하세요.

지원하지 않는 브라우저

페이지는 Chrome과 Edge에서만 동작합니다. 다른 브라우저에서는 브라우저를 바꾸라고 안내하고 연결을 시도하지 않습니다. 브라우저 지원을 참고하세요.

로컬 대체 페이지 사용

게이트웨이는 같은 페이지를 http://127.0.0.1:7300/app/(또는 선택한 포트)에서 제공합니다. 공개 페이지가 로드되지 않거나 로컬 네트워크 접근이 거부되었을 때 사용하세요.

화면이 더 이상 갱신되지 않음

에뮬레이터가 종료되거나 다시 시작되면 페이지에 연결이 끊겼다고 표시됩니다. 게이트웨이는 계속 실행됩니다. 에뮬레이터가 다시 돌아오면 페이지가 다시 연결되고 화면이 돌아옵니다.