> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 모바일 앱 구성

네이티브 빌드가 사용하는 백엔드 주소와 딥링크 스킴을 설정하고, 양쪽 전달 경로를 동기화된 상태로 유지합니다.

## 설치 및 설정

기기 대상 값은 `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를 재시작하고 대상 기기에서 미리보기를 엽니다. 테마를 바꾸고 앱을 재시작해 선택이 유지되는지 확인한 다음, 딥링크를 실행해 브라우저가 아니라 앱이 처리하는지 확인하세요.


설정을 계속하려면 [모바일 앱 테스트](https://supastack.dev/ko/docs/mobile/testing.md) 가이드를 읽어보세요.


## 다음

[모바일 앱 테스트](https://supastack.dev/ko/docs/mobile/testing.md)