On August 31, 2021, the Places Monitor extension for the Adobe Experience Platform Mobile SDKs was deprecated. Adobe no longer plans to update or support Places Monitor extension beyond August 31st.
@adobe/react-native-acpplaces-monitor
is a wrapper around the iOS and Android AEP Places SDK to allow for integration with React Native applications. Functionality to enable Adobe Places is provided entirely through JavaScript documented below.
You need to install the SDK with npm and configure the native Android/iOS project in your react native project. Before installing the Places extension it is recommended to begin by installing the Core extension.
Note: If you are new to React Native we suggest you follow the React Native Getting Started page before continuing.
First create a React Native project:
react-native init MyReactApp
Install and link the @adobe/react-native-acpplaces-monitor
package:
cd MyReactApp
npm install @adobe/react-native-acpplaces-monitor
- React Native 0.60+
CLI autolink feature links the module while building the app.
- React Native <= 0.59
react-native link @adobe/react-native-acpplaces-monitor
Note For iOS
using cocoapods
, run:
cd ios/ && pod install
This project contains jest unit tests which are contained in the __tests__
directory, to run the tests locally:
make run-tests-locally
import {ACPPlacesMonitor} from '@adobe/react-native-acpplaces-monitor';
ACPPlacesMonitor.extensionVersion().then(version => console.log("AdobeExperienceSDK: ACPPlacesMonitor version: " + version));
Within the App's application:didFinishLaunchingWithOptions, register the SDK extensions:
#import "ACPCore.h"
#import "ACPPlaces.h"
#import "ACPPlacesMonitor.h"
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions {
[ACPCore configureWithAppId:@"yourAppId"];
[ACPPlaces registerExtension]; //Register Places with Core
[ACPPlacesMonitor registerExtension]; //Register PlacesMonitor with Core
[ACPCore start: nil];
return YES;
}
The following updates are also neccessary for Places Monitor on iOS:
- Enable location updates in the background
- Add the keys NSLocationWhenInUseUsageDescription and NSLocationAlwaysAndWhenInUseUsageDescription to the app's plist file
Within the App's OnCreate method, register the SDK extensions and start the Places Monitor:
import com.adobe.marketing.mobile.MobileCore;
import com.adobe.marketing.mobile.Places;
import com.adobe.marketing.mobile.PlacesMonitor;
public class MobileApp extends Application {
@Override
public void onCreate() {
super.onCreate();
MobileCore.setApplication(this);
MobileCore.ConfigureWithAppId("yourAppId");
try {
Places.registerExtension(); //Register Places with Core
PlacesMonitor.registerExtension(); //Register PlacesMonitor with Core
MobileCore.start(null);
} catch (Exception e) {
//Log the exception
}
}
}
The following update is also necessary for Places Monitor on Android:
ACPPlacesMonitor.start();
ACPPlacesMonitor.stop(true);
ACPPlacesMonitor.updateLocation();
ACPPlacesMonitor.setRequestLocationPermission(ACPPlacesMonitorLocationPermission.ALWAYS_ALLOW);
ACPPlacesMonitor.setRequestLocationPermission(ACPPlacesMonitorLocationPermission.WHILE_USING_APP);
ACPPlacesMonitor.setRequestLocationPermission(ACPPlacesMonitorLocationPermission.NONE);
ACPPlacesMonitor.setPlacesMonitorMode(ACPPlacesMonitorModes.CONTINUOUS);
ACPPlacesMonitor.setPlacesMonitorMode(ACPPlacesMonitorModes.SIGNIFICANT_CHANGES);
Below is a list of additional React Native plugins from the AEP SDK suite:
Extension | npm package |
---|---|
Core | |
Analytics | |
Audience | |
Campaign | |
Media | |
Target | |
User Profile | |
Places |
See CONTRIBUTING
See LICENSE