EAS 설정

설치 및 설정

어떤 단계를 시작하기 전에 시작하기 전에 및 터미널 기본 사항을 읽어보세요. 이 지침에서는 VS Code에서 전체 supastack 단일 저장소를 열었다고 가정합니다. 해당 루트 package.json은 저장소 루트를 표시합니다. pnpm 명령에서 작업 영역 패키지는 앱 또는 공유 코드 폴더입니다. 제품에서 작업공간은 팀의 데이터 컨테이너이자 보안 경계입니다. corepack pnpm --filter ... 명령이 해당 루트에서 실행되는 동안 monorepo에서 하나의 패키지를 선택합니다. 동기화된 모바일 또는 데스크톱 폴더만 열었다면 웹 백엔드, Docker 설정 또는 루트 스크립트가 포함되지 않습니다. 이 모노 저장소 또는 연결 가능한 호스팅 서버에서 백엔드를 실행하고 플랫폼 폴더의 자체 스크립트를 사용하세요. 환경 변수는 로컬 .env 파일이나 호스팅 대시보드에 저장된 명명된 설정입니다. 관련 앱을 변경한 후 다시 시작하고, NEXT_PUBLIC_ 및 EXPO_PUBLIC_ 값에서 서버 비밀을 유지하세요.

1. VS Code에서 apps/mobile/eas.json 및 apps/mobile/app.json를 열어 개발, 미리 보기 및 프로덕션 설정을 검토합니다.

2. corepack pnpm --filter @supastack/mobile exec expo install expo-dev-client를 사용하여 저장소 루트에서 기본 개발 클라이언트를 추가합니다. 로컬 JavaScript 내보내기를 위해 corepack pnpm --filter @supastack/mobile typecheck를 실행한 다음 corepack pnpm --filter @supastack/mobile build를 실행합니다.

3. 기본 테스트를 위해 Expo 계정에 로그인하고 cd apps/mobile로 터미널 폴더를 변경한 다음 npx eas-cli@latest build --platform android --profile development를 실행하세요. iOS를 사용하여 모든 운영 체제에서 EAS 클라우드 iOS 빌드를 요청하세요. iOS 시뮬레이터를 실행하거나 로컬로 컴파일하려면 Xcode가 설치된 Mac이 필요합니다. 예상: 내보내기는 JavaScript 번들을 확인하고 EAS는 설치 가능한 기본 개발 앱을 생성합니다. Expo Go가 네이티브 라이브러리를 추가할 수 없는 이유는 Expo의 개발 빌드 가이드를 참조하세요.

모바일 작업공간 빌드는 내보내기 스크립트를 호출합니다. 이는 구성된 대상에 대한 번들링을 검증합니다. 매장 서명, 배포 구성 및 물리적 장치 승인은 별도의 작업으로 유지됩니다.

corepack pnpm --filter @supastack/mobile typecheck
corepack pnpm --filter @supastack/mobile test
corepack pnpm --filter @supastack/mobile build

복사 명령

설명을 따라 명령이 실행되는 폴더를 확인하세요. 두 개의 터미널에 레이블이 지정되어 있으면 두 개의 터미널 창을 열고 두 번째 명령을 사용하는 동안 첫 번째 명령을 계속 실행하세요.

# From the monorepo root, install the native development client once:
corepack pnpm --filter @supastack/mobile exec expo install expo-dev-client
corepack pnpm --filter @supastack/mobile typecheck
corepack pnpm --filter @supastack/mobile build

# EAS needs to run where apps/mobile/eas.json is located:
cd apps/mobile
npx eas-cli@latest build --platform android --profile development

구현 워크플로

모바일에서 사용하는 공유 패키지를 변경한 뒤 계약 테스트를 실행하세요. 대상 기기에서 safe area, 키보드 동작, 글자 크기, reduced motion을 확인합니다.

기존 RevenueCat 경계 뒤에 기본 구매를 유지합니다. 성공적인 번들은 검증된 기본 구매 통합을 대신하여 모바일 인터페이스에 Stripe Checkout을 도입해서는 안 됩니다.

iOS 또는 Android에서 EAS 개발 빌드를 사용하여 구성된 샌드박스 제품에 대해 react-native-purchases를 검증합니다. Expo Go 및 작업공간 내보내기 스크립트는 상점 거래의 유효성을 검사하지 않습니다.

검증 및 문제 해결

EAS 빌드에서 expo-dev-client가 누락되었다고 표시되면 설치 명령을 반복하고 apps/mobile/package.json가 이제 나열되는지 확인하세요. apps/mobile에서 EAS를 실행하여 eas.json을 찾습니다. EAS가 누락된 프로젝트 또는 서명 설정을 보고하는 경우 Expo 계정 및 프로젝트 설정을 확인하세요. Expo Go 및 성공적인 내보내기는 여전히 StoreKit 또는 Play Billing을 테스트하지 않습니다. 샌드박스 제품과 함께 EAS 개발 빌드를 사용하세요. 클라우드 iOS 빌드는 Windows 또는 Linux에서 시작할 수 있습니다. 로컬 iOS 시뮬레이터/빌드 작업에만 Xcode가 있는 Mac이 필요합니다.

수용에 사용된 디바이스, 빌드, API 환경, 로그인 방법을 기록하세요. 딥링크 복귀, 세션 복원, 거부된 권한, 로그아웃을 검증하세요.보내기 성공은 스토어와 디바이스 검증과 별도로 보고하세요.

내보내기가 통과되고 릴리스가 목표이면 앱 스토어에 제출을 따릅니다. 배송된 eas.json 프로필과 build:/submit: 스크립트는 앱을 Google Play 및 App Store로 전달합니다.