React Native Installation

IDWise React Native SDK is hosted on npm. You can use the dependency manager of your choice to add the package to your project. Please make sure to add the following config to your project.

Requirements

• Minimum version for React Native: TBA
• Android:
  • minSdkVersion is 21 and targetSdkVersion is set to 34
  • Minimum Android Studio Version Android Studio Meerkat | 2024.3.2
• iOS
  • Minimum deployment target: iOS 15.6 or higher.

Latest Stable Version

Please see the Release Notes for more details

Android Setup

1. Add the following to your app-level build.gradle file located at projectRoot/android/app/build.gradle

android {
  ...
  defaultConfig {
    ...
    multiDexEnabled true
  }
  buildFeatures {
    ...
    dataBinding true
  }
}

2. IDWise Android SDK is hosted on Private Maven Repository You have to add the following URL in your repositories section:
   build.gradle

   repositories {
     ...
     maven { url 'https://mobile-sdk.idwise.ai/releases/' }
     maven { url 'https://jitpack.io' }
   }

📘

support Right-to-Left (Android)

Add the following android:supportsRtl="true" attribute in the application tag in your project’s AndroidManifest.xml file located at /app/src/main/AndroidManifest.xml for the right-to-left language such as Arabic, Urdu and etc.

iOS Setup

1. Ensure you have the following two lines at the top of your Podfile:

   Ruby

   source 'https://cdn.cocoapods.org/'
   source 'https://github.com/idwise/ios-sdk'
   
   # if you are using NFC SDK you can use these lines instead 
   source 'https://cdn.cocoapods.org/'
   source 'https://github.com/idwise/ios-sdk-nfc'

Setup for NFC SDK

If you are using NFC SDK then you need to do some extra configurations for NFC to be enabled correctly in your application. Following are the steps to do these configurations:

• Add Near Field Communication Tag Reading under the Capabilities tab for the project’s target:

  

• Add the NFCReaderUsageDescription permission to your Info.plist file - it's needed to access the NFC hardware:

  Swift

  <key>NFCReaderUsageDescription</key>
  <string>NFC tag to read NDEF messages</string>

• Declare com.apple.developer.nfc.readersession.iso7816.select-identifiers a list of application identifiers that the app must be able to read according to ISO7816:

  Swift

  <key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
  <array>
    <string>A0000002471001</string>
    <string>E80704007F00070302</string>
    <string>A000000167455349474E</string>
    <string>A0000002480100</string>
    <string>A0000002480200</string>
    <string>A0000002480300</string>
    <string>A00000045645444C2D3031</string>
  </array>

Setup

Add the React-Native SDK Plugin to your React Native project by running the following command in the root project

npm install idwise-react-native-sdk

yarn add idwise-react-native-sdk

NFC SDK Setup

Add the React-Native SDK Plugin for NFC to your React Native project by running the following command in the root project

npm install idwise-nfc-react-native-sdk

yarn add idwise-nfc-react-native-sdk

Next Steps

• To start with the IDWise Standard SDK, click here.