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) |
📂 Required Artifacts & Info 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 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):
CoreTelephony
CoreLocation
LocalAuthentication
- Add
-ObjC
and-lresolv
to your Other Linker Flags under Build Settings.
✅ Summary
- Use the correct
RELID.xcframework
provided by Uniken. - Add necessary iOS permissions in your
Info.plist
file. - 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.
📦 Prerequisites
- Xcode: 14.3 or higher
- Deployment target: iOS 13.0+
- Architectures supported:
arm64
,x86_64
- SDK:
RELID.xcframework
- No Bitcode support
🔧 Setup Steps
1. Obtain SDK
Obtain RELID.xcframework.zip
from the Uniken team and unzip it.
2. Add Framework to Xcode
- Drag and drop
RELID.xcframework
into your Xcode project (preferably into the “Frameworks” group). - Ensure you check:
- ✅ “Copy items if needed”
- ✅ “Create groups”
3. Embed & Link the Framework
- In your project settings → target → General tab:
- Under Frameworks, Libraries, and Embedded Content, select
Embed & Sign
forRELID.xcframework
.
- Under Frameworks, Libraries, and Embedded Content, select
- In Build Phases tab:
- Confirm
RELID.xcframework
is listed under “Link Binary with Libraries”. If not, click ➕ and add it.
- Confirm
🛠 Required iOS Frameworks
Ensure the following system frameworks are linked:
CoreTelephony.framework
LocalAuthentication.framework
These may auto-link once REL-ID APIs are referenced.
🧷 Linker Flags Configuration
Go to Build Settings → Linking → Other Linker Flags, and add:
-ObjC
-lresolv
🔁 Importing in Code
For Objective-C:
#import <RELID/RDNAStruct.h>
#import <RELID/RDNA.h>
🧠 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 Header
to the path of your header file (e.g.,MyApp/MyApp-Bridging-Header.h
)
📋 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.
📂 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 2 months ago