iOS: SDK Import

Scenario

Integrate RGCxrClient (and dependencies such as RGCoreKit) into your iOS project via CocoaPods, configure Info.plist and URL Scheme, so that your app can use CxrClient.shared for auth callbacks and subsequent capability calls.

Prerequisites

• Xcode and Swift versions satisfy the Pod requirements (commonly iOS 13+, Xcode 16+ level; follow the Pod release).
• You have created or opened the target .xcodeproj and installed the CocoaPods toolchain.

Podfile example

source ‘https://cdn.cocoapods.org/’
platform :ios, ‘13.0’

target ‘YourApp’ do
  use_frameworks!
  pod ‘RGCxrClient’
  pod ‘RGCoreKit’
end

After running pod install, open the project using the .xcworkspace.

Info.plist

1. URL Types: configure a custom scheme for auth callbacks (historical docs often use cxrl; it must match the auth configuration).
2. LSApplicationQueriesSchemes: add rokidai for checking/launching Rokid AI App.
3. Bluetooth: include bluetooth-central in UIBackgroundModes, and add NSBluetoothAlwaysUsageDescription and related usage descriptions.

URL callback forwarding

In AppDelegate or SceneDelegate’s openURL / scene(_:openURLContexts:), forward:

if CxrClient.shared.handleOpenURL(url) {
    return true
}

About ios_cxr_l_sample

If your local ios_cxr_l_sample directory does not yet contain source code, run git clone / git pull first. After integration, treat the repo’s Podfile and Info.plist as the final sources of truth.