--- agentTools: projectIndex: https://docs.nvecta.com/llms.txt --- # iOS Integration ## Cocoapods Install Once you have completed the **Plugin Installation** step, to complete the linking, it's necessary to install pods (via Cocoapods) while integrating for iOS. To do so via the terminal, run the following command at your React-Native Project root folder: ```ruby npx pod-install ios ``` ## Configure info.plist To configure your info.plist, go to iOS folder inside your React-Native Project Folder and open your iOS project into Xcode by double click on **.xcworkspace** file and once your React-Native iOS project is open in Xcode, go to **info.plist**, open **info.plist** file as source code (right-click on info.plist and click on **Open as >> Source code**) and add the following code in it. ```xml info.plist CFBundleURLTypes CFBundleURLName $(PRODUCT_BUNDLE_IDENTIFIER) CFBundleURLSchemes ”yourURLscheme comes here” nvBrandID Your BRANDID comes here nvSecretKey Your SECRET KEY comes here nvPushCategory nvpush nvViewAutoRedirection ``` **OR** You can simply open the '**info.plist**' file as '**Property List**' and add the keys which work the same as above. 1. Add a new row again and set up a **URL Types** item by means of adding a new item. Expand the URL Types key, then expand **Item 0**, and add a new item, **URL Identifier** . Fill in '**appScheme**' for Item 0 of URL schemes and your company identifier for the URL Identifier. Once done, your file should resemble the image provided below. [block:image] { "images": [ { "image": [ "https://files.readme.io/74a5691-1_Upload.png", "url-types.jpg", "" ], "align": "center" } ] } [/block] 2. Add a new row again and set up a `nvBrandID` as `Number` and fill this field with your `BRANDID` [block:image] { "images": [ { "image": [ "https://files.readme.io/bd50173-BrandID.png", "nvbrandid.jpg", "" ], "align": "center" } ] } [/block] 3. Add a new row again and set up a `nvSecretKey` as String and fill this field with your `SECRET KEY` [block:image] { "images": [ { "image": [ "https://files.readme.io/c91a763-SecretKey.png", "nvsecretkey.jpg", "" ], "align": "center" } ] } [/block] 4. Add a new row again and set up a `nvPushCategory` as `String` and set it’s value `nvpush`. [block:image] { "images": [ { "image": [ "https://files.readme.io/5233982-nvPushCategory.png", "push-category.jpg", "" ], "align": "center" } ] } [/block] 5. Add a new row again and set up a key `nvViewAutoRedirection` as `Boolean`. Set it `YES` to enable auto redirection of your app’s `ViewControllers` from SDK or set it `NO` to handle redirections by your app. [block:image] { "images": [ { "image": [ "https://files.readme.io/9bc767f-ViewAutoRedirect.png", "", "" ], "align": "center" } ] } [/block] > 📘 Important Note > > In the example provided above, dummy **Brand ID** and **Secret Key** has been mentioned. Kindly login to your account to see your credentials. ## Import Header File **Objective-C**: Import the plugin's **RNNotifyvisitors** header file in your **AppDelegate** file to use the SDK functions which are needs to be accessed as described further steps in this documentation. ```objectivec #import "RNNotifyvisitors.h" ``` **Swift**: If your project iOS platform is in **Swift** language then you have to create a **Bridging-Header.h** file.\ In this file you can import **RNNotifyvisitors** header file to use it in your project's swift files. To do so add a new header file and name it as per the following format. **YOUR\_REACT-NATIVE\_IOS\_PROJECT\_NAME-Bridging-Header.h** For example, if your project name is **AwesomeProject**. Then the header file name will be **AwesomeProject-Bridging-Header.h**. Now add the following import statement in **YOUR\_REACT-NATIVE\_IOS\_PROJECT\_NAME-Bridging-Header.h** for accessing SDK Classes. > 📘 Note > > Make sure that the path of bridge-header.h file is included in build settings under “Swift compiler-code generation” as: **Objective C bridging header**: `YOUR_REACT-NATIVE_IOS_PROJECT_NAME/YOUR_REACT-NATIVE_IOS_PROJECT_NAME-Bridging-Header.h` ```objectivec AwesomeProject-Bridging-Header.h #import "RNNotifyvisitors.h" ``` ## Initialise SDK * Initialize the SDK in the application **`didFinishLaunchingWithOptions`** function. ```objectivec [RNNotifyvisitors Initialize]; /* Example */ - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { ... // NotifyVisitors methods here [RNNotifyvisitors Initialize]; // ---------------------------- return [super application:application didFinishLaunchingWithOptions:launchOptions]; } ``` ```swift RNNotifyvisitors.Initialize() /* Example */ override func application( _ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? ) -> Bool { ... // NotifyVisitors methods here RNNotifyvisitors.Initialize() // ---------------------------- return super.application(application, didFinishLaunchingWithOptions: launchOptions) } ``` * Add the following method in **applicationDidEnterBackground** in your **AppDelegate** file. ```objectivec [RNNotifyvisitors applicationDidEnterBackground: application]; /* Example */ - (void)applicationDidEnterBackground:(UIApplication *)application { [RNNotifyvisitors applicationDidEnterBackground: application]; } ``` ```swift RNNotifyvisitors.applicationDidEnterBackground(application) /* Example */ override func applicationDidEnterBackground(_ application: UIApplication) { RNNotifyvisitors.applicationDidEnterBackground(application) } ``` * Add the following method in **applicationWillEnterForeground** in your **AppDelegate** file. ```objectivec [RNNotifyvisitors applicationWillEnterForeground: application]; /* Example */ - (void)applicationWillEnterForeground:(UIApplication *)application { [RNNotifyvisitors applicationWillEnterForeground: application]; } ``` ```swift RNNotifyvisitors.applicationWillEnterForeground(application) /* Example */ override func applicationWillEnterForeground(_ application: UIApplication) { RNNotifyvisitors.applicationWillEnterForeground(application) } ``` * Add the following method in **applicationDidBecomeActive** in your **AppDelegate** file. ```objectivec [RNNotifyvisitors applicationDidBecomeActive: application]; /* Example */ - (void)applicationDidBecomeActive:(UIApplication *)application { [RNNotifyvisitors applicationDidBecomeActive: application]; } ``` ```swift RNNotifyvisitors.applicationDidBecomeActive(application) /* Example */ override func applicationDidBecomeActive(_ application: UIApplication) { RNNotifyvisitors.applicationDidBecomeActive(application) } ``` * Add the following method in **applicationWillTerminate** in your **AppDelegate** file. ```objectivec [RNNotifyvisitors applicationWillTerminate]; /* Example */ - (void) applicationWillTerminate:(UIApplication *)application{ [RNNotifyvisitors applicationWillTerminate]; } ``` ```swift RNNotifyvisitors.applicationWillTerminate() /* Example */ override func applicationWillTerminate(_ application: UIApplication) { RNNotifyvisitors.applicationWillTerminate() } ``` * **Deep Linking:** Use the following method in your **AppDelegate openURL** method that will check the deep linking and open your app from the URL Scheme. ```objectivec [RNNotifyvisitors openUrlWithApplication:app url: url]; -(BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary *)options { [RNNotifyvisitors openUrlWithApplication:app url: url]; return YES; } ``` ```swift RNNotifyvisitors.openUrl(with: app, url: url) /* Example */ override func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool { RNNotifyvisitors.openUrl(with: app, url: url) return true } ``` ## Push Notifications NotifyVisitors' React-Native plugin enables you to send push notifications to your mobile apps from our dashboard. Kindly refer to our **[Push Notifications](https://docs.notifyvisitors.com/docs/push-notifications-flutter-ios-copy-1)** integration guide available on the next page.