harmony-utils 之 DeviceUtil，设备相关工具类

2025-06-25
安徽
本文字数：2591 字
阅读完需：约 9 分钟

harmony-utils 之 DeviceUtil，设备相关工具类

harmony-utils 简介与说明

harmony-utils 一款功能丰富且极易上手的 HarmonyOS 工具库，借助众多实用工具类，致力于助力开发者迅速构建鸿蒙应用。其封装的工具涵盖了 APP、设备、屏幕、授权、通知、线程间通信、弹框、吐司、生物认证、用户首选项、拍照、相册、扫码、文件、日志，异常捕获、字符、字符串、数字、集合、日期、随机、base64、加密、解密、JSON 等一系列的功能和操作，能够满足各种不同的开发需求。

picker_utils 是 harmony-utils 拆分出来的一个子库，包含 PickerUtil、PhotoHelper、ScanUtil。

下载安装

ohpm i @pura/harmony-utils

ohpm i @pura/picker_utils

  //全局初始化方法，在UIAbility的onCreate方法中初始化 AppUtil.init()  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {    AppUtil.init(this.context);  }

复制代码

API 方法与使用

getDeviceId 获取设备 ID（卸载 APP 后依旧不变，需要权限：ohos.permission.STORE_PERSISTENT_DATA）

  let id = DeviceUtil.getDeviceId();  DialogHelper.showToast(`当前设备号为：${id}`);

复制代码

deleteDeviceId 移除设备 ID

  DeviceUtil.deleteDeviceId();  ToastUtil.showToast("移除设备ID成功！")

复制代码

getODID 获取开发者匿名设备标识符，ODID

 let ODID = DeviceUtil.getODID(); DialogHelper.showToast(`开发者匿名设备标识符为：${ODID}`);

复制代码

getOAID 获取开放匿名设备标识符，OAID

PermissionUtil.requestPermissionsEasy("ohos.permission.APP_TRACKING_CONSENT").then(async (grant) => {  if (grant) {    DeviceUtil.getOAID().then((id) => {      ToastUtil.showToast("开放匿名设备标识符位：" + id);    }).catch((err: BusinessError) => {      ToastUtil.showToast(`开放匿名设备标识符获取失败，${err.message}！`);    });  } else {    ToastUtil.showToast("您拒绝了权限！")  }});

复制代码

getAAID 获取应用匿名标识符，AAID

  let AAID = await DeviceUtil.getAAID();  DialogHelper.showToast(`AAID为：${AAID}`);

复制代码

deleteAAID 删除应用匿名标识符，AAID

 DeviceUtil.deleteAAID();

复制代码

getSerial 获取设备序列号。说明：可作为设备唯一识别码。示例：序列号随设备差异。需要权限：ohos.permission.sec.ACCESS_UDID (目前只限系统应用使用，不对三方应用开放)

 let str = DeviceUtil.getSerial();

复制代码

getUdid 获取设备 Udid。需要权限：ohos.permission.sec.ACCESS_UDID (目前只限系统应用使用，不对三方应用开放)

 let str = DeviceUtil.getUdid();

复制代码

getBrand 获取设备品牌名称。示例：HUAWEI

 let str = DeviceUtil.getBrand();

复制代码

getProductModel 获取认证型号。示例：ALN-AL00

 let str = DeviceUtil.getProductModel();

复制代码

getBrandModel 获取设备品牌名称认证型号。示例：HUAWEI ALN-AL00

 let str = DeviceUtil.getBrandModel();

复制代码

getMarketName 获取外部产品系列名称。示例：HUAWEI Mate 60 Pro

 let str = DeviceUtil.getMarketName();

复制代码

getHardwareModel 获取硬件版本号。示例：HL1CMSM

 let str = DeviceUtil.getHardwareModel();

复制代码

getManufacture 获取设备厂家名称。示例：HUAWEI

 let str = DeviceUtil.getManufacture();

复制代码

getOsFullName 获取系统版本

 let str = DeviceUtil.getOsFullName();

复制代码

getDisplayVersion 获取产品版本。示例：ALN-AL00 5.0.0.1(XXX)

 let str = DeviceUtil.getDisplayVersion();

复制代码

getBuildVersion 获取 Build 版本号，标识编译构建的版本号

 let str = DeviceUtil.getBuildVersion();

复制代码

getSdkApiVersion 获取系统软件 API 版本。示例：12

 let str = DeviceUtil.getSdkApiVersion();

复制代码

getOsVersion 获取 OS 版本号（Major 版本号,示例：5；Senior 版本号，示例：0；Feature 版本号，示例：0）

 let str = DeviceUtil.getOsVersion();

复制代码

getAbiList 应用二进制接口（Abi）。示例：arm64-v8a

 let str = DeviceUtil.getAbiList();

复制代码

getOsReleaseType 获取系统的发布类型，取值为：Canary、Beta、Release

 let str = DeviceUtil.getOsReleaseType();

复制代码

getDeviceType 获取当前设备类型

 let str = DeviceUtil.getDeviceType();

复制代码

getDeviceTypeStr 获取当前设备类型，返回字符串

 let str = DeviceUtil.getDeviceTypeStr();

复制代码

getConfiguration 获取设备的 Configuration

  let configuration = DeviceUtil.getConfigurationSync();  let jsonStr = JSON.stringify(configuration, null, 2);

复制代码

getDirection 获取当前设备屏幕方向

  let direction = DeviceUtil.getDirection();

