Skip to Content

예제

Android SDK의 파일 API와 Embedded 기기 Agent 흐름을 정리했어요.

External — 이름으로 워크플로우 호출

Android SDK의 External 클라이언트에는 아직 이름 기반 실행 메소드가 없어요.
REST POST /v1/run/{agentName}/{workflowName}을 직접 호출해주세요.
HTTP 요청과 결과 형식은 워크플로우 실행에서 확인할 수 있어요.

External — 파일 업로드

val deplite = Deplite(apiToken = BuildConfig.DEPLITE_API_TOKEN) lifecycleScope.launch { val uploaded = deplite.files.upload( file = File(cacheDir, "app.apk"), cleanupRule = CleanupRule.Persistent, contentType = "application/vnd.android.package-archive", ) Log.i("Deplite", "uploaded ${uploaded.id}, binding=${uploaded.bindingId}") }

Embedded — 호출 가능한 워크플로우 보고

Android Embedded SDK 0.2.0에서는 WorkflowReport에 호출 허용 선언을 넣을 수 있어요.
WorkflowOn.webhook()은 모든 ref를 허용하고, refs를 지정하면 그 패턴에 맞는 ref만 허용해요.

private suspend fun reportWorkflows(agent: DepliteAgent) { agent.workflows.report(listOf( WorkflowReport( name = "release.yml", on = WorkflowOn.webhook(refs = listOf("main", "release/*")), ), WorkflowReport(name = "healthcheck.yml", on = WorkflowOn.webhook()), )) }

Embedded — 상태 heartbeat

건강 상태 값은 키 최대 32개, JSON 직렬화 기준 4KB 이하로 보낼 수 있어요.
키는 영문·숫자·밑줄·마침표·하이픈으로 된 1~64자이며, 값은 문자열·유한 숫자·불리언이어야 해요.

val heartbeat = agent.heartbeat( health = mapOf( "batteryPercent" to 82, "network" to "online", "maintenanceMode" to false, ), ) if (heartbeat.healthRejected != null) { Log.w("Deplite", "health omitted: ${heartbeat.healthRejected}") }

health 제한을 넘겨도 heartbeat 요청은 성공하며, 유효하지 않은 health 값은 저장되지 않아요.

Embedded — 배포 파일 검증

앱에 포함한 공개키를 사용해 SHA-256 체크섬과 서명을 검증할 수 있어요.
서버가 응답으로 제공하는 공개키는 신뢰 기점으로 사용하지 않아요.

val verified = fetchVerifiedArtifact( params = releasePayload, destination = File(context.filesDir, "release.apk"), publicKeyPem = APP_UPDATE_PUBLIC_KEY_PEM, ) if (verified.serverKeyMismatch) { Log.e("Deplite", "server artifact key differs from the app key") }

관련 문서

최종 수정 일자: