For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ko/docs/mobile.md (or send Accept: text/markdown).
모바일 개요
같은 서버 측 기반에 연결된 Expo 화면.
첫 번째 모바일 세션
근처에 휴대폰이나 설치된 시뮬레이터를 사용하여 컴퓨터에서 아래 모바일 튜토리얼을 따르세요. 프로젝트를 설치하고 apps/mobile/.env.local에 공개 API 주소를 쓰고 Expo QR 코드를 스캔합니다. Expo는 장치에서 React Native 화면을 여는 개발 도구입니다.
Next.js API 및 공유 서버 패키지는 계정, 데이터 및 권한의 소스로 남아 있습니다. 이는 전화기가 통신하는 실행 중인 웹 백엔드입니다. Expo의 QR 서버는 화면 코드만 전달합니다. 미리 보기가 성공했다고 해서 백엔드, 로그인 또는 스토어 구매가 구성되었다는 의미는 아닙니다. 튜토리얼에서는 각 경계를 순서대로 테스트하는 방법을 보여줍니다.
계약은 공유하고 프레젠테이션은 네이티브로
Expo에는 기본 로그인 및 세션 처리, 작업 공간 및 설정 화면, 채팅 제어, RevenueCat 구매 워크플로가 포함되어 있습니다. Next.js API 및 공유 서버 패키지는 공유 데이터, 인증 및 공급자 확인을 위한 소스로 남아 있습니다. 기본 화면은 서버 자격 증명을 포함하는 대신 이를 호출합니다.
Expo 애플리케이션은 apps/mobile.에 있습니다. 이는 서버 자격 증명을 내장하는 대신 API를 통해 공유 기반을 사용합니다. 기본 인증, 보안 세션 저장소, 딥 링크, 채팅 제어 및 RevenueCat 구매 프레젠테이션에는 각각 클라이언트 모듈이 있습니다.
API와 앱 스킴 구성
EXPO_PUBLIC_API_URL을 에뮬레이터나 물리적 디바이스가 도달할 수 있는 API 오리진으로 설정하세요. 폰에서 localhost는 그 폰을 의미하므로 적절한 도달 가능한 개발 호스트를 사용하세요. EXPO_PUBLIC_APP_SCHEME은 앱의 딥링크 스킴을 식별합니다.
콜백을 테스트하기 전에 apps/mobile/app.config.ts와 인증 구성을 검토하세요. Expo 공개 값은 클라이언트에 번들되므로 프로바이더 시크릿을 포함해서는 안 됩니다.
대상 디바이스에서 검증
결정론적 세션 저장, 딥 링크, 채팅 취소 및 권한 부여 테스트를 먼저 실행하세요. 그런 다음 의도한 EAS 개발 빌드에서 로그인 반환, 세션 복원, 로그아웃 및 구매 동기화를 확인합니다. Expo Go는 실제 매장 구매를 확인할 수 없습니다.
물리적 디바이스와 프로바이더 수용은 웹 로컬 골든 패스와 분리되어 있습니다. 각 릴리스 대상에 대해 명시적으로 추적하세요.
설정을 계속하려면 모바일 앱 실행 가이드를 읽어보세요.