复制代码

getDeviceCapability 获取设备的 DeviceCapability

  let deviceCapability = DeviceUtil.getDeviceCapabilitySync();  let jsonStr = JSON.stringify(deviceCapability, null, 2);

复制代码

getScreenDensity 获取当前设备屏幕密度

  let density = DeviceUtil.getScreenDensity();  ToastUtil.showToast(`前设备屏幕密度: ${density}`)

复制代码

getBatterySOC 获取当前设备剩余电池电量百分比

  let result = DeviceUtil.getBatterySOC();

复制代码

getBatteryCapacityLevel 获取当前设备电池电量的等级

  let result = DeviceUtil.getBatteryCapacityLevel();

复制代码

getHealthStatus 获取当前设备电池的健康状态

  let result = DeviceUtil.getHealthStatus();

复制代码

getBatteryTemperature 获取当前设备电池的温度，单位 0.1 摄氏度

  let result = DeviceUtil.getBatteryTemperature();

复制代码

getVoltage 获取当前设备电池的电压，单位微伏

  let result = DeviceUtil.getVoltage();

复制代码

getNowCurrent 获取当前设备电池的电流，单位毫安

  let result = DeviceUtil.getNowCurrent();

复制代码

isActive 检测当前设备是否处于活动状态。有屏的设备为亮屏状态，无屏的设备为非休眠状态

  let result = DeviceUtil.isActive();

复制代码

isStandby 检测当前设备是否进入待机低功耗续航模式

  let result = DeviceUtil.isStandby();

复制代码

getPowerMode 获取当前设备的电源模式

  let result = DeviceUtil.getPowerMode();

复制代码

startVibration 开启设备振动

  DeviceUtil.getNowCurrent();

复制代码

stopVibration 停止设备振动（按照 VIBRATOR_STOP_MODE_TIME 模式）

  DeviceUtil.stopVibration();

复制代码

创作不易，请给童长老点赞👍

https://github.com/787107497/harmony-utils

https://gitee.com/tongyuyan/harmony-utils

OpenHarmony三方库

童长老CSDN博客

发布于: 2025-06-25阅读数: 12

桃花镇童长老

关注

还未添加个人签名 2025-05-14 加入

还未添加个人简介

发布

暂无评论

创作场景

harmony-utils 之 DeviceUtil，设备相关工具类

harmony-utils 之 DeviceUtil，设备相关工具类

harmony-utils 简介与说明

API 方法与使用

getDeviceId 获取设备 ID（卸载 APP 后依旧不变，需要权限：ohos.permission.STORE_PERSISTENT_DATA）

deleteDeviceId 移除设备 ID

getODID 获取开发者匿名设备标识符，ODID

getOAID 获取开放匿名设备标识符，OAID

getAAID 获取应用匿名标识符，AAID

deleteAAID 删除应用匿名标识符，AAID

getSerial 获取设备序列号。说明：可作为设备唯一识别码。示例：序列号随设备差异。需要权限：ohos.permission.sec.ACCESS_UDID (目前只限系统应用使用，不对三方应用开放)

getUdid 获取设备 Udid。需要权限：ohos.permission.sec.ACCESS_UDID (目前只限系统应用使用，不对三方应用开放)

getBrand 获取设备品牌名称。示例：HUAWEI

getProductModel 获取认证型号。示例：ALN-AL00

getBrandModel 获取设备品牌名称 认证型号。示例：HUAWEI ALN-AL00

getMarketName 获取外部产品系列名称。示例：HUAWEI Mate 60 Pro

getHardwareModel 获取硬件版本号。示例：HL1CMSM

getManufacture 获取设备厂家名称。示例：HUAWEI

getOsFullName 获取系统版本

getDisplayVersion 获取产品版本。示例：ALN-AL00 5.0.0.1(XXX)

getBuildVersion 获取 Build 版本号，标识编译构建的版本号

getSdkApiVersion 获取系统软件 API 版本。示例：12

getOsVersion 获取 OS 版本号（Major 版本号,示例：5；Senior 版本号，示例：0；Feature 版本号，示例：0）

getAbiList 应用二进制接口（Abi）。示例：arm64-v8a

getOsReleaseType 获取系统的发布类型，取值为：Canary、Beta、Release

getDeviceType 获取当前设备类型

getDeviceTypeStr 获取当前设备类型，返回字符串

getConfiguration 获取设备的 Configuration

getDirection 获取当前设备屏幕方向

getDeviceCapability 获取设备的 DeviceCapability

getScreenDensity 获取当前设备屏幕密度

getBatterySOC 获取当前设备剩余电池电量百分比

getBatteryCapacityLevel 获取当前设备电池电量的等级

getHealthStatus 获取当前设备电池的健康状态

getBatteryTemperature 获取当前设备电池的温度，单位 0.1 摄氏度

getVoltage 获取当前设备电池的电压，单位微伏

getNowCurrent 获取当前设备电池的电流，单位毫安

isActive 检测当前设备是否处于活动状态。有屏的设备为亮屏状态，无屏的设备为非休眠状态

isStandby 检测当前设备是否进入待机低功耗续航模式

getPowerMode 获取当前设备的电源模式

startVibration 开启设备振动

stopVibration 停止设备振动（按照 VIBRATOR_STOP_MODE_TIME 模式）

创作不易，请给童长老点赞👍

桃花镇童长老

评论

getBrandModel 获取设备品牌名称认证型号。示例：HUAWEI ALN-AL00