Get iOS's UUID (identifierForVendor) for React Native Application
Clone or download
lazywei Merge pull request #13 from gargsms/fix-redeclaration
Fix redefinition of RCTMethodInfo error. Update README to link project
Latest commit 79e0e3f Feb 8, 2018

README.md

react-native-device-uuid

What?

Allow developer to retrieve iOS's identifierForVendor as UUID for React Native Application.

Why?

Sometimes we need an unique identifier (e.g., when implementing special authentication flow) to identify an "user-device" pair. However, device token, which is mainly used for push notification, is not suitable in such use case. The reason is that device token can and will change. For details, please refers to Is the device token as unique as the device ID?.

Note: The UUID will change if the app is reinstalled

"The value in this property remains the same while the app (or another app from the same vendor) is installed on the iOS device. The value changes when the user deletes all of that vendor’s apps from the device and subsequently reinstalls one or more of them. The value can also change when installing test builds using Xcode or when installing an app on a device using ad-hoc distribution. Therefore, if your app stores the value of this property anywhere, you should gracefully handle situations where the identifier changes." - source: identifierForVendor

How?

Install

npm install --save react-native-device-uuid
react-native link

Usage

var DeviceUUID = require("react-native-device-uuid");
DeviceUUID.getUUID().then((uuid) => {
  console.log(uuid);
});

Troubleshooting

DeviceUUID just hangs and does not log the uuid to the console (#2), thanks to @irfaan

  1. In XCode, in the project navigator, right click Libraries
  2. Add Files to [your project's name]
  3. Go to node_modules
  4. react-native-device-uuid and add the .xcodeproj file
  5. In XCode, in the project navigator, select your project
  6. Add the lib*.a from the react-native-device-uuid project to your project's Build Phases - Link Binary With Libraries. Select the .a file.
  7. Go to the Build Settings tab.
  8. Make sure 'All' is toggled on (instead of 'Basic').
  9. Look for Header Search Paths and make sure it contains both $(SRCROOT)/../react-native/React and $(SRCROOT)/../../React - mark both as recursive.