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가 저장하지 않으므로 암호화해 보관해주세요.
분실하면 다시 등록해야 해요.
관련 문서
최종 수정 일자: