appbox-core는 항상 필요하고, 나머지는 쓰는 기능만 넣습니다.2단계: 모듈 선언 | 초기 설정 | Appbox Android SDK 가이드
2단계: 모듈 선언
2단계: 모듈 선언
build.gradle.kts (app)
Kotlin
1
dependencies {
2
// BOM이 모듈 간 버전을 맞춰 줍니다. 개별 artifact에 버전을 적지 마세요.
3
implementation(platform("com.appboxapp.sdk:appbox-bom:1.4.0"))
4
5
implementation("com.appboxapp.sdk:appbox-core") // 필수
6
implementation("com.appboxapp.sdk:appbox-webview") // AppBox 관리 화면, 웹 브릿지, 기기 기능
7
implementation("com.appboxapp.sdk:appbox-push") // 푸시 알림
8
}
항목 정의
| 요구사항 | 값 |
|---|---|
minSdk | 26: 미만이면 manifest 병합 실패 |
compileSdk / targetSdk | 36 |
| Java/Kotlin JVM target | 17 |
모듈 선택
| artifact | 필요한 경우 | 없으면 |
|---|---|---|
appbox-core | 항상 | SDK가 동작하지 않습니다 |
appbox-webview | AppBox 관리 화면, 웹 브릿지, 기기 기능 45개 | 기기 기능이 FEATURE_UNAVAILABLE(-5000) |
appbox-push | 푸시 알림, localPushSend | Push 함수가 FEATURE_UNAVAILABLE(-5000) |
appbox-inapp | 네이티브 인앱 메시지 | 인앱 메시지가 표시되지 않습니다 |
appbox-health | 걸음 수 | getHealthSteps가 FEATURE_UNAVAILABLE(-5000) |
appbox-appsflyer | AppsFlyer 딥링크 | 딥링크 어트리뷰션이 동작하지 않습니다 |
appbox-auth-google | Google 로그인 | 해당 provider가 목록에 없습니다 |
appbox-auth-apple | Apple 로그인 | 〃 |
appbox-auth-naver | Naver 로그인 | 〃 |
appbox-auth-kakao | Kakao 로그인 | 〃 (카카오 저장소도 필요. 1단계 참고) |
기기 기능 45개의 함수 선언은 appbox-core에 있어 appbox-webview 없이도 컴파일되고 호출까지 됩니다. 실행 파이프라인은 appbox-webview가 제공하므로, 없으면 런타임에 FEATURE_UNAVAILABLE(-5000)로 실패합니다. 빌드 성공이 동작을 보장하지 않는 지점입니다.
- 난독화: SDK가 consumer ProGuard 규칙을 포함하므로 release 빌드에서 켜도 되고, 앱에서 별도 규칙을 추가할 필요가 없습니다.