Quickstart: Prepare for Developer Device Platform

Quickstart: Prepare for Developer Device Platform

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Get set up to use the Developer Device Platform, a next-generation, commercial-grade suite for remote device orchestration.

Before you begin

The Developer Device Platform (DDP) works on any workstation with a terminal and internet access following the instructions on this page.

These documents assume you are a Google Cloud user with projects and accounts, as described in Get started with Google Cloud found in the Overview tab of this site.

Google Cloud configuration

Note: The Cloud Testing API is required by the Device Streaming API during Preview.

1. Install the Google Cloud CLI.

   Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.

2. Configure the gcloud CLI to use your federated identity.

   For more information, see Sign in to the gcloud CLI with your federated identity.

3. To initialize the gcloud CLI, run the following command:

   gcloud init

4. Verify that you have the permissions required to complete this guide.

5. Verify that billing is enabled for your Google Cloud project.

6. Enable the Device Run, Device Streaming, and Cloud Testing APIs:

   Roles required to enable APIs

   To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

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

7. Create local authentication credentials for your user account:

   gcloud auth application-default login

   If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

Required roles

To get the permissions that you need to use Developer Device Platform, ask your administrator to grant you the following IAM roles on on your project:

• All:
  • Roles Viewer (roles/viewer)
  • Device Run Admin (roles/devicerun.googleapis.com/admin)
  • Device Streaming Admin (roles/devicestreaming.admin)
  • Service Usage Consumer (roles/serviceusage.serviceUsageConsumer)

For more information about granting roles, see Manage access to projects, folders, and organizations.

You might also be able to get the required permissions through custom roles or other predefined roles.

Example commands

Now that you have the Device Run service, you can run the following commands to try out the catalog.

First, list all of the devices in your project:

gcloud beta device-run devices list

Next, list all of the sessions in your project (likely none, try later):

gcloud beta device-run sessions

Now continue onto the feature instructions under What's next.

Supporting documentation

• Google Cloud Skills README
• Developer Device Platform Agent Skills repository

Contact us

Visit the DDP Developer Forum to get help and offer suggestions.

To report bugs and file feature requests for the Developer Device Platform, create an issue.

Clean up

To avoid incurring charges to your Google Cloud account for the resources used on this page, delete the Google Cloud project with the resources.

What's next

• Device Catalog - Describe all of the device types in the Developer Device Platform lab and delve into each type.
• Device Run - Run tests on devices in the Developer Device Platform lab and see the results in Google Cloud.
• Find Logs - See your results at the command line and in the Google Cloud console.
• Device Streaming API - Connect to remote physical Android devices and interact with your app as if it is connected to your local machine.
• Agentic Development with Device Streaming - Use the Developer Device Platform agent skill to find, reserve and connect to devices in Developer Device Platform.