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/configuration.md (or send Accept: text/markdown).
모바일 앱 구성
네이티브 빌드가 사용하는 백엔드 주소와 딥링크 스킴을 설정하고, 양쪽 전달 경로를 동기화된 상태로 유지합니다.
설치 및 설정
기기 대상 값은 apps/mobile/.env.local에 둡니다. Expo는 저장소 루트의 .env가 아니라 이 파일을 읽습니다. EXPO_PUBLIC_API_URL은 휴대폰에서 접근할 수 있는 웹 백엔드 오리진으로, 휴대폰 브라우저에서 테스트한 값과 같습니다. EXPO_PUBLIC_APP_SCHEME은 앱의 네이티브 URI 스킴이며 com.example.app 같은 역 DNS 값을 사용합니다.
app.json은 제품 이름, 슬러그, 버전, 번들 식별자, 플러그인을 관리합니다. app.config.ts는 EXPO_PUBLIC_APP_SCHEME에서 딥링크 스킴과 프로덕션 오리진을 파생하므로, 스킴 변경에는 Metro 재시작이 아니라 네이티브 재빌드가 필요합니다. 서버에서는 앱이 사용할 모든 오리진을 MOBILE_ALLOWED_ORIGINS에 추가하세요. 양쪽이 일치하지 않으면 전달이 안전하게 실패합니다.
모든 EXPO_PUBLIC_* 값은 앱에 번들됩니다. 공급자 키는 서버에 두고, 공개 값은 주소와 스킴에만 사용하세요.
EXPO_PUBLIC_API_URL=http://192.168.1.25:3000
EXPO_PUBLIC_APP_SCHEME=com.example.app구현 워크플로
.env.local을 변경한 뒤 Expo를 재시작합니다. 패키지 테스트와 타입 검사를 실행하고, 개발 빌드에서 확인된 스킴을 검증하세요. 인증 콜백 링크를 열어 브라우저가 아니라 앱으로 돌아오는지 확인합니다. Expo Go는 네이티브 빌드의 사용자 지정 스킴을 검증할 수 없습니다.
검증 및 문제 해결
.env.local을 변경한 뒤 Expo를 재시작하고 대상 기기에서 미리보기를 엽니다. 테마를 바꾸고 앱을 재시작해 선택이 유지되는지 확인한 다음, 딥링크를 실행해 브라우저가 아니라 앱이 처리하는지 확인하세요.
설정을 계속하려면 모바일 앱 테스트 가이드를 읽어보세요.