SDK 초기화 | 초기화와 모듈 확인 | Appbox Android SDK 가이드

SDK 초기화

SDK와 사용할 기능 모듈을 초기화합니다. 호출 위치와 설정 절차는 3단계: Manifest와 초기화에서 다루고, 이 문서는 인자와 반환값의 계약을 정의합니다.

SDK 초기화

AppBox.initialize(context, config)

Kotlin
1 val result = AppBox.initialize(context = this, config = config)
2
3 // 반환값은 기능별 초기화 결과를 각각 담습니다. 사용할 기능을 각각 확인하세요.
4 listOf(result.core, result.push, result.webView).forEach { feature ->
5 if (feature.status == AppBoxInitStatus.FAILED) {
6 Log.w("AppBox", feature.error?.message ?: feature.message ?: "init failed")
7 }
8 }
1 AppBoxInitResult result = AppBox.initialize(this, config);
2
3 // 반환값은 기능별 초기화 결과를 각각 담습니다. 사용할 기능을 각각 확인하세요.
4 if (result.getPush().getStatus() == AppBoxInitStatus.FAILED) {
5 Log.w("AppBox", String.valueOf(result.getPush().getMessage()));
6 }

Request 항목 정의

Request 항목필수여부설명기본값
context필수Application 또는 Activity context. 내부에서 application context를 사용합니다-
config필수공통 설정과 기능별 설정을 담은 AppBoxInitConfig-


Response 항목 정의

Response 결과값
AppBoxInitResult즉시 반환되는 초기화 결과. callback이 없습니다
.core, .push, .inApp, .webView, .auth, .health, .appsFlyer기능별 초기화 결과
.{기능}.statusINITIALIZED, SKIPPED, FAILED
.{기능}.message상태 설명 문자열
.{기능}.error실패 원인


값을 즉시 반환합니다. callback이 없습니다.

  • Application.onCreate()에서 한 번만 호출합니다. 중복 초기화를 막는 장치가 없으므로 Activity.onCreate()에서 호출하지 않습니다.
  • 예외를 던지지 않습니다. 실패는 각 항목의 status와 error로 전달됩니다.
  • 한 기능의 실패가 다른 기능을 막지 않습니다. 사용할 기능의 결과를 각각 확인합니다.
  • SKIPPED는 설정을 넣지 않았거나 artifact를 추가하지 않은 상태입니다. 사용하지 않는 기능이면 정상입니다.

기능별 설정 클래스(AppBoxPushConfig, AppBoxInAppConfig 등)의 항목은 각 기능 장의 개요에서 다룹니다.

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