appsok/agent-ui/definition/components/install-cta/index.md

ui_doc_type	component_id	status	source_evidence
component	install-cta	구현됨	type path notes code lib/src/features/builds/builds_page.dart _InstallCta와 _DownloadState type path notes docs README.md APK 다운로드 및 adb install handoff scope type path notes user null agent-ui 생성 요청

Install CTA

Component ID: install-cta

Status: 구현됨

Source Evidence

Type	Path	Notes
code	lib/src/features/builds/builds_page.dart	_InstallCta와 _DownloadState
docs	README.md	APK 다운로드 및 adb install handoff scope
user	없음	agent-ui 생성 요청

Purpose

선택한 APK artifact를 다운로드/stage하고 디바이스 설치 흐름으로 넘긴다.

Used By

• builds: builds.install-cta

Anatomy

• state icon
• title/status label
• artifact/build metadata
• download progress label and linear progress
• cancel/retry/install button

Variants

• idle: 설치 준비 또는 다운로드 취소됨
• downloading: received/total bytes와 cancel action
• verified: staged APK path와 install action
• failed: error message와 retry action

States

• default
• loading
• empty: 해당 없음
• error
• disabled

Rules

• downloader/stager가 있으면 먼저 다운로드를 수행하고, 검증된 staged APK만 install handoff에 넘긴다.
• 다운로드 실패 메시지는 한 줄로 줄이고 retry action을 유지한다.

Decision History

• 2026-06-25: APK download/install handoff CTA를 component로 기록했다.