Skip to Content
문서SDKAndroid (Kotlin)개요·Quickstart

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 레퍼런스에서 확인해주세요.

관련 문서

최종 수정 일자: