鸿蒙AGC设备管理:设备注册(一)
·
在鸿蒙应用开发中,使用真机调试或将应用发布到指定设备时,需要先将测试设备在AGC上进行注册。
一、设备管理
进行调试和指定设备发布时,需要将HarmonyOS应用/元服务安装到指定的设备上。为了保证安全性,待安装的设备需要在AGC上进行注册。
设备管理限额
| 限制 | 说明 |
|---|---|
| 每个账号最多 | 100台设备 |
设备删除规则
| 情况 | 说明 |
|---|---|
| 添加后一年内删除 | 设备置灰显示且不再可用,但仍占用这一年度的设备数量限额 |
| 添加满一年后删除 | 自动被清除,不再占用年度的设备数量限额 |
| 一年内重新添加 | 注册时间依然以首次注册时间为准 |
二、注册设备
2.1 进入设备管理页面
-
登录AppGallery Connect,选择"证书、APP ID和Profile"
-
在左侧导航栏选择"证书、APP ID和Profile → 设备"
2.2 方式一:添加单个设备
点击右上角"添加设备",在弹出窗口填写设备信息:
| 参数 | 说明 |
|---|---|
| 名称 | 自定义设备名称,最大100字符,建议易识别(如"XX用户"、"XX机型") |
| 类型 | 要注册的设备类型 |
| UDID | 设备唯一标识符,64位字符串(字母+数字) |
2.3 方式二:批量导入设备
-
点击右上角"批量导入"
-
点击"下载模板"
-
在模板表格中填写设备信息(名称、类型、UDID)
-
点击"点击上传文件"或拖拽上传填写好的模板文件
-
点击"提交"
注意:请将模板中"UDID"列单元格设置为文本格式。
2.4 设备查询
| 查询方式 | 说明 |
|---|---|
| 设备名称 | 支持模糊查询 |
| 设备UDID | 仅支持精确查询 |
| UDID展示 | 以密文展示,鼠标悬停可查看完整UDID |
三、UDID获取方法
3.1 手机、平板、PC/2in1、智能手表、智慧屏
步骤:
-
在设备上打开USB调试权限
-
使用PC连接设备,打开命令行工具
-
进入HDC目录(一般为:
DevEco Studio安装目录/sdk/default/openharmony/toolchains) -
执行命令:
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获取
-
使用华为手机,从应用市场下载安装应用调测助手和运动健康app
-
打开应用调测助手,选择"Lite Wearable"页签
-
点击"连接设备",自动打开运动健康app
-
在运动健康app的"设备"页签中,点击"添加设备"
-
在"手表"列表,选择对应的手表型号
-
点击"开始配对",完成配对
-
配对成功后,应用调测助手界面显示手表型号和UDID,点击"复制"即可
完整流程
获取设备UDID
↓
登录AGC → 证书、APP ID和Profile → 设备
↓
添加设备(单个/批量导入)
↓
填写设备名称、类型、UDID
↓
提交完成注册
鸿蒙AGC管理设备需先获取设备UDID(手机/平板用hdc shell bm get --udid,运动手表用应用调测助手),再在AGC设备页面单个添加或批量导入,每个账号最多100台,设备添加后一年内删除仍占配额,满一年后自动清除。
更多推荐




所有评论(0)