Developer Device Platform(DDP)은 원격 모바일 기기 조정, 자동화된 일괄 테스트, 에이전트형 개발 워크플로를 위한 Google Cloud의 상용 등급 클라우드 중심 플랫폼입니다. DDP는 관리형 기기 팜 인프라를 Google Cloud 생태계에 직접 통합합니다. 이 용어집은 DDP를 정의하는 주요 개념, 아키텍처 구성요소, API 노출 영역, CLI 명령어, 운영 패러다임에 대한 기술 참조를 알파벳순으로 제공합니다.
이 페이지의 목록에서 Developer Device Platform 및 관련 기술의 기본 용어를 확인하세요. 주요 용어 정의의 기타 출처는 다음과 같습니다.
A
에이전트 스킬(DDP 에이전트 스킬 및 마이그레이션 스킬)
DDP 에이전트 스킬
GitHub의 Google Cloud스킬에 게시된 오픈소스 작업별 명령 집합/skills/cloud/developer-device-platform-basics입니다.
Antigravity, ChatGPT, Claude Code와 같은 AI 코딩 어시스턴트를 위해 설계된 DDP 에이전트 기술을 사용하면 에이전트가 Device Streaming API를 사용하여 프로그래매틱 방식으로 원격 기기를 임대하고, ADB 전달 데몬을 초기화하고, 셸 명령어를 실행하고, 프레임 버퍼 스크린샷을 캡처하고, gcloud device-run CLI를 사용하여 자동화된 테스트 모음을 트리거할 수 있습니다.
이전 기술
Firebase Test Lab에서 Developer Device Platform으로 이전하는 기술로, 플래그 및 기타 차이점에 관한 자세한 매핑을 제공하며 AI 에이전트를 위해 특별히 설계된 일반 텍스트 버전을 포함합니다.
Android Test Orchestrator
Android Test Orchestrator를 사용하면 자체 계측 호출 내에서 각 앱의 테스트를 실행할 수 있습니다. 자세한 내용은 Android Test Orchestrator 사용을 참고하세요.
APK 세트(.apks)
Android App Bundle(AAB)용으로 bundletool에서 생성한 패키지 보관 파일 형식입니다. DDP는 기본적으로 .apks 파일 설치를 지원합니다.
AutomationSession 서비스(DeviceRun API)
devicerun.googleapis.com에서 호스팅되는 DDP의 핵심 일괄 실행 엔진입니다.
AutomationSession 서비스는 단일 통합 API 호출에서 애플리케이션 바이너리와 하드웨어 기준을 허용합니다. 백엔드는 기기 할당, 환경 프로비저닝, 테스트 드라이버 실행, 로그 수집, 해체를 원자적 작업으로 처리합니다.
C
Cloud Storage 모델(사용자 소유 버킷)
모든 테스트 입력 아티팩트(APK) 및 출력 결과가 개발자의Google Cloud 프로젝트(예: gs://<project_id>_devicerun)가 소유한 스토리지 버킷 내에서 호스팅되는 DDP의 스토리지 아키텍처입니다.
D
Developer Device Platform(DDP)
Google Cloud에서 호스팅되는 원격 기기 테스트 및 에이전트 기반 모바일 개발을 위한Google Cloud의 엔터프라이즈 플랫폼입니다. DDP는 Google Cloud 콘솔, IAM, Cloud Billing, SDK와 기본적으로 통합된 관리형 기기 팜 인프라를 제공합니다.
Device Catalog API
프로젝트 및 위치에 대해 devicerun.googleapis.com에서 호스팅되는 통합된 AIP 호환 기기 탐색 표시 경로입니다. 기기 카탈로그는 실제 및 가상 Android 및 iOS 기기를 포괄하는 단일 플랫 컬렉션을 제공합니다. 각 항목은 안정적인 불투명 기기 ID, 하드웨어 사양, 실시간 Fleet 용량 및 가용성 신호를 노출합니다.
| 카탈로그 속성 | 데이터 유형 | 설명 |
|---|---|---|
name |
문자열 | 리소스 경로(projects/my-project/locations/global/devices/device-id)입니다. |
form |
Enum | 하드웨어 유형(PHYSICAL 또는 VIRTUAL)입니다. |
os_version |
문자열 | OS 출시 또는 Android SDK 수준(예: 35 또는 17.4) |
availability |
메시지 | Fleet 용량 신호(HIGH, MEDIUM, LOW, NONE) |
Device Run API
기기 실행 개요에 설명된 대로 원격 기기 테스트, 카탈로그 검색, 에이전트 워크플로를 클라우드 네이티브 서비스로 통합하는 포괄적인 devicerun.googleapis.com입니다.
Device Streaming API
대화형 원격 기기 스트리밍 기능을 제공하는 기본 제공 Google Cloud 제품인 devicestreaming.googleapis.com Device Streaming API를 사용하면 개발자가 실시간 기기 디스플레이를 Android 스튜디오로 직접 스트리밍할 수 있습니다.
E
실행
Developer Device Platform 기기 실행의 3단계 리소스 계층 구조(Session -> Job -> Execution)에서 가장 낮은 등급입니다. 실행은 할당된 기기에서 테스트 모음 또는 샤드를 실행하고 원시 출력 로그, 시스템 로그, 동영상 녹화를 캡처하는 구체적인 시스템 생성 런타임 시도를 나타냅니다.
F
Flank
테스트 실행 및 샤딩을 최적화하기 위해 개발된 인기 있는 서드 파티 오픈소스 클라이언트 측 테스트 실행기입니다. DDP는 YAML 기반 구성, 고급 기록 스마트 샤딩, 타겟팅된 재시도 등 Flank의 핵심 기능을 기본적으로 흡수하므로 외부 래퍼가 필요하지 않습니다.
G
gcloud device-run
DDP 일괄 테스트 및 스트리밍 작업을 위한 기본 Google Cloud SDK 명령줄 인터페이스입니다. 리소스 중심 gcloud device-run
<resource> <verb> 패턴에서 작동하며 테스트 세션 제출, 기기 가용성 쿼리, 실행 상태 폴링, 결과 다운로드 명령어를 제공합니다.
J
작업
Developer Device Platform 기기 실행의 3계층 리소스 계층 구조(Session -> Job -> Execution)에서 중간 계층입니다. 작업은 특정 자동화 구성(JobAction, 예: Android 계측 테스트)을 대상 기기 설정과 페어링합니다. 샤딩 또는 재시도가 사용 설정되면 단일 작업이 자동으로 여러 실행으로 확장됩니다.
N
NO_ACCESS_BLOCKED_BY_ORG_ADMIN
DDP 기기 카탈로그에 반환되는 액세스 상태 태그로, 조직 관리자가 Google Cloud Resource Manager 태그 또는 조직 정책을 사용하여 특정 기기 모델 또는 파트너 실험실(예: 서드 파티 OEM 하드웨어)을 제한했음을 나타냅니다.
O
One Platform API 종속 항목 그룹
종속 API의 백엔드 활성화를 자동으로 트리거하는 Google Cloud 서비스 컨트롤 플레인 기능입니다. 개발자가 DDP API를 사용 설정하면 종속 항목 그룹이 내부적으로 자동으로 활성화됩니다.
P
Partner Device Labs
Google OEM 파트너(예: 삼성, Xiaomi, OPPO, OnePlus, vivo, Transsion)가 직접 운영하는 원격 기기 실험실이 DDP에 통합되어 있습니다. 파트너 실험실은 기기 카탈로그의 다양성을 확장하며Google Cloud 콘솔에서 명시적인 프로젝트 수준 사용 설정이 필요합니다.
S
순차적 불안정한 테스트 재시도
DDP의 비용 절감 재시도 메커니즘으로, 샤드 내에서 실패한 개별 테스트 사례만 격리하고 재시도하며, 전체 샤드를 동시에 다시 실행하는 대신 기본적으로 순차적으로 실행합니다.
서비스 에이전트(서비스 계정)
Google Cloud 프로젝트에서 DDP API가 사용 설정되면 자동으로 생성되는 Google 관리형 Google Cloud 서비스 계정입니다. DDP 서비스 에이전트는 프로젝트를 대신하여 사용자 소유의 Google Cloud Storage 버킷에서 입력 테스트 바이너리를 안전하게 읽고 테스트 출력 로그 및 동영상을 작성하고, Google Cloud Pub/Sub 주제에 상태 알림을 게시하고, 관리형 데이터 센터에서 하드웨어 할당을 조정할 수 있는 IAM 서비스 권한을 보유합니다.
서비스 사용량/API 사용 설정
프로젝트의 Google Cloud API를 사용 설정하고 구성하는 Google Cloud 서비스 관리 하위 시스템입니다. DDP를 사용 설정하려면 프로젝트 수준 권한 또는 devicerun.googleapis.com, devicestreaming.googleapis.com, testing.googleapis.com 서비스 역할이 필요합니다.
세션
Developer Device Platform 기기 실행의 리소스 계층 구조(projects/my-project/locations/global/sessions/session-id)에 있는 최상위 컨테이너입니다. 세션은 사용자의 일괄 제출을 캡슐화하며, 기기 매트릭스 또는 Gradle 모듈에서 실행되는 하나 이상의 작업을 포함하고 집계된 SessionReport를 생성합니다.
Developer Device Platform Device Streaming API에서 deviceSession는 단일 원격 기기 스트리밍 세션을 나타냅니다. Device Streaming API는 일괄 스크립트를 완료까지 실행하는 대신 단일 기기를 예약하고 실시간 양방향 연결을 열어 엔지니어 또는 AI 에이전트가 화면을 보고 실시간으로 기기를 제어할 수 있도록 합니다.
스마트 샤딩
Developer Device Platform 기기 실행(--sharding-option=smart)의 지능형 테스트 파티셔닝 메커니즘입니다. 스마트 샤딩은 최대 30일간의 과거 테스트 실행 데이터를 분석하고, 특정 기기 모델별 런타임을 추적하며, Android Test Orchestrator 시작 오버헤드를 고려하여 테스트 모음을 지정된 기간을 타겟팅하는 균형 잡힌 샤드로 분산합니다.
U
균일 샤딩
AndroidJUnitRunner의 네이티브 -e numShards 및 -e shardIndex 매개변수를 사용하여 고정된 수의 샤드($N$)에 Android 계측 테스트 모음을 파티셔닝하는 Developer Device Platform 기기 실행의 테스트 배포 전략(--sharding-option=uniform
--uniform-sharding-count=N)입니다.