실용 가이드

Bundle ID, 버전, 빌드 번호: 무엇을 바꿔야 할까요?

1.2.0(18)을 예로 앱 식별자, 출시 버전, 개별 빌드를 구분합니다.

확인 날짜 ·EasyIPA

01

앱 식별 정보

Bundle ID는 com.example.reader 같은 앱 식별자입니다. CFBundleShortVersionString은 출시 버전, CFBundleVersion은 빌드 번호입니다. Apple은 패키지 정보로 업로드를 연결합니다. 파일명 대신 빌드 설정과 내보낸 IPA를 확인하고, 일반 업데이트에서 Bundle ID를 임의로 바꾸지 마세요.

02

같은 버전의 수정 빌드

버전 1.2.0의 빌드 18을 올렸다면 수정본은 1.2.0의 빌드 19로 만들 수 있습니다. 컴파일, 아카이브, 내보내기 전에 값을 설정하고 다시 생성한 뒤 App Store Connect에서 확인하세요. 파일 이름을 app19.ipa로 바꿔도 내부 번호는 바뀌지 않습니다. 서명된 패키지를 직접 수정하지 마세요.

03

새 출시 버전 준비

1.3.0을 출시하려면 프로젝트와 App Store Connect의 플랫폼 및 버전 레코드를 맞추세요. iOS와 macOS의 출시 일정이 다를 수 있으므로 기록에 플랫폼을 포함합니다. 팀에서 빌드 번호 규칙을 정해 여러 담당자가 같은 번호를 재사용하지 않도록 하세요.

04

중복 빌드 오류 조사

오류, 패키지 정보, 이전 빌드, CI 로그를 대조하세요. 개발자에게 Bundle ID, 플랫폼, 버전, 빌드 번호, 업로드 시간, 원문 오류를 전달합니다. 도구를 계속 바꾸기보다 원인을 확인하고 다시 빌드하세요. EasyIPA는 기존 IPA를 올리며 버전과 서명은 패키지 생성 과정에서 관리합니다.

공식 참고 자료

Set the version number and build string Upload builds
← 가이드와 업데이트