콘텐츠로 이동

모바일 앱 업데이트하기

대부분의 업데이트는 publish하면 즉시 반영됩니다. 메타데이터나 네이티브 셸 변경 사항만 새로운 앱 스토어 심사가 필요합니다.

Proyecta 앱을 PWA로 래핑하여 앱 스토어에 제출했다면, 업데이트는 변경하는 내용에 따라 두 가지 방식으로 작동합니다.

Tier 1: 콘텐츠 및 기능 업데이트 (즉시 반영)

섹션 제목: “Tier 1: 콘텐츠 및 기능 업데이트 (즉시 반영)”

래핑된 PWA는 실제 콘텐츠를 publish된 Proyecta URL에서 불러오기 때문에, 대부분의 업데이트는 새로운 앱 스토어 빌드가 필요하지 않습니다:

  1. Proyecta builder에서 변경 사항을 작업합니다
  2. builder 툴바에서 Publish를 클릭합니다
  3. 사용자가 다음번에 앱을 열면 변경 사항이 반영됩니다

이 방식에 해당하는 항목:

  • 새로운 페이지, 기능, 레이아웃
  • 버그 수정
  • 텍스트 및 이미지 변경
  • Backend 로직 변경
  • 데이터베이스 스키마 변경
  • 대부분의 스타일 수정

이는 PWA 래퍼 모델의 가장 큰 장점 중 하나입니다 — 일반적인 제품 작업을 위해 심사 대기열을 기다릴 필요가 없습니다.

Tier 2: 네이티브 셸 업데이트 (새로운 제출 필요)

섹션 제목: “Tier 2: 네이티브 셸 업데이트 (새로운 제출 필요)”

일부 변경 사항은 래퍼를 재생성하고 새 패키지를 제출해야 합니다:

  • 아이콘 아래 표시되는 앱 이름
  • 앱 아이콘 자체
  • 스플래시 화면
  • 래퍼에 내장된 매니페스트 항목 (테마 색상, 디스플레이 모드, 화면 방향 고정)
  • 네이티브 권한 선언 (Info.plist 또는 AndroidManifest.xml에 새 항목이 필요한 카메라, 위치 등)
  • 래퍼 버전 업그레이드

이 경우:

  1. publish된 URL로 pwabuilder.com에서 패키지를 재생성합니다
  2. 처음에 사용한 것과 동일한 서명 키로 서명합니다 (매우 중요 — 아래 참고)
  3. Google Play Console, App Store Connect, 또는 Partner Center를 통해 제출합니다
  4. 심사를 기다립니다

Android 앱 업데이트에서 가장 중요한 점은 모든 업데이트를 첫 번째 버전에 사용한 것과 동일한 키로 서명해야 한다는 것입니다. signing.keystore를 잃어버리면 Google Play는 이후 업데이트를 일절 허용하지 않습니다. 그럴 경우 다른 패키지 이름으로 완전히 새로운 앱을 publish하고 사용자를 마이그레이션해야 합니다.

iOS의 경우, 프로비저닝 프로파일과 배포 인증서는 Bundle ID에 연결되어 있습니다. 인증서를 취소하면 새로 생성할 수 있지만, 업데이트 제출 시 지연을 피하기 위해 프로파일을 미리 백업해 두는 것이 좋습니다.

새 패키지를 제출할 때는 앱의 사용자 대면 버전 번호를 Proyecta deploy와 동기화하세요. 그렇지 않으면 사용자가 crash 리포트가 새 빌드에서 발생한 것인지 이전 빌드에서 발생한 것인지 구분하기 어렵습니다.

  • 재생성, 서명, 제출을 한 번에 처리하는 builder 내 업데이트 마법사
  • Proyecta 버전 기록과 동기화되는 버전 매니페스트 추적