Skip to Content
문서SDKFlutter (Dart)개요·Quickstart

Flutter (Dart) SDK

Flutter SDK는 Flutter 앱, Dart 서버, Dart CLI에서 Deplite를 호출하거나, 내 앱을 Agent로 실행할 때 사용할 수 있어요.
SDK 버전은 0.2.0이에요.

설치

설치 경로 정리 중이에요.
공개 설치 경로가 확정되면 안내할게요.

Dart 3.0+ 환경에서 사용할 수 있어요.
모든 API는 Future 또는 Stream을 반환하므로 await로 호출해주세요.

어떤 모드로 시작할까

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

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

External — Deplite 호출하기

Deplite.run(agentName, workflowName, ...)으로 이름을 지정해 워크플로우를 실행할 수 있어요.

import 'package:deplite/deplite.dart'; final deplite = Deplite(apiToken: const String.fromEnvironment('DEPLITE_API_TOKEN')); final result = await deplite.run( 'my-agent', 'deploy', params: {'ref': 'main'}, wait: true, ); print('${result.jobId} ${result.status}');

wait: true로 완료 결과를 기다릴 수 있어요.
자세한 매개변수와 응답 필드는 API 레퍼런스에서 확인해주세요.

Embedded — 내 앱이 작업 노드 되기

대시보드에서 1회용 설치 코드를 발급한 뒤, 첫 실행에서 enroll하고 결과를 안전하게 보관해주세요.
이후 실행에서는 저장한 자격으로 Agent를 시작할 수 있어요.

final enrollment = await Deplite.enroll( installCode: installCode, name: 'kiosk-seoul-01', ); await secureStore.save(enrollment); final stored = await secureStore.load(); final agent = DepliteAgent( identity: stored.identity, privateKey: stored.privateKey, ); await for (final event in agent.events()) { if (event is DeployEvent) { await runJob(event.payload); await agent.jobs.reportResult( jobId: event.payload.jobId, result: JobResult.success(), ); } }

enroll()이 반환하는 privateKey는 SDK가 저장하지 않으므로 암호화해 보관해주세요.
분실하면 다시 등록해야 해요.

관련 문서

최종 수정 일자: