Quick install

Run in your terminal:

pod install --repo-update

Under the “info” tab in Xcode add the following property list keys and add an description of why you want to acces a users location:

NSLocationAlwaysUsageDescription
NSLocationWhenInUseUsageDescription
NSLocationAlwaysAndWhenInUseUsageDescription

Add this file as plotconfig.json in the root folder:

{
  "publicToken": "REPLACE_ME",
  "enableOnFirstRun": true
}

Add PlotDelegate to the implemented protocols of your AppDelegate:

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate, PlotDelegate

In AppDelegate, add to the func application method:

PlotDebug.initialize(launchOptions: launchOptions, delegate: self)

This method must be called before the end of application!

Run in your terminal:

pod install --repo-update

Under the “info” tab in Xcode add the following property list keys and add a description of why you want to acces a users location:

NSLocationAlwaysUsageDescription
NSLocationWhenInUseUsageDescription
NSLocationAlwaysAndWhenInUseUsageDescription

Add this file as plotconfig.json in the root folder:

{
  "publicToken": "REPLACE_ME",
  "enableOnFirstRun": true
}

Add PlotDelegate to the implemented protocols of your AppDelegate in the header(.h) file:

#import <PlotProjects/Plot.h>

	@interface AppDelegate : UIResponder<UIApplicationDelegate, PlotDelegate>

application:didFinishLaunchingWithOptions:

call:

[Plot initializeWithDelegate:self];

The initialize method must be called before the end of that method.

Add the PlotProjects Android plugin as a dependency in your app/build.gradle, check the full documentation for the right .gradle depending on the plugin version:

dependencies {
    // other dependencies

    // use compile instead of implementation when using Android Studio 2.x
    implementation 'com.plotprojects:plot-android:3.19.1'
    implementation 'androidx.work:work-runtime:2.7.1'
    implementation 'androidx.work:work-gcm:2.7.1'
    implementation 'com.google.android.gms:play-services-location:20.0.0'
    implementation 'com.google.android.gms:play-services-nearby:18.3.0'
    implementation 'com.google.android.gms:play-services-awareness:19.0.1'

    implementation platform('com.google.firebase:firebase-bom:30.4.0')
    implementation 'com.google.firebase:firebase-core'
    implementation 'com.google.firebase:firebase-messaging'
}

Set the minSdkVersion version to at least 16 in your app/build.gradle:

android {
    // other android specific gradle configuration

    defaultConfig {
        applicationId "com.myplotapplication"
        minSdkVersion 24
        targetSdkVersion 33
        versionCode 1
        versionName "1.0"
    }   
}

Plot uses a configuration file which you have to define (or create) as assets/plotconfig.json:

{
    "publicToken": "REPLACE_ME",
    "enableOnFirstRun": true,
    "debug": true,
    "enableCombinedMonitoring": "false"
}

Call Plot.init(Activity) to initialize the plugin from your main Activity:

import com.plotprojects.retail.android.Plot; 
public class MyActivity extends Activity {
     @Override
     protected void onCreate(Bundle savedInstanceState) {
       // code of your activity

       Plot.init(this); // add this line initialize the Plot Plugin
     }
}

Add plotconfig.json to both the Android and iOS projects

Add this file as plotconfig.json in the root folder:

{

"publicToken": "REPLACE_ME",

"enableOnFirstRun": true

}

You can find more information in Step 4 of the iOS Integration guide

Plot uses a configuration file which you have to define (or create) as  assets/plotconfig.json:

{
"publicToken": "REPLACE_ME",
"enableOnFirstRun": true,
"debug": true,
"enableCombinedMonitoring": "false"
}

You can find more information in Step 4 of the Android Integration guide

Add the following code to your App.js to initialize the plugin:

import { PermissionsAndroid } from 'react-native';

import Plot from 'plotprojects-react-native-module';

const requestLocationPermission = async () => {
 try {
 if(Platform.OS === "ios") {
 initializePlot();
 } else {
 const granted = await PermissionsAndroid.requestMultiple(
 ["android.permission.POST_NOTIFICATIONS",
  PermissionsAndroid.PERMISSIONS.ACCESS_COARSE_LOCATION,
  PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION,
 ]);
 if (granted['android.permission.ACCESS_COARSE_LOCATION'] === PermissionsAndroid.RESULTS.GRANTED
  || granted['android.permission.ACCESS_FINE_LOCATION'] === PermissionsAndroid.RESULTS.GRANTED
 ) {
   console.log("Foreground location permission granted!");
   const granted = await PermissionsAndroid.request(PermissionsAndroid.PERMISSIONS.ACCESS_BACKGROUND_LOCATION);
   if (granted['android.permission.ACCESS.BACKGROUND_LOCATION'] === PermissionsAndroid.RESULTS.GRANTED {
   console.debug("Background location permissions granted!");
   } else {
   console.debug("Background location permission denied!");
   }
InitializePlot();
 } else {
   console.log("Location permission denied!. Not initializing PlotProjects SDK.");
  }
 }
} catch (err) {
  console.warn(err);
 }
 };

requestLocationPermission();

Since we interact with the native components, the necessary steps to integrate the Plot plugin are the same as for a native Java app. To open the platform-specific code, select from the menu: Tools > Flutter > Open for editing in Android Studio. The rest of the steps are in the Android integration guide.