Glosarium Developer Device Platform

Developer Device Platform (DDP) adalah platform berbasis cloud tingkat komersial dari Google Clouduntuk orkestrasi perangkat seluler jarak jauh, pengujian batch otomatis, dan alur kerja pengembangan agentic. DDP mengintegrasikan infrastruktur farm perangkat terkelola langsung ke ekosistem Google Cloud . Glosarium ini menyediakan referensi teknis berdasarkan abjad untuk konsep utama, komponen arsitektur, platform API, perintah CLI, dan paradigma operasional yang mendefinisikan DDP.

Lihat daftar di halaman ini untuk mempelajari terminologi dasar Developer Device Platform dan teknologi terkait. Berikut adalah sumber lain untuk definisi istilah utama:

A

Keahlian Agen (Keahlian Agen DDP dan Keahlian Migrasi)

Keahlian Agen DDP

Set instruksi khusus tugas open source yang dipublikasikan di bagian Google Cloud Skills di GitHub /skills/cloud/developer-device-platform-basics. Didesain untuk bantuan coding AI seperti Antigravity, ChatGPT, dan Claude Code, DDP Agent Skill memungkinkan agen menyewa perangkat jarak jauh secara terprogram dengan Device Streaming API, melakukan inisialisasi daemon penerusan ADB, menjalankan perintah shell, mengambil screenshot buffering frame, dan memicu suite pengujian otomatis menggunakan gcloud device-run CLI.

Keterampilan Migrasi

Keterampilan untuk bermigrasi dari Firebase Test Lab ke Developer Device Platform yang menawarkan pemetaan mendetail tentang flag dan perbedaan lainnya serta menyertakan versi teks biasa yang ditujukan khusus untuk agen AI.

Android Test Orchestrator

Android Test Orchestrator memungkinkan Anda menjalankan setiap pengujian aplikasi dalam pemanggilan instrumentasinya sendiri. Lihat detail selengkapnya di Menggunakan Android Test Orchestrator.

Set APK (.apks)

Format arsip paket yang dihasilkan oleh bundletool untuk Android App Bundle (AAB). DDP secara native mendukung penginstalan file .apks.

Layanan AutomationSession (DeviceRun API)

Mesin eksekusi batch inti DDP, yang dihosting di devicerun.googleapis.com. Layanan AutomationSession menerima biner aplikasi dan kriteria hardware dalam satu panggilan API terpadu. Backend menangani alokasi perangkat, penyediaan lingkungan, eksekusi driver pengujian, pengumpulan log, dan penghapusan sebagai operasi atomik.

C

Model Cloud Storage (Bucket Milik Pengguna)

