Android (Kotlin) SDK
Android SDK는 Android 앱과 JVM 서버에서 Deplite API를 사용하거나, 내 앱을 기기 Agent로 실행할 때 사용할 수 있어요.
SDK 버전은 0.2.0이에요.
설치
설치 경로 정리 중이에요.
공개 설치 경로가 확정되면 안내할게요.
JVM 17+ 환경에서 사용할 수 있어요.
모든 API 호출은 suspend 함수라 코루틴 컨텍스트에서 호출해주세요.
어떤 모드로 시작할까
| 모드 | 언제 쓰나 | 시작 |
|---|---|---|
| External | 내 앱·서버·CI가 Deplite를 호출 | API 토큰 발급 → Deplite(apiToken) |
| Embedded | 내 Android 기기가 Deplite의 작업 노드 | 1회용 설치 코드 → Deplite.enroll(...) |
두 모드의 자세한 비교는 인증 모드를 참고해주세요.
External — Deplite 호출하기
Android SDK에는 아직 이름 기반 실행 메소드가 없어요.
현재는 REST POST /v1/run/{agentName}/{workflowName}을 직접 호출해주세요.
요청 예시는 워크플로우 실행에서 확인할 수 있어요.
파일 API는 SDK에서 사용할 수 있어요.
val deplite = Deplite(apiToken = BuildConfig.DEPLITE_API_TOKEN)
lifecycleScope.launch {
val uploaded = deplite.files.upload(
file = File(cacheDir, "app.apk"),
contentType = "application/vnd.android.package-archive",
)
}토큰은 발급 직후 1회만 노출되므로 별도로 안전하게 보관해주세요.
Embedded — 내 앱이 작업 노드 되기
Android Embedded SDK는 Agent 등록, 워크플로우 호출 허용 선언, 상태 보고, 검증된 업데이트 파일 확인을 지원해요.
기본적인 Agent 시작 흐름은 다음과 같아요.
val enrollment = Deplite.enroll(
installCode = INSTALL_CODE,
name = "kiosk-seoul-01",
)
secureStore.save(enrollment)
val stored = secureStore.load()
val agent = DepliteAgent(
identity = stored.identity,
privateKey = stored.privateKey,
)
agent.events().collect { event ->
if (event is AgentEvent.Deploy) {
runJob(event.payload)
agent.jobs.reportResult(event.payload.jobId, JobResult.success())
}
}enroll()이 반환하는 privateKey는 SDK가 저장하지 않으므로 암호화해 보관해주세요.
분실하면 다시 등록해야 해요.
Android Embedded 기능은 API 레퍼런스에서 확인해주세요.
관련 문서
최종 수정 일자: