模板版本：v0.2.2
[!TIP] Github 地址
请到三方库的 Releases 发布地址查看配套的版本信息：@react-native-oh-tpl/react-native-device-info Releases 。对于未发布到npm的旧版本，请参考安装指南安装tgz包。
进入到工程目录并输入以下命令：
npm install @react-native-oh-tpl/react-native-device-infoyarn add @react-native-oh-tpl/react-native-device-info下面的代码展示了这个库的基本使用场景：
[!WARNING] 使用时 import 的库名不变。
import DeviceInfo from 'react-native-device-info';
DeviceInfo.getBundleId();
DeviceInfo.getVersion();
DeviceInfo.getReadableVersion();
DeviceInfo.getBuildNumber();
DeviceInfo.isTablet();
DeviceInfo.getApplicationName();
DeviceInfo.getBrand();
DeviceInfo.getModel();
DeviceInfo.getDeviceType();本库已经适配了 Codegen ，在使用前需要主动执行生成三方库桥接代码，详细请参考 Codegen 使用文档。
目前HarmonyOS暂不支持 AutoLink，所以 Link 步骤需要手动配置。
首先需要使用 DevEco Studio 打开项目里的HarmonyOS工程 harmony
{
...
"overrides": {
"@rnoh/react-native-openharmony" : "./react_native_openharmony"
}
}目前有两种方法：
- 通过 har 包引入（在 IDE 完善相关功能后该方法会被遗弃，目前首选此方法）；
- 直接链接源码。
方法一：通过 har 包引入（推荐）
[!TIP] har 包位于三方库安装路径的
harmony文件夹下。
打开 entry/oh-package.json5，添加以下依赖
"dependencies": {
"@rnoh/react-native-openharmony": "file:../react_native_openharmony",
"@react-native-oh-tpl/react-native-device-info": "file:../../node_modules/@react-native-oh-tpl/react-native-device-info/harmony/device_info.har"
}点击右上角的 sync 按钮
或者在终端执行：
cd entry
ohpm install方法二：直接链接源码
[!TIP] 如需使用直接链接源码，请参考直接链接源码说明
打开 entry/src/main/ets/RNPackagesFactory.ts，添加：
...
+ import {RNDeviceInfoPackage} from '@react-native-oh-tpl/react-native-device-info/ts';
export function createRNPackages(ctx: RNPackageContext): RNPackage[] {
return [
new SamplePackage(ctx),
+ new RNDeviceInfoPackage(ctx)
];
}点击右上角的 sync 按钮
或者在终端执行：
cd entry
ohpm install然后编译、运行即可。
要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。
请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：@react-native-oh-tpl/react-native-device-info Releases
打开 entry/src/main/module.json5，添加：
...
"requestPermissions": [
{
"name": "ohos.permission.GET_NETWORK_INFO"
},
{
"name": "ohos.permission.GET_WIFI_INFO"
}
][!TIP] "Platform"列表示该属性在原三方库上支持的平台。
[!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。
| Name | Description | Type | Required | Platform | HarmonyOS Support |
|---|---|---|---|---|---|
| getAndroidId | Gets the ANDROID_ID. See API documentation for appropriate use. | Promise | yes | Android | no |
| getApiLevel | Gets the API level. | Promise | yes | Android | yes |
| getApplicationName | Gets the application name. | string | yes | IOS/Android/Windows/visionOS | yes |
| getAvailableLocationProviders | Returns an object of platform-specfic location providers/servcies, with value whether or not they are currently available.boolean | Promise | yes | IOS/Android/visionOS | yes |
| getBaseOs | The base OS build the product is based on. | Promise | yes | Android/Windows/Web | yes |
| getBuildId | Gets build number of the operating system. | Promise | yes | IOS/Android/Windows/visionOS | yes |
| getBatteryLevel | Gets the battery level of the device as a float comprised between 0 and 1. | Promise | yes | IOS/Android /Windows/Web/visionOS | yes |
| getBootloader | The system bootloader version number. | Promise | yes | Android | yes |
| getBrand | Gets the device brand. | string | yes | IOS/Android/Windows/visionOS | yes |
| getBuildNumber | Gets the application build number. | string | yes | IOS/Android/Windows/visionOS | yes |
| getBundleId | Gets the application bundle identifier. | string | yes | IOS/Android/Windows/visionOS | yes |
| isCameraPresent | Tells if the device has any camera now. | Promise | yes | Android/Windows/Web | yes |
| getCarrier | Gets the carrier name (network operator). | Promise | yes | IOS/Android | yes |
| getCodename | The current development codename, or the string "REL" if this is a release build. | Promise | yes | Android | yes |
| getDevice | The name of the industrial design. | Promise | yes | Android | yes |
| getDeviceId | Gets the device ID. | string | yes | IOS/Android/Windows/visionOS | no |
| getDeviceType | TReturns the device's type as a string | string | yes | IOS/Android/visionOS | yes |
| getDisplay | A build ID string meant for displaying to the user. | Promise | yes | Android | yes |
| getDeviceName | Gets the device name. | Promise | yes | IOS/Android/Windows/visionOS | yes |
| getDeviceToken | Gets the device token (see DeviceCheck). Only available for iOS 11.0+ on real devices. This will reject the promise when getDeviceToken is not supported, be careful with exception handling. | Promise | yes | IOS/visionOS | no |
| getFirstInstallTime | Gets the time at which the app was first installed, in milliseconds. | Promise | yes | IOS/Android/Windows/visionOS | yes |
| getFingerprint | A string that uniquely identifies this build. | Promise | yes | Windows | no |
| getFontScale | Gets the device font scale. The font scale is the ratio of the current system font to the "normal" font size, so if normal text is 10pt and the system font is currently 15pt, the font scale would be 1.5 This can be used to determine if accessability settings has been changed for the device; you may want to re-layout certain views if the font scale is significantly larger ( > 2.0 ) | Promise | yes | IOS/Android/Windows | yes |
| getFreeDiskStorage | Method that gets available storage size, in bytes, taking into account both root and data file systems calculation. | Promise | yes | IOS/Android/Windows/Web/visionOS | no |
| getFreeDiskStorageOld | Old implementation of method that gets available storage size, in bytes. | Promise | yes | IOS/Android/Windows/Web/visionOS | no |
| getHardware | The name of the hardware (from the kernel command line or /proc). | Promise | yes | Android | yes |
| getHost | Hostname | Promise | yes | Android/Windows | yes |
| getHostNames | Hostnames | Promise<string[]> | yes | Windows | no |
| getIpAddress | Deprecated Gets the device current IP address. (of wifi only) Switch to react-native-netinfo/netinfo or react-native-network-info | Promise | yes | IOS/Android/Windows/visionOS | yes |
| getIncremental | The internal value used by the underlying source control to represent this build. | Promise | yes | Android | yes |
| getInstallerPackageName | The internal value used by the underlying source control to represent this build. | Promise | yes | IOS/Android/Windows/visoinOS | yes |
| getInstallReferrer | Gets the referrer string upon application installation. | Promise | yes | Android/Windows/Web | no |
| getInstanceId | Gets the application instance ID. | Promise | yes | Android | yes |
| getLastUpdateTime | Gets the time at which the app was last updated, in milliseconds. | Promise | yes | Android | yes |
| getMacAddress | Gets the network adapter MAC address. | Promise | yes | IOS/Android/visionOS | no |
| getManufacturer | Gets the device manufacturer. | Promise | yes | IOS/Android/visoinOS | yes |
| getManufacturerSync | Gets the device manufacturer. | string | yes | IOS/Android/visoinOS | yes |
| getMaxMemory | Returns the maximum amount of memory that the VM will attempt to use, in bytes. | Promise | yes | Android/Windows/Web | no |
| getModel | Gets the device model. | string | yes | IOS/Android | yes |
| getPowerState | Gets the power state of the device including the battery level, whether it is plugged in, and if the system is currently operating in low power mode. | Promise | yes | IOS/Android/Windows/Web/visionOS | yes |
| getProduct | The name of the overall product. | Promise | yes | Android | yes |
| getPreviewSdkInt | The developer preview revision of a prerelease SDK. | Promise | yes | Android | no |
| getReadableVersion | Gets the application human readable version (same as getVersion() + '.' + getBuildNumber()) | string | yes | IOS/Android/Windows/visionOS | yes |
| getSerialNumber | Gets the device serial number. Will be 'unknown' in almost all cases unless you have a privileged app and you know what you're doing. | Promise | yes | Android/Windows | no |
| getSecurityPatch | The user-visible security patch level. | Promise | yes | Android | yes |
| getSystemAvailableFeatures | Returns a list of available system features on Android. | Promise<string[]> | yes | Android | no |
| getSystemName | Gets the device OS name. | string | yes | IOS/Android/Windows/visoinOS | yes |
| getSystemVersion | Gets the device OS version. | string | yes | IOS/Android/Windows/visoinOS | yes |
| getTags | Comma-separated tags describing the build. | Promise | yes | Android | no |
| getType | The type of build. | Promise | yes | Android | yes |
| getTotalDiskCapacity | Method that gets full disk storage size, in bytes, taking into account both root and data file systems calculation. | Promise | yes | Android | no |
| getTotalDiskCapacityOld | Old implementation of method that gets full disk storage size, in bytes. | Promise | yes | Android | no |
| getTotalMemory | Gets the device total memory, in bytes. | Promise | yes | IOS/Android/Web/visionOS | no |
| getUniqueId | Gets the device unique ID. On Android it is currently identical to in this module. | Promise | yes | IOS/Android/Windows/visionOS | no |
| getUsedMemory | Gets the app memory usage, in bytes. | Promise | yes | IOS/Android/Windows/Web/visionOs | yes |
| getUserAgent | Gets the device User Agent. | Promise | yes | IOS/Android/Web/visionOs | no |
| getUserAgentSync | Gets the device User Agent. | string | yes | Android/Web | no |
| getVersion | Gets the application version. Take into account that a version string is device/OS formatted and can contain any additional data (such as build number etc.). If you want to be sure about version format, you can use a regular expression to get the desired portion of the returned version string. | string | yes | IOS/Android/Windows/visionOS | yes |
| getBrightness | Gets the current brightness level of the device's main screen. Currently iOS only. Returns a number between 0.0 and 1.0, inclusive. | Promise | yes | IOS | no |
| hasGms | Tells if the device supports Google Mobile Services. | Promise | yes | Android | yes |
| hasHms | Tells if the device supports Huawei Mobile Services. | Promise | yes | Android | yes |
| hasNotch | Tells if the device has a notch. | boolean | yes | IOS/Android/Windows/visionOS | no |
| hasDynamicIsland | Tells if the device has a dynamic island. | boolean | yes | IOS/Android/Windows/visionOS | no |
| hasSystemFeature | Tells if the device has a specific system feature. | Promise | yes | Android | no |
| isAirplaneMode | Tells if the device is in Airplane Mode. | Promise | yes | Android/ Web | yes |
| isBatteryCharging | Tells if the battery is currently charging. | Promise | yes | IOS/Android/Windows/Web/visionOS | yes |
| isEmulator | Tells if the application is running in an emulator. | Promise | yes | IOS/Android/Windows/visionOS | no |
| isKeyboardConnected | Tells if the device has a keyboard connected. | Promise | yes | Windows | yes |
| isLandscape | Tells if the device is currently in landscape mode. | Promise | yes | IOS/Android/Windows/visionOs | yes |
| isLocationEnabled | Allow access to user's location information | Promise | yes | IOS/Android/Web/visionOS | yes |
| isMouseConnected | Tells if the device has a mouse connected. | Promise | yes | Windows | yes |
| isHeadphonesConnected | Tells if the device has a Headphones connected. | Promise | yes | IOS/Android/visionOS | yes |
| isWiredHeadphonesConnected | Tells if the device has a WiredHeadphones connected. | Promise | yes | IOS/Android/visionOS | yes |
| isBluetoothHeadphonesConnected | Tells if the device has a BluetoothHeadphones connected. | Promise | yes | IOS/Android/visionOS | yes |
| isPinOrFingerprintSet | Tells if a PIN number or a fingerprint was set for the device. | Promise | yes | IOS/Android/Windows/visoinOs | yes |
| isTablet | Tells if the device is a tablet. | boolean | yes | IOS/Android/Windows/visoinOs | yes |
| isLowRamDevice | Tells if the device has low RAM. | boolean | yes | Android | yes |
| isDisplayZoomed | Tells if the user changed Display Zoom to Zoomed | boolean | yes | IOS | no |
| isTabletMode | Tells if the device is in tablet mode. | Promise | yes | Windows | no |
| supported32BitAbis | device support 32 Abis | Promise<string[]> | yes | Windows | yes |
| supported64BitAbis | device support 64 Abis | Promise<string[]> | yes | Windows | yes |
| supportedAbis | device support Abis | Promise<string[]> | yes | IOS/Android/Windows/visoinOS | yes |
| syncUniqueId | This method is intended for iOS,This synchronizes uniqueId with IDFV or sets new a random string,On iOS it uses the DeviceUID uid identifier. On other platforms it just call getUniqueId() in this module. | Promise | yes | IOS/visionOS | no |
| getSupportedMediaTypeList | This method gets the list of supported media codecs. | Promise<string[]> | yes | IOS/Android | yes |
- getDeviceId()接口harmony暂不支持issue#8
- getDeviceToken()接口harmony暂不支持issue#9
- getFingerprint()接口harmony暂不支持 issue#10
- getFreeDiskStorage()接口harmony暂不支持 issue#11
- getFreeDiskStorageOld()接口harmony暂不支持 issue#12
- getInstallReferrer()接口harmony暂不支持 issue#13
- getMacAddress()接口harmony暂不支持 issue#14
- getMaxMemory()接口harmony暂不支持 issue#15
- getSerialNumber()接口harmony暂不支持 issue#16
- getTags()接口harmony暂不支持 issue#17
- getTotalDiskCapacity()接口harmony暂不支持 issue#18
- getTotalDiskCapacityOld()接口harmony暂不支持 issue#19
- getTotalMemory()接口harmony暂不支持 issue#20
- getUniqueId()接口harmony暂不支持 issue#21
- syncUniqueId()接口harmony暂不支持 issue#22
- getUserAgent()接口harmony暂不支持 issue#23
- getUserAgentSync()接口harmony暂不支持 issue#24
- hasNotch()接口harmony暂不支持 issue#25
- hasDynamicIsland()接口harmony暂不支持 issue#26
- hasSystemFeature()接口harmony暂不支持 issue#27
- isEmulator()接口harmony暂不支持 issue#28
- isDisplayZoomed()接口harmony暂不支持 issue#29
- getBrightness()接口harmony暂不支持 issue#30
本项目基于 The MIT License (MIT) ，请自由地享受和参与开源。