在鸿蒙应用开发中,使用真机调试或将应用发布到指定设备时,需要先将测试设备在AGC上进行注册。

一、设备管理

进行调试和指定设备发布时,需要将HarmonyOS应用/元服务安装到指定的设备上。为了保证安全性,待安装的设备需要在AGC上进行注册。

设备管理限额

限制 说明
每个账号最多 100台设备

设备删除规则

情况 说明
添加后一年内删除 设备置灰显示且不再可用,但仍占用这一年度的设备数量限额
添加满一年后删除 自动被清除,不再占用年度的设备数量限额
一年内重新添加 注册时间依然以首次注册时间为准

二、注册设备

2.1 进入设备管理页面

  1. 登录AppGallery Connect,选择"证书、APP ID和Profile"

  2. 在左侧导航栏选择"证书、APP ID和Profile → 设备"

2.2 方式一:添加单个设备

点击右上角"添加设备",在弹出窗口填写设备信息:

参数 说明
名称 自定义设备名称,最大100字符,建议易识别(如"XX用户"、"XX机型")
类型 要注册的设备类型
UDID 设备唯一标识符,64位字符串(字母+数字)

2.3 方式二:批量导入设备

  1. 点击右上角"批量导入"

  2. 点击"下载模板"

  3. 在模板表格中填写设备信息(名称、类型、UDID)

  4. 点击"点击上传文件"或拖拽上传填写好的模板文件

  5. 点击"提交"

注意:请将模板中"UDID"列单元格设置为文本格式

2.4 设备查询

查询方式 说明
设备名称 支持模糊查询
设备UDID 仅支持精确查询
UDID展示 以密文展示,鼠标悬停可查看完整UDID

三、UDID获取方法

3.1 手机、平板、PC/2in1、智能手表、智慧屏

步骤

  1. 在设备上打开USB调试权限

  2. 使用PC连接设备,打开命令行工具

  3. 进入HDC目录(一般为:DevEco Studio安装目录/sdk/default/openharmony/toolchains

  4. 执行命令:hdc shell bm get --udid

3.2 多设备连接处理

问题 解决方案
返回[Fail]ExecuteCommand need connect-key? 连接了多台设备或同时连接模拟器和真机
同时连接模拟器和真机 断开模拟器
连接了多台设备 先执行hdc list targets查询设备列表
再执行hdc -t connect-key shell bm get --udid(connect-key为设备标识符)

3.3 运动手表UDID获取

  1. 使用华为手机,从应用市场下载安装应用调测助手运动健康app

  2. 打开应用调测助手,选择"Lite Wearable"页签

  3. 点击"连接设备",自动打开运动健康app

  4. 在运动健康app的"设备"页签中,点击"添加设备"

  5. 在"手表"列表,选择对应的手表型号

  6. 点击"开始配对",完成配对

  7. 配对成功后,应用调测助手界面显示手表型号和UDID,点击"复制"即可

完整流程

获取设备UDID
    ↓
登录AGC → 证书、APP ID和Profile → 设备
    ↓
添加设备(单个/批量导入)
    ↓
填写设备名称、类型、UDID
    ↓
提交完成注册

   鸿蒙AGC管理设备需先获取设备UDID(手机/平板用hdc shell bm get --udid,运动手表用应用调测助手),再在AGC设备页面单个添加或批量导入,每个账号最多100台,设备添加后一年内删除仍占配额,满一年后自动清除。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