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
- Obtain the
RELID_IDV_DOCUMENT_CAPTURE.zip
from the UNIKEN team and extract it. - Copy the
RELID_IDV_DOCUMENT_CAPTURE
folder into theios
directory (where your.xcodeproj
file 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.license
file from UNIKEN. - Place it in the root directory (where
.xcodeproj
resides). - Drag and drop it into the Xcode project navigator.
5. 🧠 REL-ID IDV Framework Database File
- Obtain
db.dat
from 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.bundle
folder 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.license
db.dat
- PKD Certificate (
.ldif
for Android,Certificates.bundle
for iOS)
Updated 3 months ago