Native iOS

🍏 Native iOS Setup

🛠 Prerequisites

Before integrating the SDK, make sure your development environment is set up.

  • Xcode 13+, CocoaPods required
  • Platform: platform :ios, '13.0'
  • Uses .zip frameworks and .bundle assets
  • A physical iOS device is required for testing, as this REL-ID IDV Framework iscompatible for arm64 devices only

SDK Files

  • REL-ID Frameworks:
    • RELID_IDV_DOCUMENT_CAPTURE.zip
    • RELID_IDV_SELFIE_CAPTURE.zip
  • Required assets from Uniken:
    • regula.license
    • db.dat
    • Certificates.bundle

Configuration

  • Xcode 13+
  • Platform: platform :ios, '13.0'
  • CocoaPods required
  • Physical arm64 iOS device
  • Optional localization: IDVDocumentCapture.strings, IDVSelfieCapture.strings

🤖 Native Android Setup

SDK Files

  • AAR Libraries:
    • Aware-FaceCapture.aar
    • Aware-FaceCapture-DeviceControl.aar
  • Required assets:
    • regula.license
    • db.dat
    • PKD Certificate (*.ldif)

Configuration

  • Android Studio (latest)
  • SDK 23+ with Jetpack
  • Physical Android device required

Additional Configurations for Native iOS

This section outlines the steps to properly configure the REL-ID IDV SDK for Native iOS applications.


1. 📦 Add and Embed REL-ID Frameworks in Xcode

a. Document Capture Framework

  1. Obtain the RELID_IDV_DOCUMENT_CAPTURE.zip from the UNIKEN team and extract it.
  2. Copy the RELID_IDV_DOCUMENT_CAPTURE folder into the ios directory (where your .xcodeproj file resides).
  3. Open the project’s Podfile:
    open -a Xcode Podfile
  4. Add the following line to include the dependency:
    pod 'RELIDIDVDocumentCapture', :path => './RELID_IDV_DOCUMENT_CAPTURE/'
  5. Run pod install:
    pod install

b. Selfie Capture Framework

Repeat the above steps with the RELID_IDV_SELFIE_CAPTURE.zip:For Step 4, to add RELID_IDV_SELFIE_CAPTURE dependencies, in the podfile, type

pod 'RELIDIDVSelfieCapture', :path => './RELID_IDV_SELFIE_CAPTURE/'

2. ⚙️ Linker Flags

  1. In Xcode, select the project and target.
  2. Navigate to Build SettingsOther Linker Flags.
  3. Set the value to:
    $(inherited)

3. 🔐 Permissions

Add the following entries to your Info.plist:

<key>NSCameraUsageDescription</key>
<string>Required for document and facial capture</string>

<key>NFCReaderUsageDescription</key>
<string>NFC tag to read NFC document data</string>

<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>

The REL-ID IDV Document Capture Framework makes use of RFID to read the document which has a RFID chip. You need to add capabilities to the project target and also the provisioning profile used for the target bundle.Follow below steps to enable NFC capabilities for the target.


<br />

* Open the project in Xcode.
* Select the app target.
* Go to **Signing & Capabilities**.
* Click **+ Capability** and add **Near Field Communication Tag Reading**.***


4. 🗂️ REL-ID IDV Framework License

  1. Obtain the regula.license file from UNIKEN.
  2. Place it in the root directory (where .xcodeproj resides).
  3. Drag and drop it into the Xcode project navigator.

5. 🧠 REL-ID IDV Framework Database File

  1. Obtain db.dat from UNIKEN.
  2. Place it in the same location as above and add it to the Xcode project navigator.

6. 🔏 REL-ID IDV PKD Certificate File

  1. Place the Certificates.bundle folder in the root of the Xcode project.
  2. Add it to the Xcode project navigator.

📦 Build and Run Project

This section provides instructions to build and run your project integrated with the REL-ID IDV SDK.


✅ Prerequisites

Ensure:

  • All REL-ID IDV SDK modules are installed correctly.
  • There are no compile-time errors in your code.

🧑‍💻 Native IDEs

  • Use Android Studio to build and run Android apps.
  • Use Xcode to build and run iOS apps.

💡 Before running the app in Xcode, navigate to the iOS project directory and execute:

pod install

⚠️ Important Notes

  • The REL-ID IDV SDK supports physical devices only for testing. Simulators/emulators are not supported.
  • Make sure the following files are correctly placed and bundled:
    • regula.license
    • db.dat
    • PKD Certificate (.ldif for Android, Certificates.bundle for iOS)