Android (Kotlin) SDK

io.deplite:sdk-android는 Android 앱과 JVM 서버에서 Deplite를 호출하거나, 내 앱을 Deplite의 작업 노드로 만드는 공식 SDK예요.

설치


// build.gradle.kts
dependencies {
    implementation("io.deplite:sdk-android:0.1.0")
}

JVM 17+ 환경에서만 사용 가능해요.
모든 API 호출은 suspend 함수라 코루틴 컨텍스트에서 호출해주세요.

어떤 모드로 시작할까

모드	언제 쓰나	시작
External	내 앱·서버·CI가 Deplite를 호출	API 토큰 발급 → `Deplite(apiToken)`
Embedded	내 앱·기기가 Deplite의 작업 노드	1회용 설치 코드 → `Deplite.enroll(...)`

두 모드의 자세한 비교는 인증 모드를 참고해주세요.

External — Deplite 호출하기

대시보드에서 API 토큰을 발급한 뒤, 코루틴 스코프 안에서 호출하면 끝나요.


val deplite = Deplite(apiToken = BuildConfig.DEPLITE_API_TOKEN)
 
lifecycleScope.launch {
    val job = deplite.triggers.run(
        triggerId = TRIGGER_ID,
        params = buildJsonObject { put("ref", "main") },
    )
 
    val uploaded = deplite.files.upload(
        file = File("/tmp/app.apk"),
    )
}

토큰은 발급 직후 1회만 노출되므로 별도의 저장 처리가 필요해요.

Embedded — 내 앱이 작업 노드 되기

대시보드에서 1회용 설치 코드를 발급한 뒤, 첫 실행에서 enroll → 결과를 안전 저장소에 보관 → 이후 실행에서는 그 자격으로 Agent 부팅이에요.


// 1) 1회만 — enroll 후 결과를 영구 저장
val enrollment = Deplite.enroll(
    installCode = INSTALL_CODE,
    name = "kiosk-seoul-01",
)
secureStore.save(enrollment)   // identity + privateKey
 
// 2) 매 실행마다 — 저장된 자격으로 부팅
val stored = secureStore.load()
val agent = DepliteAgent(
    identity = stored.identity,
    privateKey = stored.privateKey,
)
 
agent.events().collect { ev ->
    if (ev is AgentEvent.Deploy) {
        runJob(ev.payload)
        agent.jobs.reportResult(ev.payload.jobId, JobResult.success())
    }
}

enroll()이 반환하는 privateKey(raw 32바이트)는 SDK가 저장하지 않으므로 암호화 후 저장하는 것을 추천드려요.
분실하면 재등록만이 답이에요.

Android (Kotlin) SDK

설치

어떤 모드로 시작할까

External — Deplite 호출하기

Embedded — 내 앱이 작업 노드 되기

관련 문서