Pour utiliser l'extension Places Monitor, effectuez les tâches suivantes :
Il n'existe aucune tâche de configuration pour l'extension du moniteur de lieux.
de lieux
Vous trouverez ci-dessous les instructions concernant l’ajout de l’extension Places Monitor à votre application Android ou iOS.
La prise en charge des plates-formes supplémentaires pour l'extension Places Monitor inclut :
Cordova Places Monitor
Réagir à l'écran des emplacements natifs
Sous Android, procédez comme suit :
Ajoutez l’extension Places Monitor et l’extension Places à votre projet à l’aide du fichier de nivellement de votre application.
Incluez également les derniers services Google Location dans le fichier de classement.
implementation 'com.adobe.marketing.mobile:places:1.+'
implementation 'com.adobe.marketing.mobile:places-monitor:1.+'
implementation 'com.adobe.marketing.mobile:sdk-core:1.+'
implementation 'com.google.android.gms:play-services-location:16.0.0'
Importez l’extension Places Monitor dans l’activité principale de votre application.
import com.adobe.marketing.mobile.PlacesMonitor;
Sous iOS, procédez comme suit :
Podfile
Cocoapods en ajoutant le pod 'ACPPlacesMonitor'
.#import "ACPCore.h"
#import "ACPPlaces.h"
#import "ACPPlacesMonitor.h"
import ACPCore
import ACPPlaces
import ACPPlacesMonitor
Vous devez enregistrer et début le moniteur de lieux sur Android ou iOS.
Sous Android, procédez comme suit :
Dans la méthode OnCreate
de votre application, enregistrez les extensions du moniteur de lieux :
public class MobileApp extends Application {
@Override
public void onCreate() {
super.onCreate();
MobileCore.setApplication(this);
MobileCore.ConfigureWithAppId("yourAppId");
try {
PlacesMonitor.registerExtension(); //Register PlacesMonitor with Mobile Core
Places.registerExtension(); //Register Places with Mobile Core
MobileCore.start(null);
PlacesMonitor.start();//Start monitoring the geo-fences
} catch (Exception e) {
//Log the exception
}
}
}
La surveillance des lieux dépend de l'extension Places. Lorsque vous installez manuellement l’extension Surveiller les Places, veillez à ajouter également la bibliothèque places.aar
à votre projet.
Dans l’application iOS application:didFinishLaunchingWithOptions
, inscrivez PlacesMonitor
et les emplacements avec Mobile Core :
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions {
[ACPCore configureWithAppId:@"yourAppId"];
[ACPPlaces registerExtension];
[ACPPlacesMonitor registerExtension];
[ACPCore start:^{
// do other initialization required for the SDK
[ACPPlacesMonitor start];
}];
return YES;
}
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
ACPCore.configure(withAppId: "yourAppId")
ACPPlaces.registerExtension()
ACPPlacesMonitor.registerExtension()
ACPCore.start({
// do other initialization required for the SDK
ACPPlacesMonitor.start()
})
// Override point for customization after application launch.
return true
}
La surveillance des lieux dépend de l'extension Places. Lors de l'installation manuelle de l'extension Places Monitor, veillez à ajouter également la bibliothèque libACPPlaces_iOS.a
à votre projet.
Java
Pour toutes les versions d'Android, pour déclarer que votre application a besoin d'une autorisation d'emplacement, ajoutez un élément <uses-permission>
dans votre manifeste d'application, en tant qu'enfant de l'élément de niveau supérieur <manifest>
. Pour les applications Android qui utilisent l'API de cible Niveau 29 et plus, pour permettre à l'application d'accéder à un emplacement en arrière-plan, incluez l'autorisation ACCESS_BACKGROUND_LOCATION.
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.adobe.placesapp">
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
// Only for Android apps targeting API level 29 and above
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
<application>
...
</application>
</manifest>
iOS prend en charge la diffusion de événements d’emplacement pour les applications suspendues ou qui ne sont plus en cours d’exécution. Pour recevoir les mises à jour d'emplacement en arrière-plan pour l'extension Places Monitor, configurez la fonctionnalité de mises à jour d'emplacement pour votre application dans Xcode.background-location-updates
.
Les clés suivantes doivent être incluses dans le fichier Info.plist
de votre application :
NSLocationWhenInUseUsageDescription
- le texte doit décrire pourquoi l’application demande l’accès aux informations d’emplacement de l’utilisateur lors de son exécution au premier plan.NSLocationAlwaysAndWhenInUseUsageDescription
- le texte doit décrire pourquoi l’application demande l’accès aux informations d’emplacement de l’utilisateur en tout temps.Si votre application prend en charge iOS 10 et les versions antérieures, la clé NSLocationAlwaysUsageDescription
est également requise.