Appbox 콘솔 iOS 앱 빌드 | App Store 업로드

iOS 앱 빌드

iOS 앱 빌드를 완료하기 위해서는 반드시 Apple Developer 앱 생성이 선행되어야 합니다.

iOS 앱 빌드는 클라우드 환경에서 iOS 앱을 자동으로 컴파일하고 패키징하는 기능입니다.
앱박스 콘솔에서는 빌드 설정, 버전 관리까지 한 번에 관리할 수 있습니다.

빌드 프로세스

앱박스 iOS 앱 빌드는 6단계로 진행됩니다. 각 단계에서 입력하는 정보에 따라 빌드 결과물이 결정됩니다.
가이드에서는 각 단계에 대한 설명을 지원하며, 빌드 순서는 콘솔의 스탭을 따라 진행해 주세요.

• 1단계 : OS 선택 : OS 선택 및 빌드 케이스 선택
• 2단계 : 기본 설정 : 앱 기본 정보 등록
• 3단계 : 버전 관리 : 빌드 버전, 빌드 번호 설정
• 4단계 : 디자인 설정 : 주요 화면 요소 설정
• 5단계 : 고급 설정 : SNS 로그인, 앱 스킴 연동
• 6단계 : 앱 빌드 : 번들 ID, Apple 인증 정보 설정

1단계 : OS 선택

1단계에서는 빌드할 OS와 빌드 케이스를 선택합니다.

OS 선택

• OS 선택 : iOS를 선택합니다.

빌드 케이스

• 앱을 처음 생성합니다. : 앱을 신규 생성하는 경우입니다.
• 앱을 스토어에서 운영중입니다. : 기존 앱을 스토어에서 운영중이지만, 앱박스 콘솔에서 처음 빌드하는 경우입니다.
• 기존 앱을 업데이트합니다. : 앱박스에서 한번이라도 빌드한 경우, 자동으로 해당 케이스가 선택됩니다.

빌드 케이스 선택에 따라 이후 단계의 입력 방식이 달라집니다.

2단계 : 기본 설정

앱의 기본 정보를 입력하는 단계입니다.
(기본 설정 단계는 모든 빌드 케이스가 동일합니다)

앱 아이콘

• 스토어에서 사용자에게 표시되는 앱 아이콘 이미지입니다.
• 형식 : 투명도가 없는 PNG 또는 JPG
• 크기 : 1024×1024px
• 파일 크기 : 최대 1MB

앱 이름

• 스토어에서 표시되는 앱의 이름입니다.
• 한글/영문 최대 20자까지 입력 가능합니다.

웹 사이트 (도메인)

• 앱으로 빌드할 고객님의 웹사이트 도메인입니다.
• 도메인에 따라 프로토콜(https/http)을 구분해서 입력해야 합니다.
• 경로는 포함하지 않는 것을 권장합니다.

3단계 : 버전 관리

앱의 버전 정보를 설정/관리합니다.

앱 버전 (스토어 표시 버전 / CFBundleShortVersionString)

• 사용자에게 노출되는 앱의 버전 번호입니다. App Store 페이지나 아이폰 설정 화면에 표시됩니다.
• 앱박스에서는 X.Y.Z 형태의 시맨틱 버저닝(Semantic Versioning)을 사용합니다. (예: 1.0.0, 1.0.1, 1.1.0, 2.0.0)
• 기본값은 자동 생성 (권장)입니다. 이전 빌드의 끝자리 수에 자동으로 +1 증가합니다.
• 필요 시 수동 입력으로 전환하여 원하는 버전이름을 직접 입력할 수 있습니다.
• App Store에 업로드 시 이전 버전보다 크게 입력하는 것을 권장합니다.

빌드 번호(CFBundleVersion)

• 앱의 내부 버전 번호입니다. 스토어에 업로드할 때 순서를 관리하기 위한 번호이며, 사용자에게는 보이지 않습니다.
• 앱박스 콘솔에서는 정수만 사용할 수 있으며, App Store Connect에 등록된 앱의 빌드 번호보다 반드시 큰 값이어야 합니다.
• 기본값은 자동 생성 (권장)입니다. 이전 빌드의 빌드 번호보다 자동으로 +1 증가합니다.
• 필요할 경우 수동 입력으로 전환하여 직접 빌드 번호를 입력할 수 있습니다.

앱을 스토어에서 운영중인 경우, 버전을 수동으로 입력하여 이전 버전과 충돌이 생기지 않게 유의하세요.

