2단계: 모듈 선언 | 초기 설정 | Appbox Android SDK 가이드

2단계: 모듈 선언

(필수) BOM을 먼저 선언하고 개별 artifact에는 버전을 적지 않습니다. appbox-core는 항상 필요하고, 나머지는 쓰는 기능만 넣습니다.

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 }

항목 정의

요구사항값
minSdk26: 미만이면 manifest 병합 실패
compileSdk / targetSdk36
Java/Kotlin JVM target17

모듈 선택

artifact필요한 경우없으면
appbox-core항상SDK가 동작하지 않습니다
appbox-webviewAppBox 관리 화면, 웹 브릿지, 기기 기능 45개기기 기능이 FEATURE_UNAVAILABLE(-5000)
appbox-push푸시 알림, localPushSendPush 함수가 FEATURE_UNAVAILABLE(-5000)
appbox-inapp네이티브 인앱 메시지인앱 메시지가 표시되지 않습니다
appbox-health걸음 수getHealthSteps가 FEATURE_UNAVAILABLE(-5000)
appbox-appsflyerAppsFlyer 딥링크딥링크 어트리뷰션이 동작하지 않습니다
appbox-auth-googleGoogle 로그인해당 provider가 목록에 없습니다
appbox-auth-appleApple 로그인〃
appbox-auth-naverNaver 로그인〃
appbox-auth-kakaoKakao 로그인〃 (카카오 저장소도 필요. 1단계 참고)

기기 기능 45개의 함수 선언은 appbox-core에 있어 appbox-webview 없이도 컴파일되고 호출까지 됩니다. 실행 파이프라인은 appbox-webview가 제공하므로, 없으면 런타임에 FEATURE_UNAVAILABLE(-5000)로 실패합니다. 빌드 성공이 동작을 보장하지 않는 지점입니다.

  • 난독화: SDK가 consumer ProGuard 규칙을 포함하므로 release 빌드에서 켜도 되고, 앱에서 별도 규칙을 추가할 필요가 없습니다.
www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.