Developer Device Platform の用語集

Developer Device Platform(DDP)は、リモート モバイル デバイスのオーケストレーション、自動バッチテスト、エージェント型開発ワークフローに対応した、 Google Cloudの商用グレードのクラウド ファースト プラットフォームです。DDP は、管理対象デバイス ファーム インフラストラクチャを Google Cloud エコシステムに直接統合します。この用語集では、DDP を定義する主要なコンセプト、アーキテクチャ コンポーネント、API サーフェス、CLI コマンド、運用パラダイムに関する技術的なリファレンスをアルファベット順に説明します。

Developer Device Platform と関連テクノロジーの基本的な用語については、このページのリストをご覧ください。主な用語の定義については、ほかにも次のようなソースがあります。


A

エージェント スキル(DDP エージェント スキルと移行スキル)

DDP エージェント スキル

タスク固有の命令セット。オープンソースで、 Google CloudGitHub のスキル /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 Service(DeviceRun API)

devicerun.googleapis.com でホストされている DDP のコア バッチ実行エンジン。AutomationSession サービスは、1 つの統合 API 呼び出しでアプリケーション バイナリとハードウェア条件を受け入れます。バックエンドは、デバイスの割り当て、環境のプロビジョニング、テストドライバの実行、ログの収集、ティアダウンをアトミック オペレーションとして処理します。


C

Cloud Storage モデル(ユーザー所有のバケット)

DDP のストレージ アーキテクチャ。すべてのテスト入力アーティファクト(APK)と出力結果が、デベロッパーのGoogle Cloud プロジェクト(gs://<project_id>_devicerun など)が所有するストレージ バケット内でホストされます。


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、ハードウェア仕様、リアルタイムのフリート容量と可用性シグナルを公開します。

カタログ属性 データ型 説明
name 文字列 リソースパス(projects/my-project/locations/global/devices/device-id)。
form 列挙型 ハードウェアの種類(PHYSICAL または VIRTUAL)。
os_version 文字列 OS リリースまたは Android SDK レベル(例: 35、17.4)。
availability メッセージ フリート容量シグナル(HIGH、MEDIUM、LOW、NONE)。

Device Run API

デバイスランの概要で説明されているように、リモート デバイス テスト、カタログ検出、エージェント ワークフローをクラウドネイティブ サービスに統合する包括的な devicerun.googleapis.com。

Device Streaming API

組み込みの Google Cloud サービス devicestreaming.googleapis.com。インタラクティブなリモート デバイス ストリーミング機能を提供します。Device Streaming API を使用すると、デベロッパーはリアルタイムのデバイス ディスプレイを Android Studio に直接ストリーミングできます。


E

実行

Developer Device Platform デバイスランの 3 階層のリソース階層(Session -> Job -> Execution)の最下位階層。Execution は、割り当てられたデバイスでテストスイートまたはシャードを実行する、システム生成の具体的なランタイム試行を表します。未加工の出力ログ、システムログ、動画録画をキャプチャします。


F

側面

テスト実行とシャーディングを最適化するために開発された、人気のサードパーティ製オープンソース クライアントサイド テスト ランナー。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 インストルメンテーション テストなど)とターゲット デバイス構成をペア設定します。シャーディングまたは再試行が有効になっている場合、1 つのジョブが自動的に複数の実行に拡張されます。


N

NO_ACCESS_BLOCKED_BY_ORG_ADMIN

DDP デバイス カタログで返されるアクセス ステータス タグ。特定のデバイスモデルまたはパートナー ラボ(サードパーティ OEM ハードウェアなど)が、 Google Cloud Resource Manager タグまたは組織ポリシーを使用して組織管理者によって制限されていることを示します。


O

One Platform API の依存関係グループ

依存 API のバックエンドの有効化を自動的にトリガーする Google Cloud サービス コントロール プレーン機能。デベロッパーが DDP API を有効にすると、依存関係グループがバックグラウンドで自動的に有効になります。


P

パートナー デバイス ラボ

Google OEM パートナー(Samsung、Xiaomi、OPPO、OnePlus、vivo、Transsion など)が直接運営するリモート デバイスラボが DDP に統合されています。パートナー ラボでは、デバイス カタログの種類が拡張されます。Google Cloud コンソールでプロジェクト レベルの明示的な有効化が必要です。


S

フレーキー テストの順次再試行

DDP の費用を節約する再試行メカニズム。シャード内の失敗した個々のテストケースのみを分離して再試行し、シャード全体を同時に再実行するのではなく、デフォルトで順次実行します。

サービス エージェント(サービス アカウント)

Google Cloud プロジェクトで DDP API が有効になると自動的に作成される Google 管理の Google Cloud サービス アカウント。DDP サービス エージェントは、IAM サービス権限を保持しています。この権限により、ユーザー所有の Google Cloud Storage バケットから入力テストバイナリを安全に読み取り、テスト出力ログと動画を書き込み、 Google Cloud Pub/Sub トピックにステータス通知を公開し、プロジェクトに代わってマネージド データセンターでハードウェア割り当てをオーケストレートします。

Service Usage / 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 モジュール全体で実行される 1 つ以上のジョブを含み、集計された SessionReport を生成します。

Developer Device Platform Device Streaming API では、deviceSession は単一のリモート デバイス ストリーミング セッションを表します。Device Streaming API は、バッチ スクリプトを完了まで実行するのではなく、1 台のデバイスを予約して、双方向のライブ接続を開きます。これにより、エンジニアや AI エージェントは画面を表示してデバイスをリアルタイムで制御できます。

スマート シャーディング

Developer Device Platform デバイスラン(--sharding-option=smart)のインテリジェントなテスト パーティショニング メカニズム。スマート シャーディングは、最大 30 日間の過去のテスト実行データを分析し、特定のデバイスモデルごとのランタイムを追跡します。また、Android Test Orchestrator の起動オーバーヘッドを考慮して、指定された期間をターゲットとするバランスの取れたシャードにテストスイートを分散します。


U

均一シャーディング

Developer Device Platform デバイスランのテスト配布戦略(--sharding-option=uniform --uniform-sharding-count=N)。AndroidJUnitRunner のネイティブ -e numShards パラメータと -e shardIndex パラメータを使用して、Android インストルメンテーション テストスイートを固定数のシャード($N$)に分割します。