Merge pull request #456 from adobe/staging

simplification release along with BOM

Author: namArora3112

README.md

@@ -30,7 +30,7 @@ This repository is a monorepo and contains a collection of React Native modules
 > [!IMPORTANT]  
 > The Adobe React Native SDK utilizes the React Native interop layer to ensure compatibility with new architecture.
 
-## Requirements
+## Requirements 
 
 - React Native
 
@@ -43,7 +43,7 @@ To submit iOS apps to the App Store, you must build them using Xcode 15 or later
 ## iOS Privacy Manifest
 
 > [!IMPORTANT]  
-> Adobe Experience Platform React Native **6.x** libraries now depend on Experience Platform iOS 5.x SDKs, which have been updated to align with Apple's latest guidelines on [privacy manifest](https://developer.apple.com/documentation/bundleresources/privacy_manifest_files). For further details on how Apple's privacy-related announcements affect the Adobe mobile SDK for iOS, please refer to this [document](https://developer.adobe.com/client-sdks/resources/privacy-manifest/).
+> Starting from Adobe Experience Platform React Native **6.x**, the libraries depend on Experience Platform iOS 5.x SDKs, which have been updated to align with Apple's latest guidelines on [privacy manifest](https://developer.apple.com/documentation/bundleresources/privacy_manifest_files). For further details on how Apple's privacy-related announcements affect the Adobe mobile SDK for iOS, please refer to this [document](https://developer.adobe.com/client-sdks/resources/privacy-manifest/).
 
 ## Expo Support
 
@@ -76,10 +76,10 @@ The following code snippet shows for Mobile Core and Edge Network extensions as
 ...
 "dependencies": {
     "react-native": "0.72.5",
-    "@adobe/react-native-aepcore": "^6.0.0", //core is required and includes aepcore, aepsignal, aeplifecycle, aepidentity libraries
-    "@adobe/react-native-aepedge": "^6.0.0",
-    "@adobe/react-native-aepedgeidentity": "^6.0.0",
-    "@adobe/react-native-aepedgeconsent": "^6.0.0",
+    "@adobe/react-native-aepcore": "^7.0.0", //core is required and includes aepcore, aepsignal, aeplifecycle, aepidentity libraries
+    "@adobe/react-native-aepedge": "^7.0.0",
+    "@adobe/react-native-aepedgeidentity": "^7.0.0",
+    "@adobe/react-native-aepedgeconsent": "^7.0.0",
 ...
 },
 ```
@@ -112,182 +112,25 @@ To update native dependencies to latest available versions, run the following co
 cd ios && pod update && cd ..
 ```
 
-## Initializing
-
-Initializing the SDK should be done in native code inside your `AppDelegate` (iOS) and `MainApplication` (Android). The following code snippets demonstrate how to install and register the AEP Mobile Core and Edge Network extensions. Documentation on how to initialize each extension can be found in _./packages/{extension}/README.md_.
-
-##### **iOS**
-
-```objective-c
-//AppDelegate.h
-@import AEPCore;
-@import AEPServices;
-@import AEPLifecycle;
-@import AEPSignal;
-@import AEPEdge;
-@import AEPEdgeIdentity;
-@import AEPEdgeConsent;
-...
-```
-
-```objective-c
-//AppDelegate.m
-...
-@implementation AppDelegate
--(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
-  [AEPMobileCore setLogLevel: AEPLogLevelDebug];
-  [AEPMobileCore configureWithAppId:@"yourAppID"];
-
-  const UIApplicationState appState = application.applicationState;
-
-  [AEPMobileCore registerExtensions: @[
-      AEPMobileLifecycle.class,
-      AEPMobileSignal.class,
-      AEPMobileEdge.class,
-      AEPMobileEdgeIdentity.class,
-      AEPMobileEdgeConsent.class,
-  ] completion:^{
-    if (appState != UIApplicationStateBackground) {
-       [AEPMobileCore lifecycleStart:nil}];
-    }
-  }];
-  return YES;
-}
-
-@end
-
-```
-
-> To enable the Lifecycle metrics, [implement the Lifecycle APIs](./packages/core/README.md#lifecycle)
+## Importing the extension:
+In your React Native application, import the extensions.
 
-> Hint : While running iOS application after Adobe Experience Platform SDK installation. If you have build error that states:
-> "ld: warning: Could not find or use auto-linked library 'swiftCoreFoundation'"
-> This is because Adobe Experience Platform SDK now requires the app uses swift interfaces. Add a dummy .swift file to your project to embed the swift standard libs. See the SampleApp presented in this repo for example.
+The following example demonstrates how to import core extensions from the Adobe Experience Platform SDK in your React Native application:
 
-##### **Android:**
-
-###### **Java:**
-
-```java
-//MainApplication.java
-import com.adobe.marketing.mobile.AdobeCallback;
-import com.adobe.marketing.mobile.Extension;
-import com.adobe.marketing.mobile.LoggingMode;
-import com.adobe.marketing.mobile.MobileCore;
-import com.adobe.marketing.mobile.Lifecycle;
-import com.adobe.marketing.mobile.Signal;
-import com.adobe.marketing.mobile.Edge;
-import com.adobe.marketing.mobile.edge.consent.Consent;
-...
-import android.app.Application;
+```typescript
+import { MobileCore, Lifecycle, Signal, LogLevel, PrivacyStatus, Event } from '@adobe/react-native-aepcore'
 ```
 
-```java
-...
-public class MainApplication extends Application implements ReactApplication {
-  ...
-  @Override
-  public void on Create(){
-    super.onCreate();
-    ...
-    MobileCore.setApplication(this);
-    MobileCore.setLogLevel(LoggingMode.DEBUG);
-    MobileCore.configureWithAppID("yourAppID");
-    List<Class<? extends Extension>> extensions = Arrays.asList(
-                Lifecycle.EXTENSION,
-                Signal.EXTENSION,
-                Edge.EXTENSION,
-                com.adobe.marketing.mobile.edge.identity.Identity.EXTENSION,
-                Consent.EXTENSION);
-    MobileCore.registerExtensions(extensions, o -> {
-      Log.d(LOG_TAG, "AEP Mobile SDK is initialized");
-      MobileCore.lifecycleStart(null);
-      //enable this for Lifecycle. See Note for collecting Lifecycle metrics.
-    });
-  }
-}
-```
+Refer to each package's documentation for specific import details.
 
-###### **Kotlin:**
-
-```kotlin
- // MainApplication.kt
-import com.adobe.marketing.mobile.Edge
-import com.adobe.marketing.mobile.Lifecycle
-import com.adobe.marketing.mobile.LoggingMode
-import com.adobe.marketing.mobile.MobileCore
-import com.adobe.marketing.mobile.MobileCore.getApplication
-import com.adobe.marketing.mobile.edge.consent.Consent
-import com.adobe.marketing.mobile.edge.identity.Identity
-```
+## Initializing
 
-```kotlin
-// MainApplication.kt
- class MainApplication : Application(), ReactApplication {
-   ...
- override fun onCreate() {
-    super.onCreate()
-    
-    MobileCore.setApplication(this);
-    MobileCore.setLogLevel(LoggingMode.DEBUG)
-    MobileCore.configureWithAppID("YOUR-APP-ID");
-    MobileCore.registerExtensions(
-      listOf(
-        Lifecycle.EXTENSION,
-        Edge.EXTENSION,
-        Identity.EXTENSION,
-        Consent.EXTENSION
-      ),
-    ) {
-      Log.d("MainApp", "Adobe Experience Platform Mobile SDK was initialized")
-    }
-
-    SoLoader.init(this, false)
-    if (BuildConfig.IS_NEW_ARCHITECTURE_ENABLED) {
-      // If you opted-in for the New Architecture, we load the native entry point for this app.
-      load()
-    }
-    ApplicationLifecycleDispatcher.onApplicationCreate(this)
-  }
-```
+Then, initialize the SDK using the following methods:
+- [MobileCore.initializeWithAppId(appId)](https://github.com/adobe/aepsdk-react-native/tree/main/packages/core#initializewithappid)
+- [MobileCore.initialize(initOptions)](https://github.com/adobe/aepsdk-react-native/tree/main/packages/core#initialize)
 
-```kotlin
-// MainActivity.kt
-
-import android.app.Activity
-import android.app.Application.ActivityLifecycleCallbacks
-import com.adobe.marketing.mobile.MobileCore
-
-// Implementing global lifecycle callbacks
-override fun onCreate(savedInstanceState: Bundle?) {
-    // Set the theme to AppTheme BEFORE onCreate to support
-    // coloring the background, status bar, and navigation bar.
-    // This is required for expo-splash-screen.
-    setTheme(R.style.AppTheme);
-    super.onCreate(null)
-
-    application.registerActivityLifecycleCallbacks(object : ActivityLifecycleCallbacks {
-        override fun onActivityResumed(activity: Activity) {
-            MobileCore.setApplication(application)
-            MobileCore.lifecycleStart(null)
-        }
-
-        override fun onActivityPaused(activity: Activity) {
-            MobileCore.lifecyclePause()
-        }
-
-        // the following methods aren't needed for our lifecycle purposes, but are
-        // required to be implemented by the ActivityLifecycleCallbacks object
-        override fun onActivityCreated(activity: Activity, savedInstanceState: Bundle?) {}
-        override fun onActivityStarted(activity: Activity) {}
-        override fun onActivityStopped(activity: Activity) {}
-        override fun onActivitySaveInstanceState(activity: Activity, outState: Bundle) {}
-        override fun onActivityDestroyed(activity: Activity) {}
-    })
-  }
-```
-
-> For further details on Lifecycle implementation, please refer to the [Lifecycle API documentation](https://github.com/adobe/aepsdk-react-native/tree/main/packages/core#lifecycle).
+> [!NOTE]  
+> Starting from Adobe Experience Platform React native **7.x**,  there is no longer a need to initialize the SDK on the [native platforms](https://github.com/adobe/aepsdk-react-native/tree/v6.x/#initializing), as was required in earlier versions.
 
 ## Migration guide
 

apps/AEPSampleApp/App.tsx

@@ -28,6 +28,8 @@ import TargetView from './extensions/TargetView';
 import PlacesView from './extensions/PlacesView';
 import {NavigationProps} from './types/props';
 import CampaignClassicView from './extensions/CampaignClassicView';
+import { MobileCore , LogLevel} from '@adobe/react-native-aepcore';
+import { useEffect } from 'react';
 
 function HomeScreen({navigation}: NavigationProps) {
   return (
@@ -91,6 +93,37 @@ function HomeScreen({navigation}: NavigationProps) {
 const Drawer = createDrawerNavigator();
 
 export default function App() {
+
+  useEffect(() => {
+    // If you need more customization, you can use the initOptions object and MobileCore.initialize() method.
+  
+    // const initOptions = {
+    //   appId: "YOUR-APP-ID", //optional,
+    //   lifecycleAutomaticTrackingEnabled: true, //optional
+    //   lifecycleAdditionalContextData: { "contextDataKey": "contextDataValue" }, //optional
+    //   appGroupIOS: "group.com.your.app.identifier" //optional, for iOS app groups
+    // };
+  
+    // MobileCore.initialize(initOptions).then(() => {  
+    //   console.log("AEP SDK Initialized");
+    // }).catch((error) => { 
+    //   console.log("AEP SDK Initialization error", error);            
+    // });
+  
+    // Initialize SDK once in App.tsx or the entry file.
+    // For functional components, use useEffect with an empty dependency array.
+    // For class components, call initializeWithAppId inside componentDidMount.
+    MobileCore.setLogLevel(LogLevel.DEBUG);
+    MobileCore.initializeWithAppId("YOUR-APP-ID")
+      .then(() => {
+        console.log("AEP SDK Initialized");
+      })
+      .catch((error) => {
+        console.error("AEP SDK Initialization error:", error);
+      });
+  }, []);
+  
+  
   return (
     <NavigationContainer>
       <Drawer.Navigator initialRouteName="Home">

apps/AEPSampleApp/README.md

@@ -20,9 +20,7 @@ This project is a React Native app set up using `react-native-cli`. It serves as
 
 ### Add your App Id:
 
-In `apps/AEPSampleApp/ios/AEPSampleApp/AppDelegate.mm`, find the call to `configureWithAppId` and add your app id.
-
-In `apps/AEPSampleApp/android/app/src/main/java/com/aepsampleapp/MainApplication.java`, find the call to `configureWithAppId` and add your app id.
+In `/apps/AEPSampleApp/App.tsx`, locate the call to `MobileCore.initializeWithAppId(appId:"YOUR_APP_ID")` and replace `"YOUR_APP_ID"` with your property App Id.
 
 > Note: App id is configured in a mobile property in Data Collection UI, in Tags.  Refer to [configure with App ID per environment](https://developer.adobe.com/client-sdks/home/base/mobile-core/configuration/#configure-with-app-id-per-environment) page for more information.
 

apps/AEPSampleApp/android/app/src/main/java/com/aepsampleapp/MainActivity.kt

@@ -10,7 +10,6 @@ governing permissions and limitations under the License.
 */
 package com.aepsampleapp
 
-import com.adobe.marketing.mobile.MobileCore
 import com.facebook.react.ReactActivity
 import com.facebook.react.ReactActivityDelegate
 import com.facebook.react.defaults.DefaultNewArchitectureEntryPoint.fabricEnabled
@@ -31,14 +30,4 @@ class MainActivity : ReactActivity() {
   override fun createReactActivityDelegate(): ReactActivityDelegate =
       DefaultReactActivityDelegate(this, mainComponentName, fabricEnabled)
 
-    override fun onResume() {
-        super.onResume()
-        MobileCore.setApplication(application);
-        MobileCore.lifecycleStart(null);
-    }
-
-    override fun onPause() {
-        super.onPause()
-        MobileCore.lifecyclePause();
-    }
 }

apps/AEPSampleApp/android/app/src/main/java/com/aepsampleapp/MainApplication.kt

@@ -11,22 +11,6 @@ governing permissions and limitations under the License.
 package com.aepsampleapp
 
 import android.app.Application
-import com.adobe.marketing.mobile.AdobeCallback
-import com.adobe.marketing.mobile.Assurance
-import com.adobe.marketing.mobile.Edge
-import com.adobe.marketing.mobile.Extension
-import com.adobe.marketing.mobile.Lifecycle
-import com.adobe.marketing.mobile.LoggingMode
-import com.adobe.marketing.mobile.Messaging
-import com.adobe.marketing.mobile.MobileCore
-import com.adobe.marketing.mobile.Places
-import com.adobe.marketing.mobile.Signal
-import com.adobe.marketing.mobile.Target
-import com.adobe.marketing.mobile.UserProfile
-import com.adobe.marketing.mobile.edge.bridge.EdgeBridge
-import com.adobe.marketing.mobile.edge.consent.Consent
-import com.adobe.marketing.mobile.edge.identity.Identity
-import com.adobe.marketing.mobile.optimize.Optimize
 import com.facebook.react.PackageList
 import com.facebook.react.ReactApplication
 import com.facebook.react.ReactHost
@@ -37,8 +21,6 @@ import com.facebook.react.defaults.DefaultReactHost.getDefaultReactHost
 import com.facebook.react.defaults.DefaultReactNativeHost
 import com.facebook.react.flipper.ReactNativeFlipper
 import com.facebook.soloader.SoLoader
-import java.util.Arrays
-
 
 class MainApplication : Application(), ReactApplication {
 
@@ -69,31 +51,7 @@ class MainApplication : Application(), ReactApplication {
       load()
     }
     ReactNativeFlipper.initializeFlipper(this, reactNativeHost.reactInstanceManager)
-
-
-    MobileCore.setApplication(this)
-    MobileCore.setLogLevel(LoggingMode.VERBOSE)
-    MobileCore.configureWithAppID("YOUR-APP-ID")
-    val extensions: List<Class<out Extension?>> = Arrays.asList(
-      Lifecycle.EXTENSION,
-      Signal.EXTENSION,
-      Edge.EXTENSION,
-      Identity.EXTENSION,
-      Consent.EXTENSION,
-      EdgeBridge.EXTENSION,
-      Messaging.EXTENSION,
-      UserProfile.EXTENSION,
-      Assurance.EXTENSION,
-      Places.EXTENSION,
-      Target.EXTENSION,
-      Optimize.EXTENSION,
-      com.adobe.marketing.mobile.Identity.EXTENSION
-    )
-    MobileCore.registerExtensions(extensions,
-      AdobeCallback { o: Any? ->
-        MobileCore.lifecycleStart(
-          null
-        )
-      })
+    
+ 
   }
 }