4단계 : 디자인 설정

앱의 화면 요소를 설정합니다.
선택기능이며, 사용이 필요한 경우에만 가이드에 따라 설정을 완료해 주세요.

스플래시

• 앱을 실행시켰을 때 가장 처음 보는 화면이며, 앱의 첫인상을 결정하고 브랜드 아이덴티티를 표현할 수 있습니다.
• 최소 2초에서 최대 로고 이미지의 재생 길이만큼 노출됩니다.
• 배경 이미지 : 선택값이며, 비율에 따라 디바이스의 전체를 덮도록 표시합니다.
• 배경 색상 : 배경 영역의 색상입니다. 투명도를 지원하지 않습니다.
• 로고 이미지 : 선택값이며, 동적이미지를 지원합니다.
• 정렬 : 가로 정렬과 세로 정렬을 지원합니다.
• 영역 크기 : 이미지의 영역(크기)을 조절합니다.

로딩 인디케이터

• 데이터를 불러오는 동안 표시되는 로딩 UI입니다.
• 인디케이터 색상과 배경색을 설정하여 앱의 디자인에 맞게 커스터마이징 할 수 있습니다.
• 기본 : Android 기본 OS 로딩 인디케이터의 설정을 변경합니다.
• 커스터마이징 : 원하는 이미지를 로딩 인디케이터로 설정합니다.

당겨서 새로고침

• 화면을 위에서 아래로 잡아 당겨 페이지를 새로고침하는 기능입니다.

5단계 : 고급 설정

SNS 로그인 연동과 앱 스킴 설정 등 선택적 고급 기능을 설정합니다.
선택기능이며, 사용이 필요한 경우에만 가이드에 따라 설정을 완료해 주세요.

SNS 로그인 연동

• 앱에서 소셜 로그인 기능을 지원하고 싶을 때 선택합니다.
• 각 SNS 로그인 연동 가이드를 통해 연동 방법을 확인하세요.
• 구글(Google) 로그인 연동 가이드 보기
• 애플(Apple) 로그인 연동 가이드 보기
• 카카오(Kakao) 로그인 연동 가이드 보기
• 네이버(Naver) 로그인 연동 가이드 보기

애플 헬스 사용

• 아이폰, 애플 워치 등 건강 앱에서 수집된 건강 및 피트니스 데이터를 제공하는 Apple 표준 프레임워크입니다.
• 앱 빌드 과정에서 사용 설정을 On으로 설정 후, 애플 헬스 연동 작업을 진행해야 합니다.

딥링크 사용

• 앱이 설치된 사용자는 앱 내 특정 화면으로, 미설치 사용자는 앱 스토어로 자동 이동시킬 수 있습니다.
• 딥링크를 사용하려면 아래 항목을 설정해야 합니다.
• AppsFlyer Dev Key : AppsFlyer와 앱을 연동하기 위한 고유 인증 키입니다.
• URI 스킴 : 앱을 실행하기 위한 커스텀 URL 스킴입니다. 앱 스킴 설정에서 입력한 '내 앱 스킴'과 값을 공유합니다.
• Apple Id : AppStore에 등록된 앱의 고유 ID입니다. Apple Id 확인 작업을 진행해야 합니다.

자세한 사용 방법은 AppsFlyer(딥링크) 연동 가이드를 확인해 주세요.

앱 스킴 설정

• 외부 웹 사이트, 이메일, SMS, 다른 앱 등에서 내 앱을 직접 열고 특정 화면으로 이동시킬 수 있는 고유 주소입니다.
• 광고/SNS에서 앱 내 특정 기능으로 직접 유도가 가능합니다.
• 웹에서 앱으로 매끄러운 전환이 가능합니다.
• 푸시,인앱 메시지와 같은 알림 서비스와 연동하여 원하는 화면으로 이동이 가능합니다.

내 앱 스킴 설정

• 외부의 웹 사이트나 다른 앱에서 내 앱을 직접 열 수 있도록 하는 고유 주소 형식입니다.
• 앱이 설치되어 있는 경우, 사용자가 링크를 클릭하면 자동으로 앱이 열리고 해당 화면으로 이동합니다.
• 알파벳 소문자(a-z)로 시작해야 합니다.
• 숫자, 하이픈(-), 닷(.)을 포함 가능합니다.
• 공백, 예약어(https, https, tel, sms, file 등)는 사용이 불가능합니다.

외부 앱 스킴 설정

