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 :
Moniteur des emplacements Cordova
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 OnCreate
méthode de votre application, enregistrez les extensions du moniteur d’emplacements :
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 votre applicationapplication:didFinishLaunchingWithOptions
iOS, inscrivez-vous PlacesMonitor
et 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. When manually installing the Places Monitor extension, ensure that you also add the libACPPlaces_iOS.a
library to your project.
Java
Pour toutes les versions d'Android, pour déclarer que votre application a besoin d'une autorisation d'emplacement, ajoutez un <uses-permission>
élément dans le manifeste de votre application, en tant qu'enfant de l' <manifest>
élément de niveau supérieur. 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 de l’emplacement en arrière-plan pour l’extension Places Monitor, configurez la fonctionnalité de mises à jour de l’emplacement pour votre application dans Xcode.background-location-updates
.
Les clés suivantes doivent être incluses dans le Info.plist
fichier 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 NSLocationAlwaysUsageDescription
clé est également requise.