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>

In the implementation file (.m) of your AppDelegate, in the method didFinishLaunchingWithOptions call:

[Plot initializeWithDelegate:self];

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

dependencies {
    // other dependencies

    // use compile instead of implementation when using Android Studio 2.x
    implementation 'com.plotprojects:plot-android:3.11.0'
    implementation 'androidx.core:core:1.1.0'
    implementation 'androidx.fragment:fragment:1.1.0'
    implementation 'androidx.work:work-runtime:2.2.0'
    implementation 'androidx.work:work-gcm:2.2.0'
    implementation 'com.google.android.gms:play-services-location:17.0.0'
    implementation 'com.google.android.gms:play-services-nearby:17.0.0'
    implementation 'com.google.firebase:firebase-core:17.2.1'
    implementation 'com.google.firebase:firebase-messaging:20.0.1'
    implementation 'com.google.android.gms:play-services-awareness:17.1.0'
    implementation 'androidx.swiperefreshlayout:swiperefreshlayout:1.0.0'
}

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

android {
    // other android specific gradle configuration

    defaultConfig {
        applicationId "com.myplotapplication"
        minSdkVersion 16
        targetSdkVersion 31
        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,
    "showOnGoingNotification": "during_network_request",
    "enableCombinedMonitoring": "false"
}

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

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") {
 Plot.initialize();
 } else {
 const granted = await PermissionsAndroid.requestMultiple(
 [PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION,
 PermissionsAndroid.PERMISSIONS.ACCESS_COARSE_LOCATION,
 PermissionsAndroid.PERMISSIONS.ACCESS_BACKGROUND_LOCATION]);
 if (granted['android.permission.ACCESS_BACKGROUND_LOCATION'] === PermissionsAndroid.RESULTS.GRANTED
 || granted['android.permission.ACCESS_COARSE_LOCATION'] === PermissionsAndroid.RESULTS.GRANTED
 || granted['android.permission.ACCESS_BACKGROUND_LOCATION'] === PermissionsAndroid.RESULTS.GRANTED
 ) {
 console.log("Location permission granted!");
 Plot.initialize();
 } else {
 console.log("Location permission denied");
 }
 }

} 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.