@selligent-marketing-cloud/selligent-react-native 3.3.0 → 3.3.1

package/README.md

@@ -4,15 +4,16 @@ This module provides an API for the usage of the Selligent Mobile SDKs in React
 
 ## SelligentMobileSDK-ReactNative Integration
 
-This module uses the native Selligent SDKs:
+This module supports the following SDK and tools:
 
-| SDK                                                                     | Version |
-| ----------------------------------------------------------------------- | ------- |
-| [Android](https://github.com/SelligentMarketingCloud/MobileSDK-Android) | 4.3.0   |
-| [iOS](https://github.com/SelligentMarketingCloud/MobileSDK-iOS)         | 3.6.0   |
+> **IMPORTANT** This module doesn't currently support REACT NATIVE'S NEW ARCHITECTURE! The following library contains React native modules, that are tailored to and can only be used in React Native's legacy architecture, that will be deprecated in the future when the new architecture will be stable.
 
-> **IMPORTANT:** Since version 2.6.0 of this module we require your app to use the Android Gradle Plugin version 4.2.0 or higher in order to build on Android. This is the default Android Gradle Plugin version since React Native version 0.64.0 but can be manually increased in older versions of React Native.
-> **IMPORTANT** Since version 2.10.0 of this module, we support React Native v0.70, but NOT REACT NATIVE'S NEW ARCHITECTURE! The following library contains React native modules, that are tailored to and can only be used in React Native's legacy architecture, that will be deprecated in the future when the new architecture will be stable.
+| SDK                                                                            | Version |
+| ------------------------------------------------------------------------------ | ------- |
+| [Android SDK](https://github.com/SelligentMarketingCloud/MobileSDK-Android)    | 4.3.0   |
+| [iOS SDK](https://github.com/SelligentMarketingCloud/MobileSDK-iOS)            | 3.6.1   |
+| ReactNative                                                                    | 0.71.8  |
+| Expo SDK                                                                       | 48      |
 
 ## Installation
 
@@ -40,6 +41,8 @@ This module uses the native Selligent SDKs:
 
 ### Android Specific Installation
 
+> **IMPORTANT:** Since version 2.6.0 of this module we require your app to use the Android Gradle Plugin version 4.2.0 or higher in order to build on Android. This is the default Android Gradle Plugin version since React Native version 0.64.0 but can be manually increased in older versions of React Native.
+
 > ### **Attention for Huawei developers!**
 >
 > In order to use this module on Huawei devices (without Goggle Play services), you should add the following dependencies in the `build.gradle` files of the Android project in your React Native project:
@@ -210,7 +213,7 @@ This module uses the native Selligent SDKs:
 
     > Do not check the "copy if needed" option to make sure you only have to manage one selligent.json file
 
-3. Add the native iOS SDK dependency in your Podfile: `s.dependency "SelligentMobileSDK/Framework", "3.6.0"` or download it manually from [here](https://github.com/SelligentMarketingCloud/MobileSDK-iOS/tree/master/Framework) and drag and drop it into you **Xcode project**.
+3. Add the native iOS SDK dependency in your Podfile: `s.dependency "SelligentMobileSDK/Framework", "3.6.1"` or download it manually from [here](https://github.com/SelligentMarketingCloud/MobileSDK-iOS/tree/master/Framework) and drag and drop it into you **Xcode project**.
 
 4. Execute `pod install` in the `/ios` folder
 

package/documentation/README.md

@@ -25,6 +25,7 @@ Selligent welcomes any recommendations or suggestions regarding the manual, as i
   - [Push notifications](#push-notifications)
     - [Rich Push Notifications](#rich-push-notifications)
     - [Deep Linking](#deep-linking)
+      - [Background Modes](#background-modes)
       - [Universal Linking - iOS](#universal-linking---ios)
     - [Notification helper methods](#notification-helper-methods)
       - [Disable Selligent Push Notifications](#disable-selligent-push-notifications)
@@ -238,8 +239,8 @@ This is because the JS layer is loaded **after** the native iOS SDK executes the
 
     ```javascript
     // In DeeplinkHook.js
-    import { useEffect } from "react";
-    import { Alert, Linking } from "react-native";
+    import { useEffect } from "react"
+    import { Alert, Linking } from "react-native"
 
     const useHandleDeepLink = () => {
       useEffect(() => {
@@ -248,22 +249,22 @@ This is because the JS layer is loaded **after** the native iOS SDK executes the
                   Alert.alert('Deep Link', link || 'No link')
               }
           }).catch(err => {
-              console.warn('An error occurred', err);
-          });
+              console.warn('An error occurred', err)
+          })
 
-          const urlListener = Linking.addEventListener('url', ({url}) => Alert.alert('Deep Link', url || 'No link'));
+          const urlListener = Linking.addEventListener('url', ({url}) => Alert.alert('Deep Link', url || 'No link'))
 
-          return () => urlListener.remove();
+          return () => urlListener.remove()
       }, [])
-    };
+    }
 
-    export default useHandleDeepLink;
+    export default useHandleDeepLink
     ```
 
 3. Add a call to `Selligent.executePushAction()` in your main `App.js` file, after adding the ReactNative linking handler (and after calling `Selligent.subscribeToEvents`, if being used)
 
     ```javascript
-    import Selligent from "@selligent-marketing-cloud/selligent-react-native"; // Add Selligent import
+    import Selligent from "@selligent-marketing-cloud/selligent-react-native" // Add Selligent import
 
     const App = () => {
     // Deeplinking handling library (i.e Linking.getInitialURL() & Linking.addEventListener...)
@@ -278,6 +279,38 @@ This is because the JS layer is loaded **after** the native iOS SDK executes the
     }
     ```
 
+#### Background Modes
+
+**For iOS**, (if your app supports Background Modes) it is possible that after the app is launched from the background (location update, background push notification...) if the next action the user performs is executing a deeplink (via safari, push notification click...) the deeplink won't do anything. This is because the communication between the native part and the RN layer is not ready yet when the deeplink is executed from the native side. To workaround this, you can catch when the app is launched from the background and add a bit of delay before the `RCTLinkingManager openUrl` gets executed.
+
+```objective-c
+static BOOL launchedFromBackground = false;
+
+- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
+  if ([[UIApplication sharedApplication] applicationState] == UIApplicationStateBackground) {
+    launchedFromBackground = true;
+  }
+  
+  // Other setup code
+  
+  return [super application:application didFinishLaunchingWithOptions:launchOptions];
+}
+
+- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
+  if (launchedFromBackground) {
+    launchedFromBackground = false;
+    
+    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, 0.5 * NSEC_PER_SEC), dispatch_get_main_queue(), ^{
+      [RCTLinkingManager application:application openURL:url options:options];
+    });
+    
+    return [super application:application openURL:url options:options];
+  }
+  
+  return [super application:application openURL:url options:options] || [RCTLinkingManager application:application openURL:url options:options];
+}
+```
+
 #### Universal Linking - iOS
 
 By default, universal links in a button from a Push/IAM will open the default browser, to avoid this and catch them on the App and apply any logic you want, you will need to add a property `interceptSelligentUniversalLinks` in the `selligent.json` with `true` as value.
@@ -755,7 +788,7 @@ The `data` property is an object itself containing more information specific to
 Add the following import to work with the constants:
 
 ```javascript
-import SelligentConstants from "@selligent-marketing-cloud/selligent-react-native/constants";
+import SelligentConstants from "@selligent-marketing-cloud/selligent-react-native/constants"
 ```
 
 ### ClearCacheIntervalValue

package/package.json

@@ -4,7 +4,7 @@
   },
   "name": "@selligent-marketing-cloud/selligent-react-native",
   "title": "Selligent React Native",
-  "version": "3.3.0",
+  "version": "3.3.1",
   "description": "React Native wrapper for the Selligent Marketing Cloud Android and iOS SDKs",
   "main": "index.js",
   "repository": {