3단계: Manifest와 초기화 | 초기 설정 | Appbox Android SDK 가이드

3단계: Manifest와 초기화

(필수) 초기화는 Application.onCreate()에서 진행합니다. 그러려면 먼저 Application 클래스가 Manifest에 등록돼 있어야 합니다.

3단계: Manifest와 초기화

AndroidManifest.xml

XML
1 <uses-permission android:name="android.permission.INTERNET" />
2
3 <application
4 android:name=".MainApplication"
5 android:allowBackup="false"
6 android:fullBackupContent="false">
7 </application>
MainApplication.kt

Kotlin
1 class MainApplication : Application() {
2
3 override fun onCreate() {
4 super.onCreate()
5
6 val result = AppBox.initialize(
7 context = this,
8 config = AppBoxInitConfig(
9 common = AppBoxCommonConfig(
10 projectId = "<PROJECT_ID>", // AppBox 콘솔에서 발급합니다
11 pushIcon = R.mipmap.ic_launcher, // 알림 small icon. 흰색/투명 리소스 권장
12 debugMode = BuildConfig.DEBUG
13 ),
14 push = AppBoxPushConfig()
15 )
16 )
17
18 if (result.core.status != AppBoxInitStatus.INITIALIZED) {
19 Log.w("AppBox", result.core.error?.message ?: result.core.message ?: "core init failed")
20 }
21 }
22 }
1 public class MainApplication extends Application {
2
3 @Override
4 public void onCreate() {
5 super.onCreate();
6
7 AppBoxInitConfig config = new AppBoxInitConfig.Builder()
8 .setCommon(new AppBoxCommonConfig.Builder()
9 .setProjectId("<PROJECT_ID>") // AppBox 콘솔에서 발급합니다
10 .setPushIcon(R.mipmap.ic_launcher) // 알림 small icon. 흰색/투명 리소스 권장
11 .setDebugMode(BuildConfig.DEBUG)
12 .build())
13 .setPush(new AppBoxPushConfig.Builder().build())
14 .build();
15
16 AppBoxInitResult result = AppBox.initialize(this, config);
17
18 if (result.getCore().getStatus() != AppBoxInitStatus.INITIALIZED) {
19 Log.w("AppBox", String.valueOf(result.getCore().getMessage()));
20 }
21 }
22 }

항목 정의

android:name에 Application 클래스를 등록하지 않으면 빌드와 실행은 성공하는데 SDK만 조용히 초기화되지 않습니다. 원인을 찾기 어려운 실패입니다.

  • appbox-webview가 allowBackup 등을 선언하므로 병합 충돌이 나면 해당 항목에만 tools:replace를 적용하세요.
  • Activity.onCreate()에서 호출하지 마세요. 화면 회전으로 반복 호출됩니다. 초기화 전에 부른 다른 함수는 조용히 무시됩니다.

초기화에서 정하는 값 중 두 개는 특히 주의가 필요합니다.

설정주의
usageModeAPPBOX_WEBVIEW(AppBox 화면이 주 화면) / SERVICE_APP(앱이 자체 화면). 푸시 클릭을 어디로 보낼지가 이 값으로 갈립니다
common.pushIcon알림 small icon은 실루엣으로 마스킹되므로 흰색/투명 리소스를 쓰세요. 컬러 아이콘은 뭉개집니다

인자와 반환값 전체는 SDK 초기화에서 다룹니다.

google-services.json과 google-services plugin은 필요 없습니다. Firebase 콘솔에서 발급한 서버 JSON을 AppBox 콘솔에 업로드하면 SDK가 서버에서 받아 초기화합니다. (콘솔 메뉴: 빌드 > FCM 설정)

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