From 3470996dcf93285448022cc8ad78b86bf2d09a5c Mon Sep 17 00:00:00 2001 From: Victor Eronmosele Date: Sun, 22 Feb 2026 10:38:10 +0100 Subject: [PATCH 1/3] docs(react-native): update deep link setup for iOS (Objective-C) --- .../sdks/native/react-native-sdk.mdx | 193 +++++------------- 1 file changed, 52 insertions(+), 141 deletions(-) diff --git a/src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx b/src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx index 6268206c3..cce1bcd27 100644 --- a/src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx +++ b/src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx @@ -90,93 +90,20 @@ Fundamentally, both SDK versions have equivalent functionality, so there should -### **Android** - -The SDK requires the `react-native-keychain` and `react-native-inappbrowser-reborn` packages. Sometimes, they may not be automatically linked correctly, resulting in errors when running your app, such as `"Cannot read properties of undefined (reading 'isAvailable')"`. In such cases, you will need to manually link them: - -1. Edit `android/settings.gradle` +### **Required dependencies** - ```java - include ':react-native-keychain' - project(':react-native-keychain').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-keychain/android') - - include ':react-native-inappbrowser-reborn' - project(':react-native-inappbrowser-reborn').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-inappbrowser-reborn/android') - ``` - -2. Edit `android/app/build.gradle` - - ```java - apply plugin: 'com.android.application' - - android { - ... - } +The SDK requires the `react-native-app-auth`, `react-native-keychain` and `react-native-get-random-values` packages to be installed. - dependencies { - ... - - implementation project(':react-native-keychain') - implementation project(':react-native-inappbrowser-reborn') - - ... - } - ``` - -3. Edit `MainApplication.java` - - ```java - import com.oblador.keychain.KeychainPackage; - import com.proyecto26.inappbrowser.RNInAppBrowserPackage; - ... - - public class MainApplication extends Application implements ReactApplication { - private final ReactNativeHost mReactNativeHost = - new ReactNativeHost(this) { - ... - @Override - protected List getPackages() { - ... - List packages = new PackageList(this).getPackages(); - packages.add(new KeychainPackage()); - packages.add(new RNInAppBrowserPackage()); - ... - return packages; - } - ... - }; - - ... - } - ``` + -In React Native version 0.73 or above, the `MainApplication.java` file has been replaced with `MainApplication.kt` +### **iOS** -```kotlin -import com.oblador.keychain.KeychainPackage; -import com.proyecto26.inappbrowser.RNInAppBrowserPackage; -... -class MainApplication : Application(), ReactApplication { - override val reactNativeHost: ReactNativeHost = - object : DefaultReactNativeHost(this) { - override fun getPackages(): List = - PackageList(this).packages.apply { - // Packages that cannot be autolinked yet can be added manually here, for example: - // add(MyReactNativePackage()) - add(KeychainPackage()); - add(RNInAppBrowserPackage()); - } - ... - } - ... -} -``` -### **iOS** +#### Update iOS native dependencies To update iOS native dependencies, you can use **CocoaPods**. We recommend installing **CocoaPods** using [Homebrew](https://brew.sh/). ```shell @@ -185,23 +112,6 @@ brew install cocoapods cd ios && pod install ``` -The SDK requires the `react-native-keychain` and `react-native-inappbrowser-reborn` packages. Sometimes, they may not be automatically linked correctly, resulting in errors when running your app, such as `"Cannot read properties of undefined (reading 'isAvailable')"`. In such cases, you will need to manually link them: - -1. **Option: With CocoaPods (Highly recommended)** - - Please add the following lines to your **Podfile**, and then run `pod update`: - - ```swift - pod 'RNKeychain', :path => '../node_modules/react-native-keychain' - pod 'RNInAppBrowser', :path => '../node_modules/react-native-inappbrowser-reborn' - ``` - -2. **Option: Manually link the packages with Xcode** - - Go to the **Build Phases** tab and choose **Link Binary With Libraries.** - - Select **+** - - Add **Other** > **Add Files** > **node_modules/react-native-keychain/RNKeychain.xcodeproj** (similar with **RNInAppBrowser**) - - Add **libRNKeychain.a** (similar with **RNInAppBrowser**) - - Clean and rebuild. If you encounter any errors during the SDK installation process, you can refer to the General Tips section at the end of this topic. @@ -249,7 +159,7 @@ KINDE_POST_LOGOUT_REDIRECT_URL=myapp://myhost.kinde.com/kinde_callback KINDE_CLIENT_ID=myclient@live ``` -## Configuration deep link +## Configure deep linking ### **Android** @@ -266,51 +176,52 @@ Open `AndroidManifest.xml` and update your scheme by adding a new block in activ ### **iOS** -You need to link `RCTLinking` to your project using the steps below. - -1. If you also want to listen to incoming app links during your app's execution, add the following lines to your `AppDelegate.m`. - - ```swift - // iOS 9.x or newer - #import - - (BOOL)application:(UIApplication *)application - openURL:(NSURL *)url - options:(NSDictionary *)options - { - return [RCTLinkingManager application:application openURL:url options:options]; - } - ``` - -2. If you're targeting iOS 8.x or older, use the following code instead. - - ```swift - // iOS 8.x or older - #import - - (BOOL)application:(UIApplication *)application openURL:(NSURL *)url - sourceApplication:(NSString *)sourceApplication annotation:(id)annotation - { - return [RCTLinkingManager application:application openURL:url - sourceApplication:sourceApplication annotation:annotation]; - } - ``` - -3. Make sure you have a configuration URL scheme in `Info.plist`, so the app can be opened by deep link. - - ```swift - CFBundleURLTypes - - - CFBundleTypeRole - Editor - CFBundleURLName - myapp // you can change it - CFBundleURLSchemes - - myapp // you can change it - - - + + #import "RNAppAuthAuthorizationFlowManager.h" + + - @interface AppDelegate : RCTAppDelegate + + @interface AppDelegate : RCTAppDelegate + + + @property(nonatomic, weak) id authorizationFlowManagerDelegate; + ``` + +2. Update your ``AppDelegate.m`` file to include the following: + + Custom scheme support: + + ```diff lang="objc" title="AppDelegate.m" + + - (BOOL) application: (UIApplication *)application + + openURL: (NSURL *)url + + options: (NSDictionary *) options + + { + + if ([self.authorizationFlowManagerDelegate resumeExternalUserAgentFlowWithURL:url]) { + + return YES; + + } + + return [RCTLinkingManager application:application openURL:url options:options]; + + } + ``` + + Universal link support: + + ```diff lang="objc" title="AppDelegate.m" + + - (BOOL) application: (UIApplication *) application + + continueUserActivity: (nonnull NSUserActivity *)userActivity + + restorationHandler: (nonnull void (^)(NSArray> * _Nullable))restorationHandler + + { + + if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) { + + if (self.authorizationFlowManagerDelegate) { + + BOOL resumableAuth = [self.authorizationFlowManagerDelegate resumeExternalUserAgentFlowWithURL:userActivity.webpageURL]; + + if (resumableAuth) { + + return YES; + + } + + } + + } + + return [RCTLinkingManager application:application continueUserActivity:userActivity restorationHandler:restorationHandler]; + + } + ``` ## Integrate with your app From 5f1821c193af484a9aee6a4d95924c999e358801 Mon Sep 17 00:00:00 2001 From: Victor Eronmosele Date: Sun, 22 Feb 2026 18:53:17 +0100 Subject: [PATCH 2/3] docs(react-native): update deep link setup for iOS (Swift) --- .../sdks/native/react-native-sdk.mdx | 152 ++++++++++++++---- 1 file changed, 118 insertions(+), 34 deletions(-) diff --git a/src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx b/src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx index cce1bcd27..3203f8d20 100644 --- a/src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx +++ b/src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx @@ -176,53 +176,137 @@ Open `AndroidManifest.xml` and update your scheme by adding a new block in activ ### **iOS** -1. Update your ``AppDelegate.h`` file to include the following: - ```diff lang="objc" title="AppDelegate.h" - + #import - + #import "RNAppAuthAuthorizationFlowManager.h" - - - @interface AppDelegate : RCTAppDelegate - + @interface AppDelegate : RCTAppDelegate - - + @property(nonatomic, weak) id authorizationFlowManagerDelegate; +Follow the instructions for the language your `AppDelegate` is written in. + + + + + +1. Create a new file, `AppDelegate+RNAppAuth.h`, in the **same folder as your `AppDelegate.swift`** and add the following code: + + ```objc title="AppDelegate+RNAppAuth.h" + #import "RNAppAuthAuthorizationFlowManager.h" ``` -2. Update your ``AppDelegate.m`` file to include the following: +2. Set the Objective-C Bridging Header path in your Xcode Build Settings to `$(SRCROOT)/$(TARGET_NAME)/AppDelegate+RNAppAuth.h`. - Custom scheme support: +
+ Open for steps + + - Open the project in Xcode. + - Select the project in the navigator, then the app target. + - Open the **Build Settings** tab. + - Search for **bridging**. + - Set **Objective-C Bridging Header** to $(SRCROOT)/$(TARGET_NAME)/AppDelegate+RNAppAuth.h. +
+ +3. Update `AppDelegate.swift` file with the following code: + + + + ```diff lang="swift" title="AppDelegate.swift" + @main + - class AppDelegate: UIResponder, UIApplicationDelegate { + + class AppDelegate: UIResponder, UIApplicationDelegate, RNAppAuthAuthorizationFlowManager { + + + + public weak var authorizationFlowManagerDelegate: RNAppAuthAuthorizationFlowManagerDelegate? + ``` - ```diff lang="objc" title="AppDelegate.m" - + - (BOOL) application: (UIApplication *)application - + openURL: (NSURL *)url - + options: (NSDictionary *) options - + { - + if ([self.authorizationFlowManagerDelegate resumeExternalUserAgentFlowWithURL:url]) { - + return YES; + **Custom scheme support:** + + ```diff lang="swift" title="AppDelegate.swift" + + func application( + + _ app: UIApplication, + + open url: URL, + + options: [UIApplication.OpenURLOptionsKey: Any] = [:] + + ) -> Bool { + + if let authorizationFlowManagerDelegate = self.authorizationFlowManagerDelegate { + + if authorizationFlowManagerDelegate.resumeExternalUserAgentFlow(with: url) { + + return true + + } + } - + return [RCTLinkingManager application:application openURL:url options:options]; + + return RCTLinkingManager.application(app, open: url, options: options) + } ``` - Universal link support: - - ```diff lang="objc" title="AppDelegate.m" - + - (BOOL) application: (UIApplication *) application - + continueUserActivity: (nonnull NSUserActivity *)userActivity - + restorationHandler: (nonnull void (^)(NSArray> * _Nullable))restorationHandler - + { - + if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) { - + if (self.authorizationFlowManagerDelegate) { - + BOOL resumableAuth = [self.authorizationFlowManagerDelegate resumeExternalUserAgentFlowWithURL:userActivity.webpageURL]; - + if (resumableAuth) { - + return YES; - + } - + } + **Universal link support:** + + ```diff lang="swift" title="AppDelegate.swift" + + func application( + + _ application: UIApplication, + + continue userActivity: NSUserActivity, + + restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void + + ) -> Bool { + + if userActivity.activityType == NSUserActivityTypeBrowsingWeb, + + let delegate = authorizationFlowManagerDelegate, + + delegate.resumeExternalUserAgentFlow(with: userActivity.webpageURL) + + { + + return true + } - + return [RCTLinkingManager application:application continueUserActivity:userActivity restorationHandler:restorationHandler]; + + return RCTLinkingManager.application( + + application, + + continue: userActivity, + + restorationHandler: restorationHandler + + ) + } ``` + + + + 1. Update your ``AppDelegate.h`` file to include the following: + + ```diff lang="objc" title="AppDelegate.h" + + #import + + #import "RNAppAuthAuthorizationFlowManager.h" + + - @interface AppDelegate : RCTAppDelegate + + @interface AppDelegate : RCTAppDelegate + + + + @property(nonatomic, weak) id authorizationFlowManagerDelegate; + ``` + + 2. Update your ``AppDelegate.m`` file to include the following: + + **Custom scheme support:** + + ```diff lang="objc" title="AppDelegate.m" + + - (BOOL) application: (UIApplication *)application + + openURL: (NSURL *)url + + options: (NSDictionary *) options + + { + + if ([self.authorizationFlowManagerDelegate resumeExternalUserAgentFlowWithURL:url]) { + + return YES; + + } + + return [RCTLinkingManager application:application openURL:url options:options]; + + } + ``` + + **Universal link support:** + + ```diff lang="objc" title="AppDelegate.m" + + - (BOOL) application: (UIApplication *) application + + continueUserActivity: (nonnull NSUserActivity *)userActivity + + restorationHandler: (nonnull void (^)(NSArray> * _Nullable))restorationHandler + + { + + if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) { + + if (self.authorizationFlowManagerDelegate) { + + BOOL resumableAuth = [self.authorizationFlowManagerDelegate resumeExternalUserAgentFlowWithURL:userActivity.webpageURL]; + + if (resumableAuth) { + + return YES; + + } + + } + + } + + return [RCTLinkingManager application:application continueUserActivity:userActivity restorationHandler:restorationHandler]; + + } + ``` + + + + + + ## Integrate with your app To create a new instance of the KindeSDK object, execute the code below. From 5643ca8f4f86df6950e6ad8195c5222e408a624d Mon Sep 17 00:00:00 2001 From: Victor Eronmosele Date: Sun, 22 Feb 2026 19:33:48 +0100 Subject: [PATCH 3/3] docs(react-native) update deep linking iOS set-up instructions --- .../docs/developer-tools/sdks/native/react-native-sdk.mdx | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx b/src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx index 3203f8d20..36592cf57 100644 --- a/src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx +++ b/src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx @@ -239,8 +239,9 @@ Follow the instructions for the language your `AppDelegate` is written in. + restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void + ) -> Bool { + if userActivity.activityType == NSUserActivityTypeBrowsingWeb, + + let url = userActivity.webpageURL, + let delegate = authorizationFlowManagerDelegate, - + delegate.resumeExternalUserAgentFlow(with: userActivity.webpageURL) + + delegate.resumeExternalUserAgentFlow(with: url) + { + return true + }