Arsitektur penyimpanan DDP tempat semua artefak input pengujian (APK) dan hasil output dihosting dalam bucket penyimpanan yang dimiliki oleh projectGoogle Cloud developer (misalnya, gs://<project_id>_devicerun).

D

Developer Device Platform (DDP)

Platform perusahaanGoogle Clouduntuk pengujian perangkat jarak jauh dan pengembangan seluler agentic, yang dihosting di Google Cloud. DDP menyediakan infrastruktur farm perangkat terkelola yang terintegrasi secara native dengan konsol Google Cloud , IAM, Penagihan Cloud, dan SDK.

Device Catalog API

Platform penemuan perangkat terpadu yang mematuhi AIP dan dihosting di devicerun.googleapis.com untuk project dan lokasi. Katalog Perangkat menyajikan satu koleksi datar yang mencakup perangkat Android dan iOS fisik dan virtual. Setiap entri mengekspos ID perangkat buram yang stabil, spesifikasi hardware, serta sinyal kapasitas dan ketersediaan fleet real-time.

Atribut Katalog Jenis Data Deskripsi
name String Jalur resource (projects/my-project/locations/global/devices/device-id).
form Enum Jenis hardware (PHYSICAL atau VIRTUAL).
os_version String Rilis OS atau level Android SDK (misalnya, 35 atau 17.4).
availability Pesan Sinyal kapasitas fleet (HIGH, MEDIUM, LOW, NONE).

Device Run API

devicerun.googleapis.com yang menggabungkan pengujian perangkat jarak jauh, penemuan katalog, dan alur kerja agentic ke dalam layanan berbasis cloud seperti yang dijelaskan dalam ringkasan Device Run.

Device Streaming API

Penawaran Google Cloud bawaan devicestreaming.googleapis.com yang menyediakan kemampuan streaming perangkat jarak jauh interaktif. Device Streaming API memungkinkan developer melakukan streaming tampilan perangkat secara real-time langsung ke Android Studio.

E

Eksekusi

Tingkat terendah dalam hierarki resource tiga tingkat Device Run Developer Device Platform (Session -> Job -> Execution). Execution mewakili upaya runtime konkret yang dihasilkan sistem untuk menjalankan suite pengujian atau shard pada perangkat yang dialokasikan, yang merekam log output mentah, log sistem, dan rekaman video.

F

Flank

Runner pengujian sisi klien open source pihak ketiga yang populer, yang dikembangkan untuk mengoptimalkan eksekusi uji dan sharding. DDP secara native menyerap kemampuan inti Flank—termasuk konfigurasi berbasis YAML, sharding cerdas historis lanjutan, dan percobaan ulang yang ditargetkan—sehingga wrapper eksternal tidak diperlukan.

G

gcloud device-run

Antarmuka command line SDK Google Cloud utama untuk pengujian batch DDP dan operasi streaming. Beroperasi pada pola gcloud device-run <resource> <verb> yang berfokus pada resource, alat ini menyediakan perintah untuk mengirimkan sesi pengujian, mengkueri ketersediaan perangkat, melakukan polling status eksekusi, dan mendownload hasil.

J

Tugas

Tingkat menengah dalam hierarki resource tiga tingkat Device Run Developer Device Platform (Session -> Job -> Execution). Tugas menyambungkan konfigurasi otomatisasi tertentu (JobAction, seperti uji instrumentasi Android) dengan konfigurasi perangkat target. Satu Tugas akan otomatis diperluas menjadi beberapa Eksekusi saat sharding atau percobaan ulang diaktifkan.

N

NO_ACCESS_BLOCKED_BY_ORG_ADMIN

Tag status akses yang ditampilkan di Katalog Perangkat DDP yang menunjukkan bahwa model perangkat atau lab partner tertentu (misalnya, hardware OEM pihak ketiga) telah dibatasi oleh Administrator Organisasi menggunakan Tag Resource Manager atau Kebijakan Organisasi Google Cloud .

O

Grup Dependensi One Platform API

Fitur bidang kontrol layanan Google Cloud yang otomatis memicu aktivasi backend API dependen. Saat developer mengaktifkan DDP API, grup dependensi akan otomatis diaktifkan di balik layar.

P

Lab Perangkat Partner

Lab perangkat jarak jauh yang dioperasikan langsung oleh partner OEM Google (seperti Samsung, Xiaomi, OPPO, OnePlus, vivo, Transsion) yang terintegrasi ke dalam DDP. Lab partner memperluas variasi katalog perangkat dan memerlukan pengaktifan eksplisit di level project di Google Cloud console.

S

Percobaan Ulang Uji Tidak Stabil Berurutan

Mekanisme percobaan ulang yang hemat biaya di DDP yang mengisolasi dan mencoba ulang hanya kasus pengujian yang gagal dalam shard, menjalankannya secara berurutan secara default, bukan menjalankan ulang seluruh shard secara serentak.

Agen Layanan (Akun Layanan)

Akun layanan Google Cloud yang dikelola Google dibuat secara otomatis saat API DDP diaktifkan di project Google Cloud . Agen Layanan DDP memiliki izin layanan IAM untuk membaca biner pengujian input dengan aman dari dan menulis log dan video output pengujian ke bucket Google Cloud Storage milik pengguna, memublikasikan notifikasi status ke topik Google Cloud Pub/Sub, dan mengatur alokasi hardware di pusat data terkelola atas nama project.

Service Usage/Pengaktifan API

Subsistem pengelolaan layanan Google Cloud yang bertanggung jawab untuk mengaktifkan dan mengonfigurasi API Google Cloud untuk sebuah project. Mengaktifkan DDP memerlukan izin level project atau peran layanan devicerun.googleapis.com, devicestreaming.googleapis.com, dan testing.googleapis.com.

Sesi

Penampung level teratas dalam hierarki resource Device Run Developer Device Platform (projects/my-project/locations/global/sessions/session-id). Sesi mengenkapsulasi pengiriman batch pengguna, yang berisi satu atau beberapa Tugas yang dijalankan di seluruh matriks perangkat atau modul Gradle, dan menghasilkan SessionReport gabungan.

Di Device Streaming API Developer Device Platform, deviceSession mewakili satu sesi streaming perangkat jarak jauh. Alih-alih menjalankan skrip batch hingga selesai, Device Streaming API mencadangkan satu perangkat dan membuka koneksi dua arah secara langsung sehingga engineer atau agen AI dapat melihat layar dan mengontrol perangkat secara real time.

Smart Sharding

Mekanisme partisi pengujian yang cerdas di Developer Device Platform Device Run (--sharding-option=smart). Smart Sharding menganalisis data eksekusi uji historis hingga 30 hari, melacak runtime per model perangkat tertentu, dan memperhitungkan overhead startup Android Test Orchestrator untuk mendistribusikan suite pengujian ke dalam shard yang seimbang yang menargetkan durasi tertentu.

U

Sharding Seragam

Strategi distribusi pengujian (--sharding-option=uniform --uniform-sharding-count=N) di Device Run Developer Device Platform yang mempartisi suite uji instrumentasi Android di sejumlah shard tetap ($N$) menggunakan parameter -e numShards dan -e shardIndex native AndroidJUnitRunner.