react-native-device-info

Device Information for React Native.

v2 to v3 upgrade

If you are upgrading from v2 to v3, check the guide out: https://github.com/react-native-community/react-native-device-info/wiki/V2-to-V3-Migration-Guide

v3 to v4 upgrade

For those upgrading to v4, follow the v2 to v3 guide first, then follow this: https://github.com/react-native-community/react-native-device-info/wiki/V3-to-V4-Migration-Guide

Installation

Using npm:

npm install --save react-native-device-info

or using yarn:

yarn add react-native-device-info

⚠️ If you are on React Native > 0.47, you must use version 0.11.0 of this library or higher

AndroidX Support

This module defaults to AndroidX you should configure your library versions similar to this in your android/build.gradle file's "ext" block

Android

```gradle ... ext { // dependency versions We have 3 options for deviceId: //Option 1 (latest): firebaseIidVersion = "19.0.1" // default: "19.0.1" //Option 2 (legacy GooglePlay dependency but using AndroidX): googlePlayServicesIidVersion = "17.0.0" // default: "17.0.0" - AndroidX //Option 3 (legacy GooglePlay dependency before AndroidX): googlePlayServicesIidVersion = "16.0.1" //include as needed: compileSdkVersion = "28" // default: 28 (28 is required for AndroidX) targetSdkVersion = "28" // default: 28 (28 is required for AndroidX) supportLibVersion = '1.0.2' // Use '28.0.0' or don't specify for old libraries, '1.0.2' or similar for AndroidX mediaCompatVersion = '1.0.1' // Do not specify if using old libraries, specify '1.0.1' or similar for androidx.media:media dependency supportV4Version = '1.0.0' // Do not specify if using old libraries, specify '1.0.0' or similar for androidx.legacy:legacy-support-v4 dependency } ... ```

If you need non-AndroidX you will need to use the jetifier package in reverse mode, documentation available with that package.

Linking (for React Native <= 0.59 only, React Native >= 0.60 skip this as auto-linking should work)

Automatic

react-native link react-native-device-info

(or using rnpm for versions of React Native < 0.27)

rnpm link react-native-device-info

For iOS users using Pods You still need to run pod install after running the above link command inside your IOS folder.

Manual

iOS (via CocoaPods) RN <= 59

