빌드 내역 목록 | 빌드 이력 | Appbox 콘솔 사용 가이드

빌드 내역 목록

빌드 이력 페이지에는 각 빌드마다 다음의 정보가 표시됩니다.
  • OS 타입 - Android 또는 iOS 표시
  • 상태 - 빌드 버전 상태
  • 앱 정보 - 앱 아이콘, 앱 이름, 패키지명/번들ID
  • 버전 - 빌드 버전 정보
  • 빌드 일시 - 빌드 생성 시간 (실패 시 시도 시간)
  • 다운로드 - 빌드 파일 다운로드
OS 타입
  • 해당 빌드가 Android 인지 iOS 인지 표시합니다.
상태
  • 해당 빌드의 상태를 나타냅니다.
  • 성공 : 빌드가 정상적으로 완료되어 파일 다운로드 및 QR 팝업을 확인할 수 있습니다.
  • 실패 : 빌드에 실패하여, 실패 사유를 확인하고 재빌드가 필요한 상태입니다.
  • 빌드중 : 빌드가 진행 중이며, 빌드가 완료될 때까지의 상태입니다.
  • TF 성공 : 테스트플라이트 업로드가 정상적으로 완료되어 QR 코드를 통해 테스트플라이트 링크로 이동할 수 있습니다.
  • TF 실패 : 테스트플라이트 업로드에 실패하여, 실패 사유를 확인하고 재요청이 필요한 상태입니다.
  • TF 업로드중 : 테스트플라이트 업로드가 진행 중이며, 평균 2~3분의 시간이 소요됩니다.
앱 정보
  • 해당 빌드의 앱 정보를 표시합니다.
  • 앱 아이콘 : 기본 설정에서 지정한 앱 아이콘을 노출합니다.
  • 앱 이름 : 기본 설정에서 지정한 앱 이름을 노출합니다.
  • 패키지명/번들ID : 앱의 패키지명 또는 번들 ID를 노출합니다.
버전
  • 해당 빌드의 버전 정보를 표시합니다.
  • Android의 경우 : 버전 이름 (예: 1.0.0) / 버전 코드 (예: 1)
  • iOS의 경우: : 앱 버전 (예: 1.0.0) / 빌드 번호 (예: 1)
  • 이 정보로 여러 빌드 중에서 원하는 버전을 빠르게 찾을 수 있습니다.
빌드 일시
  • 해당 빌드가 생성/시도된 시간을 표시합니다.
  • 빌드 성공시 : 빌드 완료 시간을 표시합니다.
  • 빌드 실패시 : 빌드 시도 시간을 표시합니다.
다운로드
  • 성공한 빌드에 대해 파일을 다운로드하거나 QR 팝업을 통해 TestFlight으로 이동할 수 있습니다.
  • 빌드 실패시 : 다운로드 불가 (재빌드 필요)
파일 형식 요약
OS 파일 형식 용도 다운로드 방법 직접 설치
Android APK 개발 테스트, 베타 배포 [APK 다운로드], QR 팝업 가능
AAB Google Play Store 정식 출시 [AAB 다운로드], QR 팝업 불가
iOS TestFlight 이동 베타 테스트 (권장) TestFlight 이동 팝업(QR) 가능
IPA App Store Connect 수동 업로드 [IPA 다운로드] 불가
Android 빌드
  • Android 빌드 성공시에는 APK 파일 및 AAB 파일 다운로드와 APK 다운로드 QR 팝업을 제공합니다.
  • 각 파일의 용도에 따라 다운로드하여 사용하실 수 있습니다.
1️⃣ APK 파일 (Android Package)
  • Android 기기에 직접 설치 가능한 실행 파일입니다.
  • 용도 : 개발 테스트, 사전 배포 단계에서 활용할 수 있습니다.
  • APK 설치 방법
    1. Android 8 이상 버전
      1-1. APK 설치 파일을 실행합니다.
      1-2. [설치] > [무시하고 설치]를 선택하여 앱을 설치하여 테스트를 진행합니다.
    2. Android 8 이하 버전
      2-1. [내 파일] 앱을 진입합니다.
      2-2. 다운로드 받은 APK 파일을 클릭하여 설치합니다.
      2-3. 설치가 차단되면 [설정] > [알 수 없는 출처]를 체크합니다.
      2-4. [내 파일]에서 다운로드된 APK 파일을 설치하여 테스트를 진행합니다.
      2-5. 다운로드된 APK 파일을 설치하여 테스트를 진행합니다.
2️⃣ AAB 파일 (Android App Bundle)
  • AAB 파일은 Google Play Console에만 업로드 가능합니다.
  • 직접 기기에 설치할 수 없으므로, 테스트할 때는 APK 파일을 사용해 주세요.
  • 용도 : Google Play Store에 정식 출시할 때 필요합니다.

APK 다운로드 QR 팝업을 활용하면 여러 테스터에게 쉽고 빠르게 공유할 수 있으며, 기기 UUID 사전 등록 작업이 필요 없습니다.

iOS 빌드
  • iOS 빌드 성공시에는 IPA 파일 다운로드와 TestFlight 이동 QR 팝업 두 가지 옵션을 제공합니다.
  • 테스트 목적에는 TestFlight 업로드, 수동 관리 목적에는 IPA 파일 다운로드를 통해 활용할 수 있습니다.
1️⃣ TestFlight 자동 업로드 (권장) ⭐
  • 빌드된 앱을 App Store Connect의 TestFlight로 업로드하여 개발 테스트 단계에서 활용할 수 있습니다.
  • 빌드 완료후 [TestFlight 업로드]를 진행하지 않은 경우, QR 팝업 노출이 되지 않습니다.
  • 용도 : 베타 테스트, 사전 배포 단계에서 활용할 수 있습니다.
  • 소요 시간 : 약 3 ~ 5분 정도 소요됩니다.
  • TestFlight 업로드 방법 : [가이드 보러 가기]
2️⃣ IPA 파일 (iOS App)
  • 직접 기기에 설치할 수 없으므로, 테스트할 때는 TestFlight 업로드를 활용해 주세요.
  • 용도 : App Store Connect에 수동 업로드하여 App Store에 출시할 수 있습니다.

TestFlight 이동 QR 팝업을 활용하면 여러 테스터에게 쉽고 빠르게 공유할 수 있습니다.

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