식별자와 버전

앱을 스토어에 올리면 식별자(이 앱이 무엇인지)와 버전(몇 번째 판인지)이 스토어에 기록됩니다. 식별자는 한 번 올리면 바꿀 수 없는 곳이 많고, 빌드 번호는 스토어마다 규칙이 있으며(아래 「스토어별 규칙」) 이미 쓴 값을 다시 쓸 수 없는 곳이 있으니 첫 업로드 전에 정해 두세요.

준비물

• 식별자로 쓸 이름 — 소유한 도메인을 거꾸로 적은 형태가 기본입니다. 도메인이 mycompany.com 이면 com.mycompany.myapp 처럼 씁니다.
• 스토어 계정 — 개발자 계정을 먼저 준비합니다. Apple 은 번들 ID 를 계정에 등록하고, Microsoft 는 앱 이름을 예약한 뒤 파트너 센터에서 패키지 식별 정보를 확인합니다.
• Flutter 프로젝트의 pubspec.yaml — 버전은 이 파일의 version: 한 줄에서 시작합니다.

식별자

버전 번호

버전은 pubspec.yaml 한 곳에서 정합니다.

version: 1.2.3+4

+ 앞의 점으로 이은 숫자 세 개가 버전 이름(build name, 사용자에게 보이는 번호)이고, + 뒤의 숫자가 빌드 번호(build number, 스토어가 어느 빌드가 더 새로운지 가리는 번호)입니다. 빌드할 때 --build-name 과 --build-number 로 덮어쓸 수 있습니다.

Windows 의 Microsoft Store 용 MSIX 패키지는 이 표와 다르게 패키징 때 버전을 따로 정합니다(msix_config 의 msix_version, a.b.c.d 형식). msix 패키지(3.18.0 기준)는 MSIX 버전을 --version 옵션 → msix_version → pubspec 의 x.y.z 뒤에 .0 을 붙인 값의 순서로 정하고, pubspec 의 +빌드번호 는 버립니다. 그래서 + 뒤 숫자만 올리면 MSIX 버전이 그대로이니, 업데이트에는 msix_version(또는 pubspec 의 x.y.z)을 올리세요. 스토어 규칙상 첫 자리는 0 이 될 수 없으니, pubspec 의 버전이 0. 으로 시작하면 msix_version 을 직접 정하세요. 아래 규칙도 보세요.

스토어별 규칙

단계

1. 식별자를 정합니다. 소유 도메인을 거꾸로 쓴 이름을 정합니다(예: com.mycompany.myapp). 스토어마다 규칙이 다르니 위 표의 문자 규칙을 지키세요.

2. Flutter 프로젝트에 식별자를 맞춥니다. 위 표의 파일에서 com.example… 기본값을 바꿉니다. 바꾼 뒤 flutter run 으로 앱이 빌드되고 실행되면 성공입니다.

3. 스토어에 식별자를 등록합니다. Apple 은 개발자 계정의 Certificates, Identifiers & Profiles 에서 Explicit App ID 로 번들 ID 를 등록하고 App Store Connect 의 앱 레코드에 연결합니다. Microsoft 는 파트너 센터에서 앱 이름을 예약한 뒤 「제품 관리 → 제품 ID」 의 패키지 이름 · 게시자 · 게시자 표시 이름을 확인합니다. Google Play 의 패키지 이름은 앱의 applicationId 이고, 앱의 첫 아티팩트(번들)를 올리고 나면 고정되어 바꿀 수 없습니다. 고유하고 영구적이라 삭제하거나 다시 쓸 수도 없습니다.

4. 버전을 올립니다. 새 릴리스를 올릴 때마다 pubspec.yaml 의 version: 을 올립니다. 예: 1.0.0+1 → 1.0.1+2. 빌드 번호는 버전 이름이 같더라도 올리세요.

5. 빌드해 결과를 확인합니다. 아래 명령으로 스토어에 올릴 산출물을 만듭니다.

   bash

   flutter build appbundle --build-name=1.0.1 --build-number=2   # Android → build/app/outputs/bundle/release/ 폴더의 .aab
   flutter build ipa --build-name=1.0.1 --build-number=2         # iOS → build/ios/archive 와 build/ios/ipa
   flutter build macos --build-name=1.0.1 --build-number=2       # macOS → Xcode 에서 Archive 로 이어 갑니다
   

   Windows 는 msix_config 에 msix_version: 1.0.1.0 처럼 네 번째 자리를 0 으로 정한 뒤 dart run msix:create --store 를 실행합니다.

확인

• 업로드한 빌드가 각 콘솔의 빌드(패키지) 목록에 나타나고, 버전 이름과 빌드 번호가 방금 정한 값과 같습니다.
• 이전에 올린 빌드와 번호가 겹치지 않습니다. Google Play 는 이미 쓴 versionCode 의 업로드를 막습니다.

자주 겪는 문제

다음 단계

식별자와 버전이 정해졌으면 스토어에 보일 이미지를 준비합니다. 아이콘 · 스플래시 · 스크린샷으로 이어서 진행하세요.