예제
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")
}관련 문서
최종 수정 일자: