빌드 내역 목록 | 빌드 이력 | Appbox 콘솔 사용 가이드
빌드 내역 목록
- OS 타입 - Android 또는 iOS 표시
- 상태 - 빌드 버전 상태
- 앱 정보 - 앱 아이콘, 앱 이름, 패키지명/번들ID
- 버전 - 빌드 버전 정보
- 빌드 일시 - 빌드 생성 시간 (실패 시 시도 시간)
- 다운로드 - 빌드 파일 다운로드
- 해당 빌드가 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 빌드 성공시에는 APK 파일 및 AAB 파일 다운로드와 APK 다운로드 QR 팝업을 제공합니다.
- 각 파일의 용도에 따라 다운로드하여 사용하실 수 있습니다.
- Android 기기에 직접 설치 가능한 실행 파일입니다.
- 용도 : 개발 테스트, 사전 배포 단계에서 활용할 수 있습니다.
-
APK 설치 방법
-
Android 8 이상 버전
1-1. APK 설치 파일을 실행합니다.
1-2. [설치] > [무시하고 설치]를 선택하여 앱을 설치하여 테스트를 진행합니다. -
Android 8 이하 버전
2-1. [내 파일] 앱을 진입합니다.
2-2. 다운로드 받은 APK 파일을 클릭하여 설치합니다.
2-3. 설치가 차단되면 [설정] > [알 수 없는 출처]를 체크합니다.
2-4. [내 파일]에서 다운로드된 APK 파일을 설치하여 테스트를 진행합니다.
2-5. 다운로드된 APK 파일을 설치하여 테스트를 진행합니다.
-
Android 8 이상 버전
- AAB 파일은 Google Play Console에만 업로드 가능합니다.
- 직접 기기에 설치할 수 없으므로, 테스트할 때는 APK 파일을 사용해 주세요.
- 용도 : Google Play Store에 정식 출시할 때 필요합니다.
APK 다운로드 QR 팝업을 활용하면 여러 테스터에게 쉽고 빠르게 공유할 수 있으며, 기기 UUID 사전 등록 작업이 필요 없습니다.
- iOS 빌드 성공시에는 IPA 파일 다운로드와 TestFlight 이동 QR 팝업 두 가지 옵션을 제공합니다.
- 테스트 목적에는 TestFlight 업로드, 수동 관리 목적에는 IPA 파일 다운로드를 통해 활용할 수 있습니다.
- 빌드된 앱을 App Store Connect의 TestFlight로 업로드하여 개발 테스트 단계에서 활용할 수 있습니다.
- 빌드 완료후 [TestFlight 업로드]를 진행하지 않은 경우, QR 팝업 노출이 되지 않습니다.
- 용도 : 베타 테스트, 사전 배포 단계에서 활용할 수 있습니다.
- 소요 시간 : 약 3 ~ 5분 정도 소요됩니다.
- TestFlight 업로드 방법 : [가이드 보러 가기]
- 직접 기기에 설치할 수 없으므로, 테스트할 때는 TestFlight 업로드를 활용해 주세요.
- 용도 : App Store Connect에 수동 업로드하여 App Store에 출시할 수 있습니다.
TestFlight 이동 QR 팝업을 활용하면 여러 테스터에게 쉽고 빠르게 공유할 수 있습니다.