Native iOS
⚙️ Prerequisites for Integration – Native iOS
Before integrating the REL-ID API SDK into your Native iOS application, ensure your development environment meets the following requirements.
🧱 Project Environment
| Component | Requirement |
|---|---|
| Xcode | Version 14.3 or higher |
| iOS Deployment Target | Minimum 12.0 |
| Architectures Supported | arm64, x86_64 (No Bitcode) |
🍏 iOS Requirements
- Xcode Version:
14.3or higher - Deployment Target:
iOS 12.0or above - Architectures Supported:
arm64andx86_64only
(Bitcode is not supported)
📂 SDK Artifacts & Info Required (From REL-ID Admin)
| Item | Description |
|---|---|
Agent_info.txt | Contains the application ID in binary format for SDK initialization |
| REL-ID Gateway Info | Hostname/IP and Port number of the REL-ID Gateway server |
| REL-ID SDK | RELID.xcframework provided by Uniken team for integration |
⚠️ Additional Configuration
- Make sure the Objective-C bridging header is set up correctly if you are using Swift.
- Required system frameworks (automatically linked by REL-ID SDK when used):
CoreTelephonyCoreLocationLocalAuthentication
- Add
-ObjCand-lresolvto your Other Linker Flags under Build Settings.
✅ Summary
- Use the correct
RELID.xcframeworkprovided by Uniken. - Add necessary iOS permissions in your
Info.plistfile. - Ensure compatibility with iOS 12.0+ and supported architectures.
⚙️ REL-ID SDK Installation Guide for Native iOS
This guide outlines the integration of the REL-ID SDK in a native iOS application as per the v25.04.01 integration manual.
📦 1. Prerequisites
- Xcode: 14.3 or higher
- Deployment target: iOS 13.0+
- Architectures supported:
arm64,x86_64 - SDK:
RELID.xcframework - No Bitcode support
🔧 2. Setup Steps
2.1. Obtain SDK
Obtain RELID.xcframework.zip from the Uniken team and unzip it.
2.2. Add Framework to Xcode
- Drag and drop
RELID.xcframeworkinto your Xcode project (preferably into the “Frameworks” group). - Ensure you check:
- ✅ “Copy items if needed”
- ✅ “Create groups”
2.3. Embed & Link the Framework
- In your project settings → target → General tab:
- Under Frameworks, Libraries, and Embedded Content, select
Embed & SignforRELID.xcframework.
- Under Frameworks, Libraries, and Embedded Content, select
- In Build Phases tab:
- Confirm
RELID.xcframeworkis listed under “Link Binary with Libraries”. If not, click ➕ and add it.
- Confirm
🛠 3. Required iOS Frameworks
Ensure the following system frameworks are linked:
CoreTelephony.frameworkLocalAuthentication.framework
These may auto-link once REL-ID APIs are referenced.
🧷 4. Linker Flags Configuration
Go to Build Settings → Linking → Other Linker Flags, and add:
-ObjC
-lresolv
🔁 5. Importing in Code
For Objective-C:
#import <RELID/RDNAStruct.h>
#import <RELID/RDNA.h>🧠 5. Swift Integration
To use REL-ID in a Swift project, configure a bridging header.
a. Create a Bridging Header
Create: YourProjectName-Bridging-Header.h and add:
#import <RELID/RDNAStruct.h>
#import <RELID/RDNA.h>b. Reference It in Build Settings
- Navigate to Build Settings → Swift Compiler – General
- Set
Objective-C Bridging Headerto the path of your header file (e.g.,MyApp/MyApp-Bridging-Header.h)
📋 6. Info.plist Permissions
To enable the full functionality of the REL-ID SDK—including identity verification, biometric authentication, geolocation-based risk analysis, and local network verification—your iOS app must declare specific permissions in the Info.plist file.
📂 7. Agent Info
You will also need to integrate the Agent_info.txt binary configuration provided by Uniken. This file contains your application’s identity and must be embedded in your project.
✅ You are now ready to initialize and use REL-ID in your native iOS project.
Updated 5 days ago
