鸿蒙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台,设备添加后一年内删除仍占配额,满一年后自动清除。

相关推荐
KevinChaos2 小时前
随手备忘录手记 04|HarmonyOS 7.0新特性实验:物品图鉴的加载逻辑
华为·harmonyos
Sirius_Ji9 小时前
从硬解基座到字幕与滤镜链:ffmpeg-for-HarmonyOS v0.3.2
harmonyos
用户861941772074110 小时前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
微信·harmonyos
码间留白11 小时前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
uni-app·harmonyos·鸿蒙·uts插件·微信商家转账
GitCode官方1 天前
开源鸿蒙跨平台直播|AI 时代,用 cj-tauri 开发鸿蒙 PC 应用
人工智能·华为·harmonyos·atomgit
程序猿追1 天前
鸿蒙 PC 用 Tauri 做本地查找,怎样让慢请求给新请求让路
华为·状态模式·harmonyos
程序猿追1 天前
鸿蒙 PC 用 Ionic 做巡检目录,缩窄窗口后草稿还在吗
华为·harmonyos
jianqiang.xue1 天前
1颗NPU分时复用:鸿蒙把轻AI塞进了MCU
人工智能·单片机·mcu·嵌入式·harmonyos·鸿蒙·端侧ai
程序猿追1 天前
鸿蒙 PC 用 Tauri 迁移配置文件,先保留旧版再写新版
华为·harmonyos
码间留白2 天前
AI 给的两个方案都被我否了:把 startIcon 与启动遮罩做成同一张图,鸿蒙 APP 冷启动零白屏
性能优化·uni-app·ai编程·harmonyos