iOS 번들 ID(Bundle ID) 설정 | Apple Developer 가이드

번들 ID(Bundle ID)

번들 ID를 생성하기 위해서는 Apple 개발자 계정 생성 및 멤버십 구매가 선행되어야 합니다.

  • iOS 앱을 식별하는 고유 ID입니다. App Store에서 앱을 구분하는 기준이 되며, 한 번 스토어에 등록되면 변경할 수 없습니다.
  • 자동생성 형식은 com.회사명.앱ID 와 같은 역도메인 표기법을 사용하며, 소문자/숫자/점(.)만 사용할 수 있습니다.
  • 앱을 스토어에서 운영중입니다.를 선택한 경우, 직접 번들 ID를 입력하실 수 있습니다.
  • 앱박스 콘솔에서 한번 빌드한 이후에는 이전 빌드에 사용된 번들 ID를 자동으로 불러옵니다.
  • 정상적으로 빌드를 완료하기 위해서는 Apple Developer에서 번들 ID 등록 작업이 필요합니다.
  • 자동 생성/수동 입력과 상관없이 FCM 설정을 완료하면 Json 파일의 번들 ID 값을 최우선으로 덮어 씌웁니다.
  • 아래 내용들을 통해 빌드 앱의 번들 ID를 App Store Connect와 연동할 수 있습니다.
앱을 처음 생성한 경우(번들 ID 자동 생성)
  1. Apple Developer에서 [계정] 페이지로 이동합니다.
    empty
  2. [프로그램 리소스 > 인증서, ID 및 프로파일 > 식별자(영문)] 페이지로 이동합니다.
    empty
  3. [Certificates, Identifiers & Profiles > Identifiers] 탭으로 이동 후, Identifier 우측의 [+] 버튼을 클릭합니다.
    empty
  4. 'App Groups' 항목을 선택 후, Continue 버튼을 클릭합니다.
    empty
  5. 그룹에 대한 설명(Description)과 식별자(Identifier)를 작성하고 Continue > Register 버튼을 클릭합니다.
    empty

    반드시 식별자(Identifier)group.{앱박스 콘솔에서 자동 생성된 번들 ID}로 설정해야 합니다.

  6. 다시 [Certificates, Identifiers & Profiles > Identifiers] 탭으로 이동 후, Identifier 우측의 [+] 버튼을 클릭합니다.
    empty
  7. 'App ID' 항목을 선택 후, Continue 버튼을 클릭합니다.
    empty
  8. 'App' 항목을 선택 후, Continue 버튼을 클릭합니다.
    empty
  9. 'App Groups''Push Notifications'를 체크합니다.
    empty
  10. 앱 설명(Description)과 {앱박스 콘솔에서 자동 생성된 번들 ID} 입력 후 Continue > Register 버튼을 클릭합니다.
    empty
  11. (6) ~ (9) 과정을 반복하신 후, (10)에서 입력한 번들 ID에 '.NotificationService'를 추가하고, Continue > Register 버튼을 클릭합니다.
    empty
  12. [Certificates, Identifiers & Profiles > Identifiers] 탭으로 이동 후, (6) ~ (10)에서 진행한 'App ID'를 클릭하여 [Edit Your App ID Configuration] 탭으로 이동합니다.
    empty
  13. 'App Groups' 우측의 Configure 버튼을 클릭합니다.
    empty
  14. (5)에서 만들었던 'App Groups' 를 체크하고 Continue 버튼을 클릭합니다.
    empty
  15. Save > Confirm 버튼을 클릭하여 저장합니다.
    empty
  16. (11)에서 생성한 '자동 생성 번들 ID.NotificaitionService'에도 (13) ~ (15) 작업을 진행해 줍니다.
    empty
기존 운영중인 앱이 있는 경우
  1. Apple Developer에서 [계정] 페이지로 이동합니다.
    empty
  2. [프로그램 리소스 > 인증서, ID 및 프로파일 > 식별자(영문)] 페이지로 이동합니다.
    empty
  3. [Certificates, Identifiers & Profiles > Identifiers] 탭으로 이동 후, Identifier 우측의 [+] 버튼을 클릭합니다.
    empty
  4. 'App Groups' 항목을 선택 후, Continue 버튼을 클릭합니다.
    empty
  5. 그룹에 대한 설명(Description)과 식별자(Identifier)를 작성하고 Continue > Register 버튼을 클릭합니다.
    empty

    반드시 식별자(Identifier)group.{기존 사용중인 번들 ID}로 설정해야 합니다.

  6. 다시 [Certificates, Identifiers & Profiles > Identifiers] 탭으로 이동 후, Identifier 우측의 [+] 버튼을 클릭합니다.
    empty
  7. 'App ID' 항목을 선택 후, Continue 버튼을 클릭합니다.
    empty
  8. 'App' 항목을 선택 후, Continue 버튼을 클릭합니다.
    empty
  9. 'App Groups''Push Notifications'를 체크합니다.
    empty
  10. 앱 설명(Description) 작성 및 Bundle ID 입력란에 현재 App Store에서 사용하고 있는 번들 ID를 입력 후 뒤에 '.NotificationService'를 추가합니다.
    empty
  11. Continue > Register 버튼을 클릭합니다.
    empty
  12. [Certificates, Identifiers & Profiles > Identifiers] 탭으로 이동 후, (6) ~ (11)에서 진행한 'App ID'를 클릭하여 [Edit Your App ID Configuration] 탭으로 이동합니다.
    empty
  13. 'App Groups' 우측의 Configure 버튼을 클릭합니다.
    empty
  14. (5)에서 만들었던 'App Groups' 를 체크하고 Continue 버튼을 클릭합니다.
    empty
  15. Save > Confirm 버튼을 클릭하여 저장합니다.
    empty
  16. [Certificates, Identifiers & Profiles > Identifiers] 탭으로 이동 후, 현재 App Store에서 사용하고 있는 번들 ID의 'App ID'를 클릭하여 [Edit Your App ID Configuration] 탭으로 이동합니다.
    empty
  17. 'App Groups'를 체크하고 우측의 Configure 버튼을 클릭합니다.
    empty
  18. (5)에서 만들었던 'App Groups' 를 체크하고 Continue 버튼을 클릭합니다.
    empty
  19. 'Push Notifications'를 체크합니다.
    empty
  20. Save > Confirm 버튼을 클릭하여 저장합니다.
    empty

번들ID를 잘못 입력하면 기존 스토어 앱과 연결되지 않아 업데이트가 아닌 신규 앱으로 등록될 수 있습니다.

www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.