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/publishing.md (or send Accept: text/markdown).

앱 스토어 게시

작동하는 빌드와 사용자가 설치할 수 있는 출시 버전을 구분합니다.

이 가이드에 대해 질문하기

첫 번째 스토어 제출을 단계별로 준비하세요.

먼저 모바일 빌드를 사용하여 기본 개발 빌드를 만들고 테스트하세요. 스토어 제출은 검토를 위해 컴파일된 앱과 해당 목록을 Google 또는 Apple에 보냅니다. Expo Go 미리보기를 여는 것과는 다릅니다. 자신의 Expo 및 관련 스토어 개발자 계정, 테스트된 HTTPS 백엔드, 최종 앱 이름/아이콘, 스크린샷, 지원 연락처 및 공개 개인 정보 보호 정책 URL가 필요합니다.

편집기에서 apps/mobile/app.json를 열고 첫 번째 업로드 전에 자신의 제품에 대한 앱 이름, 슬러그, ios.bundleIdentifier 및 android.package를 설정하세요. apps/mobile/eas.json를 열고 필요한 경우 iOS 제출 팀의 앱 식별자를 자신의 식별자로 바꿉니다. 배송된 식별자는 예시입니다. 정확한 필드에 대해서는 모바일 빌드를 읽고 코딩 에이전트에게 빌드하기 전에 두 파일을 검토하도록 요청하세요.

eas가 설치되지 않은 경우 npm install --global eas-cli를 실행합니다. 저장소 루트에서 아래 로그인 명령을 사용하여 브라우저 인증을 마친 후 빌드에서 한 플랫폼에 대한 빌드 명령을 선택한 후 제출하십시오. 빌드의 대시보드 로그를 읽습니다. 제출을 시도하기 전에 성공적인 .aab 또는 .ipa를 기다리십시오. EAS는 프로젝트 연결 및 자격 증명 서명을 묻는 메시지를 표시합니다. 이는 키트 판매자의 계정이 아닌 귀하의 계정에 속합니다.

바이너리가 업로드된 후 Play Console 또는 App Store Connect에서 앱을 열고 목록과 필수 설문지를 작성하고 현재 검토자 로그인 지침을 추가한 다음 검토를 위해 제출하세요. 내부 초안 업로드는 공개 릴리스가 아닙니다. 검토 결과 거부된 경우 거부 내용에 있는 정확한 정책 링크를 열고 해당 문제를 수정한 후 다시 제출하세요.

corepack pnpm --filter @supastack/mobile exec eas login

계정을 한 번 설정하세요.

스토어 제출에는 EAS 빌드 및 제출을 위한 무료 Expo 계정, Google Play Console 개발자 등록, iOS용 Apple 개발자 프로그램 멤버십 등 세 가지 계정이 필요합니다. EAS CLI를 설치하고 빌드하기 전에 eas login를 실행하십시오. 두 매장 등록 모두 확인하는 데 며칠이 걸릴 수 있으므로 일찍 시작하세요.

첫 번째 업로드 전에 애플리케이션 식별자 이름 바꾸기 — android.package 및 ios.bundleIdentifier는 apps/mobile/app.json.에서 com.supastack.app으로 제공됩니다. Google Play는 첫 업로드 시 패키지 이름을 잠그므로 잘못된 식별자는 이름 바꾸기가 아닌 새 앱 항목을 의미합니다.

EAS가 서명을 관리하도록 허용

apps/mobile/eas.json는 개발, 미리보기 및 프로덕션 빌드 프로필을 정의합니다. 프로덕션 프로필을 사용하면 EAS가 인프라에서 Android 키 저장소와 iOS 배포 인증서를 생성하고 보관할 수 있습니다. 나중에 eas credentials로 검사하고 로컬 키 저장소를 저장소에서 제외하세요.

자동 Play 제출을 위해서는 Play Console → 설정 → 출시 권한이 있는 API 액세스에 연결된 Google Play 서비스 계정 JSON 키가 필요합니다. apps/mobile/secrets/play-store-service-account.json에 저장하세요. eas.json이 예상하는 경로와 git-ignored 디렉터리입니다. 새 앱의 첫 번째 업로드는 여전히 Play Console에서 수동으로 이루어집니다. eas submit는 두 번째 릴리스를 이어받습니다.

빌드 후 제출

빌드는 EAS 인프라에서 실행되므로 바이너리에 Android Studio 또는 Xcode를 설치할 필요가 없습니다. 프로덕션 프로필은 원격 관리 버전 번호를 사용하여 Store에서 바로 사용할 수 있는 Play용 .aab 및 App Store용 .ipa를 생성합니다. 미리 보기 프로필은 물리적 장치 QA를 위한 내부 배포 APK를 생성합니다.

배송된 제출 프로필은 Play 내부 트랙을 초안 릴리스로 대상으로 합니다. 검토를 통과한 후 Play Console 내에서 홍보할 때까지 테스터에게 아무 것도 전달되지 않습니다.

corepack pnpm --filter @supastack/mobile build:android
corepack pnpm --filter @supastack/mobile submit:android

corepack pnpm --filter @supastack/mobile build:ios
corepack pnpm --filter @supastack/mobile submit:ios

# Internal-testing APK for a physical device:
corepack pnpm --filter @supastack/mobile build:android:preview

Play Console 양식 작성

