クイックスタート: デベロッパー デバイス プラットフォームの準備

次世代の商用グレードのデバイス リモート オーケストレーション スイートである Developer Device Platform を使用できるように設定します。

始める前に

デベロッパー デバイス プラットフォームは、このページの手順に沿って、ターミナルとインターネット アクセスを備えたワークステーションで動作します。

これらのドキュメントは、このサイトの [概要] タブにある Google Cloudを使ってみるで説明されているように、プロジェクトとアカウントを持つ Google Cloud ユーザーであることを前提としています。

Google Cloud 構成

  1. Google Cloud アカウントにログインします。 Google Cloudを初めて使用する場合は、 アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

  2. Google Cloud CLI をインストールします。

  3. 外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

  4. gcloud CLI を初期化するには、次のコマンドを実行します。

    gcloud init

  5. このガイドを完了するために必要な権限があることを確認します。

  6. Google Cloud プロジェクトに対して課金が有効になっていることを確認します。

  7. Device Run、Device Streaming、Cloud Testing API を有効にします。

    API を有効にするために必要なロール

    API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール（roles/serviceusage.serviceUsageAdmin）を介してこの権限を取得できます。ロールを付与する方法をご覧ください。

    gcloud services enable devicerun.googleapis.com devicestreaming.googleapis.com testing.googleapis.com

  8. ローカルシェルを使用している場合は、ユーザー アカウントのローカル認証情報を作成します。 

    gcloud auth application-default login

    Cloud Shell を使用している場合は、この操作を行う必要はありません。

    認証エラーが返され、外部 ID プロバイダ（IdP）を使用している場合は、 フェデレーション ID を使用して gcloud CLI にログインしていることを確認します。

  9. Google Cloud CLI をインストールします。

  10. 外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

  11. gcloud CLI を初期化するには、次のコマンドを実行します。

    gcloud init

  12. このガイドを完了するために必要な権限があることを確認します。

  13. Google Cloud プロジェクトに対して課金が有効になっていることを確認します。

  14. Device Run、Device Streaming、Cloud Testing API を有効にします。

    API を有効にするために必要なロール

    API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール（roles/serviceusage.serviceUsageAdmin）を介してこの権限を取得できます。ロールを付与する方法をご覧ください。

    gcloud services enable devicerun.googleapis.com devicestreaming.googleapis.com testing.googleapis.com

  15. ローカルシェルを使用している場合は、ユーザー アカウントのローカル認証情報を作成します。 

    gcloud auth application-default login

    Cloud Shell を使用している場合は、この操作を行う必要はありません。

    認証エラーが返され、外部 ID プロバイダ（IdP）を使用している場合は、 フェデレーション ID を使用して gcloud CLI にログインしていることを確認します。

    16.

必要なロール

Developer Device Platform の使用に必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

コマンド例

Device Run サービスが用意できたので、次のコマンドを実行してカタログを試すことができます。

まず、プロジェクト内のすべてのデバイスを一覧表示します。

gcloud device-run devices list

次に、プロジェクト内のすべてのセッションを一覧表示します（おそらくセッションはありません）。

gcloud device-run sessions

次のステップの機能の手順に進むか、次のセクションに沿って Developer Device Platform エージェント スキルを使用します。

Developer Device Platform エージェント スキルをインストールする

このページで説明する Google Cloud 環境の確立に加えて、Developer Device Platform エージェント スキル用に次のパッケージをインストールする必要があります。

  • リモートの Android デバイスでコマンドを実行するための ADB
  • ADB 転送を有効にするための Python 環境
  • Antigravity またはエージェント スキルをサポートするその他の AI コーディング エージェント
  • Node.js と NPM パッケージ: npx を使用してエージェント スキルをインストールします。

次に、次のコマンドを使用して Developer Device Platform エージェント スキルをインストールします。

npx skills add https://github.com/google/skills --skill developer-device-platform-basics

次のステップの機能の手順に進みます。

サポート ドキュメント

クリーンアップ

このページで使用したリソースについて、 Google Cloud アカウントに課金されないようにするには、リソースを含む Google Cloud プロジェクトを削除します。

次のステップ

  • デバイス カタログ - DDP ラボのすべてのデバイスタイプを説明し、各タイプを詳しく説明する
  • デバイス実行 - DDP ラボのデバイスでテストを実行し、 Google Cloudで結果を確認します
  • Device Streaming API - リモートの物理 Android デバイスに接続し、ローカルマシンに接続されているかのようにアプリを操作する
  • デバイス ストリーミングによるエージェント開発 - Developer Device Platform エージェント スキルを使用して、DDP 内のデバイスを検索、予約、接続する