문제 해결
아래 표에서 증상을 찾거나 문제가 생긴 Mac에서 tapflow doctor부터 실행하세요.
tapflow doctor부터 실행
에이전트 Mac에서 tapflow doctor를 실행하면 Node.js, 포트, Xcode와 시뮬레이터, Android SDK와 AVD를 점검하고 실패한 항목마다 고칠 방법을 출력합니다. ios나 android를 붙이면 한 플랫폼만 점검합니다. 점검 항목은 CLI 레퍼런스에, 실패별 해결 방법은 tapflow doctor 실패에 있습니다.
sh
tapflow doctor
tapflow doctor ios증상으로 찾기
| 증상 | 참고 |
|---|---|
| 에이전트가 대시보드에 나타나지 않거나 연결되지 않음 | 에이전트가 릴레이에 연결되지 않음 |
tapflow agent start가 이미 에이전트가 실행 중이라고 함 | 이미 에이전트가 실행 중이라고 나옴 |
| 릴레이가 예상과 다른 설정이나 DB를 읽음 | 예상과 다른 설정이나 DB |
iOS 빌드를 열면 spawn unknown error가 남 | iOS 시뮬레이터 |
| iOS 시뮬레이터가 부팅되지 않음 | 서비스 버전 불일치, cannot be located on disk |
| Android 스트림이 시작되지 않음 | Android 에뮬레이터 |
업로드가 400으로 실패함 | 빌드와 업로드 |
Apple Silicon Mac에서 APK가 설치되지 않음 (INSTALL_FAILED_NO_MATCHING_ABIS) | 빌드와 업로드 |
| 스트림이 느리거나 끊기거나 흐림 | 스트림과 세션 |
| 세션이 저절로 끝남 | 세션이 자동으로 종료됨 |
| 기기가 오프라인이 되지 않음 | 네트워크 제어 |
| 초대 링크나 비밀번호 재설정 링크가 동작하지 않음 | 로그인과 계정 |
| 업그레이드 후 모두 로그아웃됨 | 업그레이드 후 로그아웃됨 |
릴레이 로그 확인
릴레이 호스트에서 다음 명령으로 릴레이의 동작 로그를 확인할 수 있습니다. 릴레이는 다른 기기에는 로그를 보여 주지 않습니다.
sh
tapflow logs
tapflow logs --lines 200Docker로 운영한다면 컨테이너 밖의 CLI는 원격으로 취급되므로 docker compose logs로 확인하세요.
옮겨진 섹션
이 페이지에 있던 섹션은 아래 페이지로 옮겨졌습니다.