快速入门:准备使用开发者设备平台
设置使用开发者设备平台,这是一个用于远程设备编排的下一代商业级套件。
准备工作
开发者设备平台可在任何具有终端和互联网访问权限的工作站上运行,只需按照本页面的说明操作即可。
这些文档假定您是 Google Cloud 用户,拥有项目和账号, 如本网站 “概览”标签页中的使用入门 Google Cloud中所述。
Google Cloud 配置
- 登录您的 Google Cloud 账号。如果您是新手 Google Cloud, 请创建一个账号来评估我们的产品在 实际场景中的表现。新客户还可获享 $300 赠金,用于 运行、测试和部署工作负载。
-
安装 Google Cloud CLI。
-
如果您使用的是外部身份提供方 (IdP),则必须先使用联合身份登录 gcloud CLI。
-
如需初始化 gcloud CLI,请运行以下命令:
gcloud init -
验证是否已为您的 Google Cloud 项目启用结算功能。
启用 Device Run、Device Streaming、Cloud Testing API:
启用 API 所需的角色
如需启用 API,您需要拥有
serviceusage.services.enable权限。如果您 创建了项目,则可能已通过 Owner 角色 (roles/owner) 拥有此权限。否则,您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。 了解如何授予角色。gcloud services enable devicerun.googleapis.com
devicestreaming.googleapis.com testing.googleapis.com -
如果您使用的是本地 shell,请为您的用户 账号创建本地身份验证凭证:
gcloud auth application-default login
如果您使用的是 Cloud Shell,则无需执行此操作。
如果返回了身份验证错误,并且您使用的是外部身份提供方 (IdP),请确认您已 使用联合身份登录 gcloud CLI。
-
安装 Google Cloud CLI。
-
如果您使用的是外部身份提供方 (IdP),则必须先使用联合身份登录 gcloud CLI。
-
如需初始化 gcloud CLI,请运行以下命令:
gcloud init -
验证是否已为您的 Google Cloud 项目启用结算功能。
启用 Device Run、Device Streaming、Cloud Testing API:
启用 API 所需的角色
如需启用 API,您需要拥有
serviceusage.services.enable权限。如果您 创建了项目,则可能已通过 Owner 角色 (roles/owner) 拥有此权限。否则,您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。 了解如何授予角色。gcloud services enable devicerun.googleapis.com
devicestreaming.googleapis.com testing.googleapis.com -
如果您使用的是本地 shell,请为您的用户 账号创建本地身份验证凭证:
gcloud auth application-default login
如果您使用的是 Cloud Shell,则无需执行此操作。
如果返回了身份验证错误,并且您使用的是外部身份提供方 (IdP),请确认您已 使用联合身份登录 gcloud CLI。
所需的角色
如需获取使用开发者设备平台所需的权限,请让您的管理员为您授予项目的以下 IAM 角色:
-
全部:
- Role Viewer (
roles/viewer) - Device Run Admin (
roles/devicerun.googleapis.com/admin) - Device Streaming Admin (
roles/devicestreaming.admin) - Service Usage Consumer (
roles/serviceusage.serviceUsageConsumer)
- Role Viewer (
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
示例指令
现在您已拥有 Device Run 服务,可以运行以下命令来试用目录。
首先,列出项目中的所有设备:
gcloud device-run devices list
接下来,列出项目中的所有会话(可能没有):
gcloud device-run sessions
现在,请继续阅读“后续步骤”下的功能说明,或 按照下一部分使用开发者设备平台智能体技能。
安装开发者设备平台智能体技能
除了建立本页面所述的 Google Cloud 环境之外, 您还需要为开发者设备平台智能体技能安装以下软件包:
- ADB 用于在 远程 Android 设备上运行命令
- 用于启用 ADB 转发的 Python 环境
- Antigravity 或任何其他支持智能体技能的 AI 编程 智能体
- Node.js 和 NPM
软件包
用于使用
npx安装智能体技能
现在,使用以下命令安装开发者设备平台智能体技能:
npx skills add https://github.com/google/skills --skill developer-device-platform-basics
现在,请继续阅读“后续步骤”下的功能说明。
支持文档
清理
为避免因本页面中使用的资源导致您的 Google Cloud 账号产生费用,请删除包含这些资源的 Google Cloud 项目。
后续步骤
- 设备目录 - 介绍 DDP 实验室中的所有设备类型,并深入了解每种类型
- Device Run - 在 DDP 实验室中的设备上运行测试,并在中查看结果 Google Cloud
- Device Streaming API - 连接到远程实体 Android 设备,并与您的应用互动,就像它连接到您的 本地机器一样
- 基于 Device Streaming 的智能体化开发 - 使用开发者设备平台智能体技能在 DDP 中查找、预留和连接设备