공개 개인 정보 보호 정책 URL, 데이터 보안 양식, 콘텐츠 등급 설문지, 대상 청중 및 카테고리와 같은 바이너리만큼 선언된 콘텐츠에 대한 검토 게이트를 재생합니다. 앱의 실제 동작에서 데이터 안전을 확인하세요. 키트는 인증을 위해 계정 이메일을 수집하고, 플랫폼 보안 저장소에 세션 토큰을 저장하며, 구성된 API와만 통신합니다. 귀하의 제품이 무엇이든 추가하십시오.

로그인이 필요한 iOS 앱의 경우 앱 리뷰에 작동하는 데모 계정과 리뷰 노트의 지침을 제공하세요. 소셜 로그인 옵션을 선택하기 전에 Apple의 현재 로그인 서비스 규칙과 예외 사항을 검토하세요. 요구 사항은 앱의 실제 로그인 흐름에 따라 다릅니다. 공식 가이드라인은 위의 첫 번째 제출 섹션에 링크되어 있습니다.

RevenueCat 뒤의 게이트 구매 먼저

앱에서 모바일 구매를 제공하는 경우 배송된 RevenueCat 흐름을 구성합니다. 즉, MOBILE_PURCHASES_PROVIDER=revenuecat 및 EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=revenuecat를 설정한 다음 일치하는 공개 iOS 또는 Android SDK 키를 제공합니다. 기본 앱은 구매 및 복원을 지원합니다. 둘 중 하나 이후에는 서버에서 확인된 작업 공간 권한에서 액세스 새로 고침이 이루어집니다. Stripe Checkout은 모바일 흐름에서 사용되지 않습니다. 구매가 꺼져 있거나 필수 구성이 누락된 경우 페이월을 사용할 수 없도록 유지하세요. 스토어 테스트 계정을 사용하여 EAS 개발 빌드에서 구성된 스토어 제품을 검증하고, 구매, 복원 및 권한 새로 고침을 수행합니다. 앱과 지역에 적용되는 요구 사항은 현재 스토어 지침을 확인하세요.

제출 전 체크리스트

제출하기 전에 자신의 테스트 앱과 스토어 계정을 사용하여 아래의 모든 항목을 확인하세요.

android.package 및 ios.bundleIdentifier의 이름이 귀하가 소유한 식별자로 변경되었습니다.
빌드 환경의 EXPO_PUBLIC_API_URL는 프로덕션 API를 가리킵니다.
공개 URL에 호스팅되고 스토어 등록정보에 링크된 개인정보 보호정책
데이터 보안 양식은 실제 수집과 일치합니다: 인증 이메일, API 트래픽, 제품에 추가되는 모든 것
App Store 리뷰 노트에서 작동하는 데모 계정 자격 증명
페이월이 숨겨져 있거나 확인된 RevenueCat 자격으로 지원됩니다.
실제 기기에서 딥링크 반환, 세션 복원, 로그아웃 확인됨
각 매장별로 준비된 스크린샷 및 목록 자산

거절로부터 회복하기

거부는 정책 참조와 함께 도착합니다. 증상을 추측하기보다는 선언된 원인을 수정하세요. 데이터 보안 불일치는 일반적으로 앱이 아니라 양식이 잘못되었음을 의미합니다. 로그인이 필요한 거부는 일반적으로 리뷰 노트에 데모 계정이 없음을 의미합니다. 수정 사항의 이름을 명확하게 명시한 릴리스 노트와 함께 다시 제출하세요.

자격 증명 명령, 콘솔 작업 순서, 거부 플레이북 등 전체 연습은 저장소의 docs/mobile-store-submission.md에 있습니다.

설치 및 설정

네이티브 출시는 Apple 및/또는 Google 개발자 계정, 앱 식별자, 서명 자격 증명, 스토어 심사가 필요합니다. EAS production profile은 build 번호를 올리고 submit.production은 Google Play 내부 테스트에 초안을 보냅니다. bundle identifier와 scheme은 apps/mobile/app.config.ts에 있습니다.

Web 배포와 스토어 출시는 서로 다른 주기로 진행됩니다. API를 가장 오래된 지원 빌드와 호환되게 유지하거나 새 기능을 서버 상태로 제어하세요.

corepack pnpm --filter @supastack/mobile build
eas build --profile production --platform ios
eas build --profile production --platform android
eas submit --profile production --platform ios
eas submit --profile production --platform android

구현 워크플로

네이티브 구매를 켜기 전에 RevenueCat 프로젝트, 스토어 상품, entitlement를 구성하세요. 서버 secret key와 Webhook Authorization은 서버 환경에만 두고 iOS/Android SDK key는 공개 빌드 값으로 설정합니다. 프로덕션에서는 sandbox를 꺼야 합니다.

스크린샷, 설명, 개인정보 답변, 구매 안내를 제품 출시 자료에 포함하세요. 앱은 접근을 보여주기 전에 현재 서버 subscriber 상태로 구매와 복원을 확인합니다.

검증 및 문제 해결

실제 기기에서 제출할 artifact를 테스트하세요. 로그인 callback, session 복원, 구매와 복원, 서버 entitlement 갱신, workspace 전환, deep link, 오프라인 동작을 확인합니다. 로컬 Expo export는 스토어 제출용 빌드가 아닙니다.

build 번호, 스토어 track, 심사 상태, 대상 API 환경을 기록하세요. 심사 거부도 출시 과정의 일부입니다. 근거 없이 코드를 추측하지 말고 메타데이터나 기능 표시를 수정하세요.

다음은 Desktop 탭에서 같은 제품의 Tauri shell을 확인하세요.