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

번들 ID(Bundle ID)

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

Apple 개발자 계정 권한
iOS 빌드 준비 작업은 Apple 개발자 팀의 계정 소유자(Account Holder) 또는 관리자(Admin)만 할 수 있습니다.
작업필요한 권한
App ID · App Group 등록,
기존 App ID 에 기능(App Groups · 푸시) 켜기		계정 소유자 또는 관리자
푸시용 APNs 키(.p8) 만들기계정 소유자 또는 관리자
App Store Connect API 키(Key ID · .p8) 만들기계정 소유자 또는 관리자
App Store Connect API 액세스 요청(팀에서 처음 한 번)계정 소유자만
  • 팀에서 API 키를 처음 만들 때는 계정 소유자가 먼저 [사용자 및 액세스 › 통합]에서 액세스를 요청해야 합니다. Apple 이 검토한 뒤 승인하니 미리 해 두세요.
  • 권한이 없다면 다음 중 하나로 진행하세요.
    ① 계정 소유자·관리자에게 내 역할을 「관리자」로 바꿔 달라고 요청합니다.
    ② 해당 단계만 계정 소유자·관리자에게 부탁하고, 결과(Issuer ID · Key ID · .p8 파일)를 안전한 방법으로 전달받습니다. .p8 파일은 다시 내려받을 수 없습니다.
    ③ 앱박스 등록 대행을 이용합니다(애플 개발자 권한 초대). 초대도 계정 소유자·관리자가 해야 합니다.
번들 ID
  • 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.NotificationService'에도 (13) ~ (15) 작업을 진행해 줍니다.
    empty

「애플 헬스 사용」을 켠 경우 — HealthKit 켜기

iOS 빌드 고급 설정에서 애플 헬스 사용을 켠 앱만 해당합니다. 위 단계를 마친 뒤 이어서 진행해 주세요.

  1. [Certificates, Identifiers & Profiles > Identifiers] 탭에서 앱박스 콘솔에서 자동 생성된 번들 ID의 'App ID'를 클릭합니다.
  2. Capabilities 목록에서 'HealthKit'을 체크합니다. 하위 항목(Clinical Health Records 등)은 켜지 않습니다.
  3. Save > Confirm 버튼을 클릭하여 저장합니다.

'.NotificationService' App ID 에는 HealthKit 을 켜지 않습니다. HealthKit 이 빠지면 빌드가 「HealthKit 기능 누락」 오류로 끝납니다.

기존 운영중인 앱이 있는 경우
  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

「애플 헬스 사용」을 켠 경우 — HealthKit 켜기

iOS 빌드 고급 설정에서 애플 헬스 사용을 켠 앱만 해당합니다. 위 단계를 마친 뒤 이어서 진행해 주세요.

  1. [Certificates, Identifiers & Profiles > Identifiers] 탭에서 현재 App Store에서 사용하고 있는 번들 ID의 'App ID'를 클릭합니다.
  2. Capabilities 목록에서 'HealthKit'을 체크합니다. 하위 항목(Clinical Health Records 등)은 켜지 않습니다.
  3. Save > Confirm 버튼을 클릭하여 저장합니다.

'.NotificationService' App ID 에는 HealthKit 을 켜지 않습니다. HealthKit 이 빠지면 빌드가 「HealthKit 기능 누락」 오류로 끝납니다.

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

앱 데모체험
지금 웹사이트 주소를 입력하고
데모 앱을 체험해 보세요!
앱으로 바꾸고 싶은 당신의 웹사이트 주소를 입력해 보세요. 즉각 체험할 수 있는 데모 앱을 받을 수 있습니다.

QR 코드
QR 코드를 찍고 앱으로 바뀐
웹사이트를 지금 바로 확인해 보세요!
www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.