• 내 앱에서 다른 앱(카카오톡 네이버, 구글 등)을 열기 위해 그 앱의 스킴을 등록하는 것입니다.
• 최대 10개의 외부 앱 스킴을 설정할 수 있습니다.

고급 설정은 선택 기능이며, 앱에 적용시키기 위해서는 앱을 새로 빌드해야 합니다.

6단계 : 앱 빌드

iOS 앱의 번들 ID와 Apple 인증 정보를 설정하는 단계입니다.
빌드 케이스에 따라 입력/수정 가능 여부가 달라집니다.

번들 ID(Bundle ID)

• iOS 앱을 식별하는 고유 ID입니다. App Store에서 앱을 구분하는 기준이 되며, 한 번 스토어에 등록되면 변경할 수 없습니다.
• 자동생성 형식은 com.회사명.앱ID 와 같은 역도메인 표기법을 사용하며, 소문자/숫자/점(.)/하이픈(-)만 사용할 수 있습니다.
• 앱을 스토어에서 운영중입니다.를 선택한 경우, 직접 번들 ID를 입력하실 수 있습니다.
• 앱박스 콘솔에서 한번 빌드한 이후에는 이전 빌드에 사용된 번들 ID를 자동으로 불러옵니다.
• 정상적으로 빌드를 완료하기 위해서는 Apple Developer에서 번들 ID 등록 작업이 필요합니다.
• 앱을 처음 생성한 경우, 번들 ID 등록 가이드 보기
• 기존 운영중인 앱이 있는 경우, 번들 ID 연동 가이드 보기
• 자동 생성/수동 입력과 상관없이 FCM 설정을 완료하면 Json 파일의 번들 ID 값을 최우선으로 덮어 씌웁니다.

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

Team ID

• Team ID, Issuer ID, Key ID를 생성/확인하기 위해서는 Apple 개발자 계정 생성 및 멤버십 구매가 필수 선행되어야 합니다.
• Apple Developer Team을 식별하는 고유 ID입니다. 빌드 및 배포 권한 검증에 필수입니다.
• 형식 : 10자의 영문/숫자 조합 (예: ABCDEF1234)
• Team ID 확인 방법 보기

Issuer ID

• Apple 개발자 계정에서 앱 배포 권한을 식별하는 고유 ID입니다.
• App Store Connect API와 빌드 인증에 필요합니다.
• 형식 : UUID (예시: 12345678-1234-1234-1234-123456789012)
• Issuer ID 확인 방법 보기

Key ID 파일

• App Store Connect API에 접근하기 위한 개인 키를 식별하는 ID입니다. 빌드 배포 및 메타데이터 관리에 필요합니다.
• Key ID 생성 방법 보기

빌드하기

• 5단계까지의 모든 설정을 완료한 뒤 [빌드하기] 버튼을 클릭하면 앱 빌드가 시작됩니다.
• 예상 빌드 시간은 약 5분이며, 서버 상황에 따라 다소 지연될 수 있습니다.

빌드 성공

• 빌드가 정상적으로 완료되면 빌드 완료 메시지와 함께 빌드 완료 팝업이 표시됩니다.
• 빌드 완료 팝업에서는 IPA 파일 다운로드와 빌드된 앱의 TestFlight 업로드 방법을 제공합니다.
• 빌드 완료 후에는 빌드 이력 메뉴에서 해당 빌드 버전 확인과 IPA 다운로드 및 TestFlight 이동 QR 팝업 을 확인할 수 있습니다.
  (TestFlight 업로드 설정을 진행하지 않은 경우, QR 팝업은 노출되지 않습니다.)

빌드에 성공한 앱을 통해 푸시 메시지와 인앱 메시지를 이용하실 수 있습니다.

빌드 실패

• 빌드에 실패하면 ❌ 빌드 실패 화면이 표시되며, 실패 사유(에러 메시지)가 안내됩니다.
• 빌드 실패 시 [재설정 후 빌드하기] 버튼을 통해 앱 빌드 단계로 넘어가, 수정하여 재시도할 수 있습니다.

TestFlight 업로드

• TestFlight는 Apple이 제공하는 공식 베타 테스팅 플랫폼입니다.
• 앱을 App Store에 정식 출시하기 전에, 사용자들에게 테스트용 앱을 배포할 수 있습니다.
• TestFlight 업로드 설정 방법 보기

반드시 TestFlight 업로드 설정을 마친 후, [TestFlight 업로드] 버튼을 클릭해야 정상적으로 완료됩니다.