HarmonyOS 如何获取设备信息（系统、版本、网络连接状态）

前言

HarmonyOS 提供了一个强大的 API 集，方便开发者获取设备的硬件和软件信息。通过 @kit.BasicServicesKit 模块的 deviceInfo 接口，开发者可以访问设备的型号、品牌、系统版本等详细信息。本文将详细介绍如何使用这些接口获取设备信息，并提供一个完整的 Demo 示例代码。

一、引入模块和基本设备信息的获取

首先，引入 @kit.BasicServicesKit 模块，然后通过 deviceInfo 接口获取设备的基本信息。这些信息包括设备类型、制造商、品牌等。以下是获取设备基本信息的代码示例：

import { deviceInfo } from '@kit.BasicServicesKit';// 获取设备类型
let deviceTypeInfo: string = deviceInfo.deviceType;
console.info('Device Type: ' + deviceTypeInfo);// 获取设备制造商信息
let manufactureInfo: string = deviceInfo.manufacture;
console.info('Manufacture: ' + manufactureInfo);// 获取品牌信息
let brandInfo: string = deviceInfo.brand;
console.info('Brand: ' + brandInfo);// 获取市场名称
let marketNameInfo: string = deviceInfo.marketName;
console.info('Market Name: ' + marketNameInfo);

二、设备硬件和系统版本信息的获取

HarmonyOS 提供了详细的硬件和系统版本信息，包括设备系列、硬件型号、软件版本、OS 版本等。这些信息有助于开发者根据设备的特性做出优化适配。以下是获取设备硬件和系统版本信息的代码示例：

// 获取设备系列
let productSeriesInfo: string = deviceInfo.productSeries;
console.info('Product Series: ' + productSeriesInfo);// 获取产品型号
let productModelInfo: string = deviceInfo.productModel;
console.info('Product Model: ' + productModelInfo);// 获取系统显示版本
let displayVersionInfo: string = deviceInfo.displayVersion;
console.info('Display Version: ' + displayVersionInfo);// 获取增量版本
let incrementalVersionInfo: string = deviceInfo.incrementalVersion;
console.info('Incremental Version: ' + incrementalVersionInfo);// 获取 OS 全名
let osFullNameInfo: string = deviceInfo.osFullName;
console.info('OS Full Name: ' + osFullNameInfo);

三、获取安全相关的设备信息

在某些应用场景中，了解设备的安全补丁和系统版本信息是非常重要的。HarmonyOS 提供了安全补丁标签、引导加载程序版本等信息，便于开发者确保应用运行在安全的设备环境上。

// 获取安全补丁标签
let securityPatchTagInfo: string = deviceInfo.securityPatchTag;
console.info('Security Patch Tag: ' + securityPatchTagInfo);// 获取引导加载程序版本
let bootloaderVersionInfo: string = deviceInfo.bootloaderVersion;
console.info('Bootloader Version: ' + bootloaderVersionInfo);

四、获取网络状态信息

设备的网络状态对于某些功能的实现至关重要。HarmonyOS 提供了接口帮助开发者判断设备是否连接到网络。以下是获取当前网络状态的示例代码：

import { network } from '@kit.NetworkKit';function checkNetworkConnection() {let isNetworkConnected: boolean = network.isConnected;console.info('Network Connected: ' + isNetworkConnected);
}
checkNetworkConnection();

五、完整 Demo 代码

我们利用 HarmonyOS 提供的 deviceInfo 和 network 两个模块，来获取设备的基础信息、系统版本信息和网络连接状态。以下是 Demo 的详细解释。

1. 导入所需模块

首先，我们需要引入两个模块：

• @kit.BasicServicesKit 提供了 deviceInfo 对象，用于访问设备的基本信息，如设备类型、制造商、品牌、系统版本等。
• @kit.NetworkKit 提供了 network 对象，用于检测当前设备的网络连接状态。

import { deviceInfo } from '@kit.BasicServicesKit';
import { network } from '@kit.NetworkKit';

2. 获取设备基本信息

getDeviceInfo 函数用于获取和输出设备的各种信息，包括类型、制造商、品牌、系统版本等。

代码解析

• deviceInfo.deviceType: 获取设备的类型，如手机、平板等。
• deviceInfo.manufacture: 获取设备的制造商名称。
• deviceInfo.brand: 获取设备的品牌，如华为。
• deviceInfo.marketName: 获取设备在市场上的商品名称。

function getDeviceInfo() {console.info('--- Device Information ---');console.info('Device Type: ' + deviceInfo.deviceType);console.info('Manufacture: ' + deviceInfo.manufacture);console.info('Brand: ' + deviceInfo.brand);console.info('Market Name: ' + deviceInfo.marketName);

示例输出：

Device Type: Phone
Manufacture: Huawei
Brand: HUAWEI
Market Name: P50 Pro

• deviceInfo.productSeries: 获取设备的系列信息，例如 P 系列、Mate 系列等。
• deviceInfo.productModel: 获取设备的产品型号。
• deviceInfo.displayVersion: 获取设备的显示版本，这个信息通常用来表示操作系统的整体版本。
• deviceInfo.incrementalVersion: 获取增量版本，用于区别小版本更新。
• deviceInfo.osFullName: 获取操作系统的完整名称。

    console.info('Product Series: ' + deviceInfo.productSeries);console.info('Product Model: ' + deviceInfo.productModel);console.info('Display Version: ' + deviceInfo.displayVersion);console.info('Incremental Version: ' + deviceInfo.incrementalVersion);console.info('OS Full Name: ' + deviceInfo.osFullName);

示例输出：

Product Series: P Series
Product Model: P50
Display Version: HarmonyOS 3.0
Incremental Version: 123456
OS Full Name: HarmonyOS

• deviceInfo.securityPatchTag: 获取设备的安全补丁标签，用于了解设备的安全更新状态。
• deviceInfo.bootloaderVersion: 获取引导加载程序版本，用于设备的启动和安全相关的操作。

    console.info('Security Patch Tag: ' + deviceInfo.securityPatchTag);console.info('Bootloader Version: ' + deviceInfo.bootloaderVersion);
}

示例输出：

Security Patch Tag: 2024-09-01
Bootloader Version: V1.0.0

3. 检测网络连接状态

checkNetworkConnection 函数用于检测设备的网络连接状态。通过 network.isConnected 属性，判断设备是否已连接到网络，返回一个布尔值，true 表示连接，false 表示未连接。

function checkNetworkConnection() {console.info('--- Network Connection Status ---');let isNetworkConnected: boolean = network.isConnected;console.info('Network Connected: ' + isNetworkConnected);
}

示例输出：

Network Connected: true

4. 执行函数

最后，调用 getDeviceInfo 和 checkNetworkConnection 函数来输出设备信息和网络状态：

getDeviceInfo();
checkNetworkConnection();

总结

本文展示了如何在 HarmonyOS 中获取设备的详细信息，包括设备类型、品牌、系列、产品型号、系统版本以及网络连接状态。HarmonyOS 提供的 deviceInfo 和 network 模块使得设备信息和网络状态的获取变得简便。在实际开发中，这些信息对于设备的适配、功能的优化以及安全检查都至关重要。

通过这些接口，开发者可以动态地了解设备的特性和当前网络状态，从而实现更智能化、个性化的应用体验。