RN <= 59: [`Bug`](https://github.com/react-native-community/react-native-device-info/issues/748) ``` mv ios/Podfile . react-native link react-native-device-info mv Podfile ios ``` Do _not_ append `pod 'RNDeviceInfo', :path => '../node_modules/react-native-device-info'` to the Podfile

iOS (via CocoaPods) RN >= 60

Add the following lines to your build targets in your `Podfile` ```ruby pod 'React', :path => '../node_modules/react-native' # Explicitly include Yoga if you are using RN >= 0.42.0 pod 'yoga', :path => '../node_modules/react-native/ReactCommon/yoga' pod 'RNDeviceInfo', :path => '../node_modules/react-native-device-info' # React-Native is not great about React double-including from the Podfile post_install do |installer| installer.pods_project.targets.each do |target| if target.name == "React" target.remove_from_project end # It removes React & Yoga from the Pods project, as it is already included in the main project. targets_to_ignore = %w(React yoga) if targets_to_ignore.include? target.name target.remove_from_project end end end ``` Then run `pod install`

iOS (without CocoaPods)

In XCode, in the project navigator: - Right click _Libraries_ - Add Files to _[your project's name]_ - Go to `node_modules/react-native-device-info/ios` - Add the file `RNDeviceInfo.xcodeproj` In XCode, in the project navigator, select your project. - Add the `libRNDeviceInfo.a` from the _deviceinfo_ project to your project's _Build Phases ➜ Link Binary With Libraries_ - Click `.xcodeproj` file you added before in the project navigator and go the _Build Settings_ tab. Make sure _All_ is toggled on (instead of _Basic_). - Look for _Header Search Paths_ and make sure it contains both `$(SRCROOT)/../react-native/React` and `$(SRCROOT)/../../React` - Mark both as recursive (should be OK by default). Run your project (Cmd+R) (Thanks to @brysgo for writing the instructions)

Android

- **_optional_** in `android/build.gradle`: ```gradle ... ext { // dependency versions googlePlayServicesVersion = "" // default: "16.1.0" - pre-AndroidX, override for AndroidX compileSdkVersion = "" // default: 28 targetSdkVersion = "" // default: 28 } ... ``` - in `android/app/build.gradle`: ```diff dependencies { ... implementation "com.facebook.react:react-native:+" // From node_modules + implementation project(':react-native-device-info') } ``` - in `android/settings.gradle`: ```diff ... include ':app' + include ':react-native-device-info' + project(':react-native-device-info').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-device-info/android') ``` #### With React Native 0.29+ - in `MainApplication.java`: ```diff + import com.learnium.RNDeviceInfo.RNDeviceInfo; public class MainApplication extends Application implements ReactApplication { //...... @Override protected List getPackages() { return Arrays.asList( + new RNDeviceInfo(), new MainReactPackage() ); } ...... } ``` #### With older versions of React Native - in `MainActivity.java`: ```diff + import com.learnium.RNDeviceInfo.RNDeviceInfo; public class MainActivity extends ReactActivity { ...... @Override protected List getPackages() { return Arrays.asList( + new RNDeviceInfo(), new MainReactPackage() ); } } ``` NOTE: If you faced with this error: `Could not resolve all files for configuration ':react-native-device-info:debugCompileClasspath'.`, in `build.gradle` put `google()` in the first line (according to https://stackoverflow.com/a/50748249) - in `android/build.gradle`: ```diff allprojects { repositories { + google() ... } } ``` (Thanks to @chirag04 for writing the instructions)

Windows

- Open the solution in Visual Studio for your Windows apps - right click your in the Explorer and click Add > Existing Project... - Navigate to `.//node_modules/react-native-device-info/windows/RNDeviceInfo` and add `RNDeviceInfo.csproj` - this time right click on your React Native Windows app under your solutions directory and click Add > Reference... - check the `RNDeviceInfo` you just added and press ok - open up `MainReactNativeHost.cs` for your app and edit the file like so: ```diff + using RNDeviceInfo; ...... protected override List Packages => new List { new MainReactPackage(), + new RNDeviceInfoPackage(), }; ``` (Thanks to @josephan for writing the instructions)

Usage

import DeviceInfo from 'react-native-device-info';

// or ES6+ destructured imports

import { getUniqueId, getManufacturer } from 'react-native-device-info';

API

Note that many APIs are platform-specific. If there is no implementation for a platform, then the "default" return values you will receive are "unknown" for string, -1 for number, and false for boolean. Arrays and Objects will be empty ([] and {} respectively).

Most APIs return a Promise but also have a corresponding API with Sync on the end that operates synchronously. For example, you may prefer to call isCameraPresentSync() during your app bootstrap to avoid async calls during the first parts of app startup.

Method	Return Type	iOS	Android	Windows	Web
getAndroidId()	`Promise<string>`	❌	✅	❌	❌
getApiLevel()	`Promise<number>`	❌	✅	❌	❌
getApplicationName()	`string`	✅	✅	✅	❌
getAvailableLocationProviders()	`Promise<Object>`	✅	✅	❌	❌
getBaseOs()	`Promise<string>`	❌	✅	❌	✅
getBuildId()	`Promise<string>`	✅	✅	❌	❌
getBatteryLevel()	`Promise<number>`	✅	✅	✅	✅
getBootloader()	`Promise<string>`	❌	✅	❌	❌
getBrand()	`string`	✅	✅	✅	❌
getBuildNumber()	`string`	✅	✅	✅	❌
getBundleId()	`string`	✅	✅	✅	❌
isCameraPresent()	`Promise<boolean>`	❌	✅	✅	✅
getCarrier()	`Promise<string>`	✅	✅	❌	❌
getCodename()	`Promise<string>`	❌	✅	❌	❌
getDevice()	`Promise<string>`	❌	✅	❌	❌
getDeviceId()	`string`	✅	✅	✅	❌
getDeviceType()	`string`	✅	✅	❌	❌
getDisplay()	`Promise<string>`	❌	✅	❌	❌
getDeviceName()	`Promise<string>`	✅	✅	✅	❌
getDeviceToken()	`Promise<string>`	✅	❌	❌	❌
getFirstInstallTime()	`Promise<number>`	❌	✅	✅	❌
getFingerprint()	`Promise<string>`	❌	✅	❌	❌
getFontScale()	`Promise<number>`	✅	✅	❌	❌
getFreeDiskStorage()	`Promise<number>`	✅	✅	❌	✅
getHardware()	`Promise<string>`	❌	✅	❌	❌
getHost()	`Promise<string>`	❌	✅	❌	❌
getIpAddress()	`Promise<string>`	✅	✅	✅	❌
getIncremental()	`Promise<string>`	❌	✅	❌	❌
getInstallerPackageName()	`Promise<string>`	❌	✅	❌	❌
getInstallReferrer()	`Promise<string>`	❌	✅	❌	✅
getInstanceId()	`Promise<string>`	❌	✅	❌	❌
getLastUpdateTime()	`Promise<number>`	❌	✅	❌	❌
getMacAddress()	`Promise<string>`	✅	✅	❌	❌
getManufacturer()	`Promise<string>`	✅	✅	✅	❌
getMaxMemory()	`Promise<number>`	❌	✅	✅	✅
getModel()	`string`	✅	✅	✅	❌
getPhoneNumber()	`Promise<string>`	❌	✅	❌	❌
getPowerState()	`Promise<object>`	✅	✅	❌	✅
getProduct()	`Promise<string>`	❌	✅	❌	❌
getPreviewSdkInt()	`Promise<number>`	❌	✅	❌	❌
getReadableVersion()	`string`	✅	✅	✅	❌
getSerialNumber()	`Promise<string>`	❌	✅	❌	❌
getSecurityPatch()	`Promise<string>`	❌	✅	❌	❌
getSystemAvailableFeatures()	`Promise<string[]>`	❌	✅	❌	❌
getSystemName()	`string`	✅	✅	✅	❌
getSystemVersion()	`string`	✅	✅	✅	❌
getTags()	`Promise<string>`	❌	✅	❌	❌
getType()	`Promise<string>`	❌	✅	❌	❌
getTotalDiskCapacity()	`Promise<number>`	✅	✅	❌	✅
getTotalMemory()	`Promise<number>`	✅	✅	❌	✅
getUniqueId()	`string`	✅	✅	✅	❌
getUsedMemory()	`Promise<number>`	✅	✅	❌	✅
getUserAgent()	`Promise<string>`	✅	✅	❌	✅
getVersion()	`string`	✅	✅	✅	❌
hasNotch()	`boolean`	✅	✅	✅	❌
hasSystemFeature()	`Promise<boolean>`	❌	✅	❌	❌
isAirplaneMode()	`Promise<boolean>`	❌	✅	❌	✅
isBatteryCharging()	`Promise<boolean>`	✅	✅	❌	✅
isEmulator()	`Promise<boolean>`	✅	✅	✅	❌
isLandscape()	`Promise<boolean>`	✅	✅	✅	❌
isLocationEnabled()	`Promise<boolean>`	✅	✅	❌	✅
isHeadphonesConnected()	`Promise<boolean>`	✅	✅	❌	❌
isPinOrFingerprintSet()	`Promise<boolean>`	✅	✅	✅	❌
isTablet()	`boolean`	✅	✅	✅	❌
supported32BitAbis()	`Promise<string[]>`	❌	✅	❌	❌
supported64BitAbis()	`Promise<string[]>`	❌	✅	❌	❌
supportedAbis()	`Promise<string[]>`	✅	✅	❌	❌
syncUniqueId()	`Promise<string>`	✅	❌	❌	❌

getApiLevel()

Gets the API level.

Examples

DeviceInfo.getApiLevel().then(apiLevel => {
  // iOS: ?
  // Android: 25
  // Windows: ?
});

Notes

See API Levels

getAndroidId()

Gets the ANDROID_ID. See API documentation for appropriate use.

Examples

DeviceInfo.getAndroidId().then(androidId => {
  // androidId here
});

getApplicationName()

Gets the application name.

Examples

let appName = DeviceInfo.getApplicationName();
// AwesomeApp

getBaseOs()

The base OS build the product is based on.

Examples

DeviceInfo.getBaseOs().then(baseOs => {
  // "Windows", "Android" etc
});

getBatteryLevel()

Gets the battery level of the device as a float comprised between 0 and 1.

Examples

DeviceInfo.getBatteryLevel().then(batteryLevel => {
  // 0.759999
});

Notes

To be able to get actual battery level enable battery monitoring mode for application. Add this code:

[UIDevice currentDevice].batteryMonitoringEnabled = true;

to AppDelegate.m application:didFinishLaunchingWithOptions:

Returns -1 on the iOS Simulator

getBootloader()

The system bootloader version number.

Examples

DeviceInfo.getBootloader().then(bootloader => {
  // "mw8998-002.0069.00"
});

getBrand()

Gets the device brand.

Examples

let brand = DeviceInfo.getBrand();
// iOS: "Apple"
// Android: "xiaomi"
// Windows: ?

getBuildNumber()

Gets the application build number.

Examples

let buildNumber = DeviceInfo.getBuildNumber();
// iOS: "89"
// Android: "4"
// Windows: ?

getBundleId()

Gets the application bundle identifier.

Examples

let bundleId = DeviceInfo.getBundleId();
// "com.example.AwesomeApp"

isCameraPresent()

Tells if the device have any camera now.

Examples

DeviceInfo.isCameraPresent()
  .then(isCameraPresent => {
    // true or false
  })
  .catch(cameraAccessException => {
    // is thrown if a camera device could not be queried or opened by the CameraManager on Android
  });

Notes

Hot add/remove of camera is supported.

Returns the status of the physical presence of the camera. If camera present but your app don't have permissions to use it, isCameraPresent will still return the true

getCarrier()

Gets the carrier name (network operator).

Examples

DeviceInfo.getCarrier().then(carrier => {
  // "SOFTBANK"
});

getCodename()

The current development codename, or the string "REL" if this is a release build.

Examples

DeviceInfo.getCodename().then(codename => {
  // "REL"
});

getDevice()

The name of the industrial design.

Examples

DeviceInfo.getDevice().then(device => {
  // "walleye"
});

getDeviceId()

Gets the device ID.

Examples

let deviceId = DeviceInfo.getDeviceId();
// iOS: "iPhone7,2"
// Android: "goldfish"
// Windows: ?

getDisplay()

A build ID string meant for displaying to the user.

Examples

DeviceInfo.getDisplay().then(display => {
  // "OPM2.171026.006.G1"
});

getDeviceName()

Gets the device name.

Examples

DeviceInfo.getDeviceName().then(deviceName => {
  // iOS: "Becca's iPhone 6"
  // Android: ?
  // Windows: ?
});

This used to require the android.permission.BLUETOOTH but the new implementation in v3 does not need it. You may remove that from your AndroidManifest.xml if you had it for this API.

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.

Examples

DeviceInfo.getDeviceToken().then(deviceToken => {
  // iOS: "a2Jqsd0kanz..."
});

getFirstInstallTime()

Gets the time at which the app was first installed, in milliseconds.

Examples

DeviceInfo.getFirstInstallTime().then(firstInstallTime => {
  // Android: 1517681764528
});

getFingerprint()

A string that uniquely identifies this build.

Examples

DeviceInfo.getFingerprint().then(fingerprint => {
  // "google/walleye/walleye:8.1.0/OPM2.171026.006.G1/4820017:user/release-keys"
});

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 )

In iOS App Extensions this call always returns 1.0, see #625.

Examples

DeviceInfo.getFontScale().then(fontScale => {
  // 1.2
});

getFreeDiskStorage()

Gets available storage size, in bytes.

Examples

DeviceInfo.getFreeDiskStorage().then(freeDiskStorage => {
  // Android: 17179869184
  // iOS: 17179869184
});

Notes

From [developer.android.com](https://developer.android.com/reference/android/os/Environment.html#getExternalStorageDirectory()):

Return the primary shared/external storage directory.

Note: don't be confused by the word "external" here. This directory can better be thought as media/shared storage. It is a filesystem that can hold a relatively large amount of data and that is shared across all applications (does not enforce permissions). Traditionally this is an SD card, but it may also be implemented as built-in storage in a device that is distinct from the protected internal storage and can be mounted as a filesystem on a computer.

getHardware()

The name of the hardware (from the kernel command line or /proc).

Examples

DeviceInfo.getHardware().then(hardware => {
  // "walleye"
};

getHost()

Hostname

Examples

DeviceInfo.getHost().then(host => {
  // "wprd10.hot.corp.google.com"
});

getIpAddress()

Deprecated Gets the device current IP address. (of wifi only) Switch to @react-native-community/netinfo or react-native-network-info

Examples

DeviceInfo.getIpAddress().then(ip => {
  // "92.168.32.44"
});

Android Permissions

android.permission.ACCESS_WIFI_STATE

Notes

Support for iOS was added in 0.22.0

getIncremental()

The internal value used by the underlying source control to represent this build.

Examples

DeviceInfo.getIncremental().then(incremental => {
  // "4820017"
});

getInstallerPackageName()

The internal value used by the underlying source control to represent this build.

Examples

DeviceInfo.getInstallerPackageName().then(installerPackageName => {
  // Play Store: "com.android.vending"
  // Amazon: "com.amazon.venezia"
  // Samsung App Store: "com.sec.android.app.samsungapps"
  // Developer, iOS: "unknown"
});

getInstallReferrer()

Gets the referrer string upon application installation.

Examples

DeviceInfo.getInstallReferrer().then(installReferrer => {
  // If the app was installed from https://play.google.com/store/apps/details?id=com.myapp&referrer=my_install_referrer
  // the result will be "my_install_referrer"
});

getInstanceId()

Gets the application instance ID.

Examples

DeviceInfo.getInstanceId().then(instanceId => {
  // Android: ?
});

Notes

See https://developers.google.com/instance-id/

getLastUpdateTime()

Gets the time at which the app was last updated, in milliseconds.

Examples

DeviceInfo.getLastUpdateTime().then(lastUpdateTime => {
  // Android: 1517681764992
});

getMacAddress()

Gets the network adapter MAC address.

Examples

DeviceInfo.getMacAddress().then(mac => {
  // "E5:12:D8:E5:69:97"
});

Android Permissions

android.permission.ACCESS_WIFI_STATE

Notes

iOS: This method always return "02:00:00:00:00:00" as retrieving the MAC address is disabled since iOS 7

getManufacturer()

Gets the device manufacturer.

Examples

DeviceInfo.getManufacturer().then(manufacturer => {
  // iOS: "Apple"
  // Android: "Google"
  // Windows: ?
});

getMaxMemory()

Returns the maximum amount of memory that the VM will attempt to use, in bytes.

Examples

DeviceInfo.getMaxMemory().then(maxMemory => {
  // 402653183
});

getModel()

Gets the device model.

iOS warning: The list with device names is maintained by the community and could lag new devices. It is recommended to use getDeviceId() since it's more reliable and always up-to-date with new iOS devices. We do accept pull requests that add new iOS devices to the list with device names.

Examples

let model = DeviceInfo.getModel();
// iOS: ?
// Android: ?
// Windows: ?

getPhoneNumber()

Gets the device phone number.

Examples

DeviceInfo.getPhoneNumber().then(phoneNumber => {
  // Android: null return: no permission, empty string: unprogrammed or empty SIM1, e.g. "+15555215558": normal return value
});

Android Permissions

android.permission.READ_PHONE_STATE

Notes

This can return undefined in certain cases and should not be relied on. SO entry on the subject.

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. Displays a warning on iOS if battery monitoring not enabled, or if attempted on an emulator (where monitoring is not possible)

Examples

DeviceInfo.getPowerState().then(state => {
  // {
  //   batteryLevel: 0.759999,
  //   batteryState: 'unplugged',
  //   lowPowerMode: false,
  // }
});

getProduct()

The name of the overall product.

Examples

DeviceInfo.getProduct().then(product => {
  // "walleye"
});

getPreviewSdkInt()

The developer preview revision of a prerelease SDK.

Examples

DeviceInfo.getPreviewSdkInt().then(previewSdkInt => {
  // 0
});

getReadableVersion()

Gets the application human readable version (same as getVersion() + '.' + getBuildNumber())

Examples

let readableVersion = DeviceInfo.getReadableVersion();
// iOS: 1.0.1.32
// Android: 1.0.1.234
// Windows: ?

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](https://developer.android.com/reference/android/os/Build.html#getSerial()).

Examples

DeviceInfo.getSerialNumber().then(serialNumber => {
  // iOS: unknown
  // Android: ? (maybe a serial number, if your app is privileged)
  // Windows: unknown
});

getSecurityPatch()

The user-visible security patch level.

Examples

DeviceInfo.getSecurityPatch().then(securityPatch => {
  // "2018-07-05"
});

getSystemName()

Gets the device OS name.

Examples

let systemName = DeviceInfo.getSystemName();
// iOS: "iOS" on newer iOS devices "iPhone OS" on older devices, including older iPad's.
// Android: "Android"
// Windows: ?

getSystemVersion()

Gets the device OS version.

Examples

let systemVersion = DeviceInfo.getSystemVersion();
// iOS: "11.0"
// Android: "7.1.1"
// Windows: ?

getBuildId()

Gets build number of the operating system.

Examples

DeviceInfo.getBuildId().then(buildId => {
  // iOS: "12A269"
  // tvOS: not available
  // Android: "13D15"
  // Windows: not available
});

getTags()

Comma-separated tags describing the build.

Examples

DeviceInfo.getTags().then(tags => {
  // "release-keys, unsigned, debug",
});

getType()

The type of build.

Examples

DeviceInfo.getType().then(type => {
  // "user", "eng"
});

getTotalDiskCapacity()

Gets full disk storage size, in bytes.

Examples

DeviceInfo.getTotalDiskCapacity().then(capacity => {
  // Android: 17179869184
  // iOS: 17179869184
});

getTotalMemory()

Gets the device total memory, in bytes.

Examples

DeviceInfo.getTotalMemory().then(totalMemory => {
  // 1995018240
});

getUniqueId()

This is a constant and may be referenced directly

Gets the device unique ID. On Android it is currently identical to getAndroidId() in this module. On iOS it uses the DeviceUID uid identifier. On Windows it uses Windows.Security.ExchangeActiveSyncProvisioning.EasClientDeviceInformation.id.

Examples

let uniqueId = DeviceInfo.getUniqueId();
// iOS: "FCDBD8EF-62FC-4ECB-B2F5-92C9E79AC7F9"
// Android: "dd96dec43fb81c97"
// Windows: ?

Notes

iOS: This is IDFV or a random string if IDFV is unavaliable. Once UID is generated it is stored in iOS Keychain and NSUserDefaults. So it would stay the same even if you delete the app or reset IDFV. You can carefully consider it a persistent, cross-install unique ID. It can be changed only in case someone manually override values in Keychain/NSUserDefaults or if Apple would change Keychain and NSUserDefaults implementations. Beware: The IDFV is calculated using your bundle identifier and thus will be different in app extensions.

android: Prior to Oreo, this id (ANDROID_ID) will always be the same once you set up your phone.

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.

Examples

DeviceInfo.syncUniqueId().then(uniqueId => {
  // iOS: "FCDBD8EF-62FC-4ECB-B2F5-92C9E79AC7F9"
  // Android: "dd96dec43fb81c97"
  // Windows: ?
});

Notes

If user moved or restored data from one iOS device to second iOS device then he will have two different devices with same uniqueId in Keychain/NSUserDefaults. User can call syncUniqueId() on new iOS device. That will update his uniqueId from IDFV or a random string.

getUsedMemory()

Gets the app memory usage, in bytes.

Examples

DeviceInfo.getUsedMemory().then(usedMemory => {
  // 23452345
});

getUserAgent()

Gets the device User Agent.

Examples

DeviceInfo.getUserAgent().then(userAgent => {
  // iOS: "Mozilla/5.0 (iPhone; CPU iPhone OS 9_1 like Mac OS X) AppleWebKit/601.1.46 (KHTML, like Gecko) Version/9.0 Mobile/13B143"
  // tvOS: not available
  // Android: ?
  // Windows: ?
});

getVersion()

Gets the application version.

Examples

let version = DeviceInfo.getVersion();
// iOS: "1.0"
// Android: "1.0"
// Windows: ?

isAirplaneMode()

Tells if the device is in Airplane Mode.

Examples

DeviceInfo.isAirplaneMode().then(airplaneModeOn => {
  // false
});

Notes

This only works if the remote debugger is disabled.

isBatteryCharging()

Tells if the battery is currently charging.

Examples

DeviceInfo.isBatteryCharging().then(isCharging => {
  // true or false
});

isEmulator()

Tells if the application is running in an emulator.

Examples

DeviceInfo.isEmulator().then(isEmulator => {
  // false
});

isPinOrFingerprintSet()

Tells if a PIN number or a fingerprint was set for the device.

Examples

DeviceInfo.isPinOrFingerprintSet().then(isPinOrFingerprintSet => {
  if (!isPinOrFingerprintSet) {
    // ...
  }
});

isTablet()

Tells if the device is a tablet.

Examples

let isTablet = DeviceInfo.isTablet();
// true

isLandscape()

Tells if the device is currently in landscape mode.

Examples

DeviceInfo.isLandscape().then(isLandscape => {
  // true
});

hasNotch()

Tells if the device has a notch.

Examples

let hasNotch = DeviceInfo.hasNotch();
  // true

getDeviceType()

Returns the device's type as a string, which will be one of:

Handset
Tablet
Tv
unknown

Examples

let type = DeviceInfo.getDeviceType();
// 'Handset'

supported32BitAbis()

An ordered list of 32 bit ABIs supported by this device.

Examples

DeviceInfo.supported32BitAbis().then(abis => {
  // ["armeabi-v7a", "armeabi"]
});

supported64BitAbis()

An ordered list of 64 bit ABIs supported by this device.

Examples

DeviceInfo.supported64BitAbis().then(abis => {
  // ["arm64-v8a"]
});

supportedAbis()

Returns a list of supported processor architecture version

Examples

DeviceInfo.supportedAbis().then(abis => {
  // [ "arm64 v8", "Intel x86-64h Haswell", "arm64-v8a", "armeabi-v7a", "armeabi" ]
});

hasSystemFeature(feature)

Tells if the device has a specific system feature.

Examples

DeviceInfo.hasSystemFeature('amazon.hardware.fire_tv').then(hasFeature => {
  // true or false
});

getSystemAvailableFeatures()

Returns a list of available system features on Android.

Examples

DeviceInfo.getSystemAvailableFeatures().then(features => {
  // ["android.software.backup", "android.hardware.screen.landscape", "android.hardware.wifi", ...]
});

isLocationEnabled()

Tells if the device has location services turned off at the device-level (NOT related to app-specific permissions)

Examples

DeviceInfo.isLocationEnabled().then(enabled => {
  // true or false
});

isHeadphonesConnected()

Tells if the device is connected to wired headset or bluetooth headphones

Examples

DeviceInfo.isHeadphonesConnected().then(enabled => {
  // true or false
})

getAvailableLocationProviders()

Returns an object of platform-specfic location providers/servcies, with boolean value whether or not they are currently available.

NOTE: This function requires access to the Location permission on Android

Android Example

DeviceInfo.getAvailableLocationProviders().then(providers => {
  // {
  //   gps: true
  //   network: true
  //   passive: true
  // }
});

iOS Example

DeviceInfo.getAvailableLocationProviders().then(providers => {
  // {
  //   headingAvailable: false
  //   isRangingAvailable: false
  //   locationServicesEnabled: true
  //   significantLocationChangeMonitoringAvailable: true
  // }
});

Hooks & Events

Currently iOS & Android only (web support for battery/charging-related APIs).

useBatteryLevel or RNDeviceInfo_batteryLevelDidChange

Fired when the battery level changes; sent no more frequently than once per minute.

Examples

import { useBatteryLevel } from 'react-native-device-info'

const batteryLevel = useBatteryLevel(); // 0.759999

<Text>{ batteryLevel }</Text>

import { NativeEventEmitter, NativeModules } from 'react-native';
const deviceInfoEmitter = new NativeEventEmitter(NativeModules.RNDeviceInfo);

deviceInfoEmitter.addListener('RNDeviceInfo_batteryLevelDidChange', level => {
  // 0.759999
});

useBatteryLevelIsLow or RNDeviceInfo_batteryLevelIsLow

Fired when the battery drops is considered low

Platform	Percentage
iOS	20
Android	15
Web	20

Examples

import { useBatteryLevelIsLow } from 'react-native-device-info'

const batteryLevelIsLow = useBatteryLevelIsLow(); // 0.19

<Text>{ batteryLevelIsLow }</Text>

import { NativeEventEmitter, NativeModules } from 'react-native';
const deviceInfoEmitter = new NativeEventEmitter(NativeModules.RNDeviceInfo);

deviceInfoEmitter.addListener('RNDeviceInfo_batteryLevelIsLow', level => {
  // 0.19
});

usePowerState or RNDeviceInfo_powerStateDidChange

Fired when the battery state changes, for example when the device enters charging mode or is unplugged.

Examples

import { usePowerState } from 'react-native-device-info'

const powerState = usePowerState(); // 'charging'

<Text>{ powerState }</Text>

import { NativeEventEmitter, NativeModules } from 'react-native'
const deviceInfoEmitter = new NativeEventEmitter(NativeModules.RNDeviceInfo)

deviceInfoEmitter.addListener('RNDeviceInfo_powerStateDidChange', { batteryState } => {
  // 'charging'
});

useFirstInstallTime

Gets the time at which the app was first installed, in milliseconds.

Example

import { usePowerState } from 'react-native-device-info';

const { loading, result } = useFirstInstallTime(); // { loading: true, result: 1517681764528}

<Text>{loading ? 'loading...' : result}</Text>;

useDeviceName

Gets the device name.

Example

import { useDeviceName } from 'react-native-device-info';

const { loading, result } = useDeviceName(); // { loading: true, result: "Becca's iPhone 6"}

<Text>{loading ? 'loading...' : result}</Text>;

useHasSystemFeature

Tells if the device has a specific system feature.

Example

import { useHasSystemFeature } from 'react-native-device-info';

const { loading, result } = useHasSystemFeature('amazon.hardware.fire_tv'); // { loading: true, result: false }

<Text>{loading ? 'loading...' : result}</Text>;

useIsEmulator

Get whether the application is running in an emulator.

Example

import { useIsEmulator } from 'react-native-device-info';

const { loading, result } = useIsEmulator(); // { loading: true, result: false }

<Text>{loading ? 'loading...' : result}</Text>;

=======

Native interoperatibily

If you need to check for device type from the native side, you can use the following:

import com.learnium.resolver.DeviceTypeResolver

...
deviceTypeResolver = new DeviceTypeResolver(context);
...
//Check if the device is a Tablet:
if(deviceTypeResolver.isTablet){
  ...
}else{
  ...
}

Troubleshooting

When installing or using react-native-device-info, you may encounter the following problems:

[android] - Unable to merge dex / Multiple dex files / Problems with `com.google.android.gms`

`react-native-device-info` uses `com.google.android.gms:play-services-gcm` to provide [getInstance()][#getinstance]. This can lead to conflicts when building the Android application. If you're using a different version of `com.google.android.gms:play-services-gcm` in your app, you can define the `googlePlayServicesVersion` gradle variable in your `build.gradle` file to tell `react-native-device-info` what version it should require. See the example project included here for a sample. If you're using a different library that conflicts with `com.google.android.gms:play-services-gcm`, and you are certain you know what you are doing such that you will avoid version conflicts, you can simply ignore this dependency in your gradle file: ```groovy compile(project(':react-native-device-info')) { exclude group: 'com.google.android.gms' } ```

[ios] - ld: library not found for -lRNDeviceInfo-tvOS

Seems to be a bug caused by `react-native link`. You can manually delete `libRNDeviceInfo-tvOS.a` in `Xcode -> [Your iOS build target] -> Build Phrases -> Link Binary with Libraries`.

[ios] - [NetworkInfo] Descriptors query returned error: Error Domain=NSCocoaErrorDomain Code=4099 “The connection to service named com.apple.commcenter.coretelephony.xpc was invalidated.”

This is a system level log that may be turned off by executing: `xcrun simctl spawn booted log config --mode "level:off" --subsystem com.apple.CoreTelephony`. To undo the command, you can execute: `xcrun simctl spawn booted log config --mode "level:info" --subsystem com.apple.CoreTelephony`

[ios] - Multiple versions of React when using CocoaPods "tries to require 'react-native' but there are several files providing this module"

### RN<=59 You may need to adjust your Podfile like this if you use Cocoapods and have undefined symbols or duplicate React definitions ```ruby target 'yourTargetName' do # See http://facebook.github.io/react-native/docs/integration-with-existing-apps.html#configuring-cocoapods-dependencies pod 'React', :path => '../node_modules/react-native', :subspecs => [ 'Core', 'CxxBridge', # Include this for RN >= 0.47 'DevSupport', # Include this to enable In-App Devmenu if RN >= 0.43 'RCTText', 'RCTNetwork', 'RCTWebSocket', # Needed for debugging 'RCTAnimation', # Needed for FlatList and animations running on native UI thread # Add any other subspecs you want to use in your project ] # Explicitly include Yoga if you are using RN >= 0.42.0 pod 'yoga', :path => '../node_modules/react-native/ReactCommon/yoga' # Third party deps podspec link - you may have multiple pods here, just an example pod 'RNDeviceInfo', path: '../node_modules/react-native-device-info' end # if you see errors about React duplicate definitions, this fixes it. The same works for yoga. post_install do |installer| installer.pods_project.targets.each do |target| if target.name == "React" target.remove_from_project end end end ```

[tests] - Cannot run my test suite when using this library

`react-native-device-info` contains native code, and needs to be mocked. Jest Snapshot support may work though. Here's how to do it with jest for example: ```json // in your package.json: "jest": { "setupFiles": [ "./testenv.js" ], ``` ```js // testenv.js: jest.mock('react-native-device-info', () => { return { getModel: jest.fn(), }; }); ```

[warnings] - I get too many warnings (battery state, etc)

Some of the APIs (like getBatteryState) will throw warnings in certain conditions like on tvOS or the iOS emulator. This won't be visible in production but even in development it may be irritating. It is useful to have the warnings because these devices return no state, and that can be surprising, leading to github support issues. The warnings is intended to educate you as a developer. If the warnings are troublesome you may try this in your code to suppress them: ```javascript import { YellowBox } from 'react-native'; YellowBox.ignoreWarnings(['Battery state']); ```

Release Notes

See the CHANGELOG.md.

Contributing

Please see the contributing guide.

react-native-dom

As a courtesy to developers, this library was made compatible in v0.21.6 with react-native-dom and react-native-web by providing an empty polyfill in order to avoid breaking builds.

Only getUserAgent() will return a correct value. All other API methods will return an "empty" value of its documented return type: 0 for numbers, '' for strings, false for booleans.

react-native-device-info

TOC

v2 to v3 upgrade

v3 to v4 upgrade

Installation

AndroidX Support

Linking (for React Native <= 0.59 only, React Native >= 0.60 skip this as auto-linking should work)

Automatic

Manual

Usage

API

getApiLevel()

Examples

Notes

getAndroidId()

Examples

getApplicationName()

Examples

getBaseOs()

Examples

getBatteryLevel()

Examples

Notes

getBootloader()

Examples

getBrand()

Examples

getBuildNumber()

Examples

getBundleId()

Examples

isCameraPresent()

Examples

Notes

getCarrier()

Examples

getCodename()

Examples

getDevice()

Examples

getDeviceId()

Examples

getDisplay()

Examples

getDeviceName()

Examples

getDeviceToken()

Examples

getFirstInstallTime()

Examples

getFingerprint()

Examples

getFontScale()

Examples

getFreeDiskStorage()

Examples

Notes

getHardware()

Examples

getHost()

Examples

getIpAddress()

Examples

Android Permissions

Notes

getIncremental()

Examples

getInstallerPackageName()

Examples

getInstallReferrer()

Examples

getInstanceId()

Examples

Notes

getLastUpdateTime()

Examples

getMacAddress()

Examples

Android Permissions

Notes