鸿蒙AGC设备管理:设备注册(一)

在鸿蒙应用开发中,使用真机调试或将应用发布到指定设备时,需要先将测试设备在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台,设备添加后一年内删除仍占配额,满一年后自动清除。

相关推荐
李游Leo15 小时前
HarmonyOS 7 + Spatial Recon Kit-C++:3DGS 高斯参数的非有限值隔离与可渲染性门禁【鸿蒙心迹】
开发语言·c++·3d·harmonyos
传奇开心果编程16 小时前
【ArkUI进阶练中学】第12课:应用架构演进与遗留系统迁移
学习·ui·华为·harmonyos
传奇开心果编程18 小时前
【ArkUI进阶练中学】第13课:元服务与卡片开发
学习·ui·华为·harmonyos
李游Leo19 小时前
HarmonyOS 7 InsightBoard 多形态适配实录 06:ArkUI × 多设备回归:布局抖动、监听释放与全形态验收【鸿蒙心迹】
回归·kotlin·harmonyos
李游Leo19 小时前
HarmonyOS 7 PixelBridge 原生库适配实录 04:Native Buffer Pool、批任务背压与取消链路【鸿蒙心迹】
华为·harmonyos
李游Leo19 小时前
HarmonyOS 7 Spatial Recon Kit 开发实录 01:支持检测、Session 创建与首条有效重建链路【鸿蒙心迹】
华为·harmonyos
传奇开心果编程19 小时前
【ArkUI进阶练中学】第19课:AI安全与隐私治理
学习·ui·华为·harmonyos
李游Leo20 小时前
HarmonyOS 7 QuickDock 闪控窗开发实录 06:floatView × 回归验收:25轮场景回归、资源基线与发布前收口【鸿蒙心迹】
回归·kotlin·harmonyos
李游Leo20 小时前
HarmonyOS 7 DualCart 平行视界适配实录 06:Navigation × 多窗口回归:路由冲突、恢复一致性与性能验收【鸿蒙心迹】
回归·kotlin·harmonyos