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
.zipframeworks and.bundleassets - 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.zipRELID_IDV_SELFIE_CAPTURE.zip
- Required assets from Uniken:
regula.licensedb.datCertificates.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.aarAware-FaceCapture-DeviceControl.aar
- Required assets:
regula.licensedb.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
- Obtain the
RELID_IDV_DOCUMENT_CAPTURE.zipfrom the UNIKEN team and extract it. - Copy the
RELID_IDV_DOCUMENT_CAPTUREfolder into theiosdirectory (where your.xcodeprojfile resides). - Open the project’s
Podfile:open -a Xcode Podfile - Add the following line to include the dependency:
pod 'RELIDIDVDocumentCapture', :path => './RELID_IDV_DOCUMENT_CAPTURE/' - 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
- In Xcode, select the project and target.
- Navigate to Build Settings → Other Linker Flags.
- 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
- Obtain the
regula.licensefile from UNIKEN. - Place it in the root directory (where
.xcodeprojresides). - Drag and drop it into the Xcode project navigator.
5. 🧠 REL-ID IDV Framework Database File
- Obtain
db.datfrom UNIKEN. - Place it in the same location as above and add it to the Xcode project navigator.
6. 🔏 REL-ID IDV PKD Certificate File
- Place the
Certificates.bundlefolder in the root of the Xcode project. - 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.licensedb.dat- PKD Certificate (
.ldiffor Android,Certificates.bundlefor iOS)
Updated 6 months ago
