zellyy-finance/src/app-deployment-guide.md

젤리의 적자탈출 앱 배포 가이드

준비 사항

1. 안드로이드 배포

   • Android Studio 설치
   • JDK 11 이상 설치
   • Google Play 개발자 계정 ($25 일회성 비용)

2. iOS 배포

   • Mac 컴퓨터
   • Xcode 최신 버전 설치
   • Apple Developer Program 가입 ($99/년)
   • iPhone 또는 iPad (테스트용)

배포 단계

1. 웹앱 빌드

npm run build

2. Capacitor 설치 및 초기화 (처음 한 번만)

npm install @capacitor/cli @capacitor/core
npx cap init

3. 네이티브 플랫폼 추가

npx cap add android
npx cap add ios  # Mac에서만 가능

4. Capacitor와 빌드된 웹앱 동기화

npx cap sync

5. 네이티브 IDE 열기

npx cap open android  # Android Studio 열기
npx cap open ios      # Xcode 열기 (Mac에서만 가능)

앱 아이콘 및 스플래시 스크린 설정

안드로이드 아이콘

• android/app/src/main/res/ 폴더 내 각 mipmap 폴더에 다양한 크기의 아이콘 배치
• 아이콘 크기:
  • mipmap-mdpi: 48x48 px
  • mipmap-hdpi: 72x72 px
  • mipmap-xhdpi: 96x96 px
  • mipmap-xxhdpi: 144x144 px
  • mipmap-xxxhdpi: 192x192 px

iOS 아이콘

• Xcode의 Assets.xcassets 내 AppIcon에 아이콘 설정
• 다양한 크기 필요 (20pt~83.5pt, @1x, @2x, @3x)

스토어 등록 정보 준비

공통 필요 자료

• 앱 설명 (짧은 설명 및 상세 설명)
• 스크린샷 (다양한 기기)
• 앱 아이콘 (고해상도)
• 개인정보 처리방침 URL

Google Play 스토어

• 앱 카테고리 선택
• 콘텐츠 등급 설문 작성
• 앱 가격 설정

Apple App Store

• App Store Connect에서 앱 등록
• 앱 심사 가이드라인 준수
• TestFlight를 통한 베타 테스트 권장

앱 빌드 및 제출

안드로이드

1. Android Studio에서 Build > Generate Signed Bundle/APK
2. 앱 서명 키 생성 또는 기존 키 사용
3. 앱 번들(AAB) 생성
4. Google Play Console을 통해 제출

iOS

1. Xcode에서 앱 인증서 및 프로비저닝 프로파일 설정
2. Product > Archive
3. App Store Connect에 업로드
4. 앱 심사 제출

중요 팁

• 배포 전 다양한 기기에서 앱 테스트 필수
• 앱 출시 후 지속적인 모니터링 및 업데이트 계획
• 사용자 피드백 수집 및 반영 메커니즘 구축