Prerequisites

Note: The GeoMoby library requires the following versions:

Feature

API Level

Android Version

Base product

10+

2.3.3 (Gingerbread)

GeoSync

16+

4.1 (Jelly Bean)

iBeacons

18+

4.3 (Jelly Bean)

Create your new Android Project in Android Studio. In the example below, the project name is “GEO_Test” and the Module name is “app”. Go to the app folder and create a folder named “libs” then copy “geomoby-android-vX.X.X.X.jar” to this folder -

../../_images/libs-folder.png

Open module settings and add a file dependency for “libs/geomoby-android-vX.X.X.X.jar” -

../../_images/file-dep.png

Add the module dependencies highlighted below -

dependencies {
    implementation fileTree(include: ['*.jar'], dir: 'libs')
    implementation 'com.google.android.gms:play-services-location:17.0.0'
    implementation 'com.squareup.retrofit2:retrofit:2.7.1'
    implementation 'com.squareup.retrofit2:converter-gson:2.7.1'
    implementation 'com.squareup.okhttp3:logging-interceptor:3.14.2'
    implementation 'com.vividsolutions:jts:1.13'
    implementation 'org.altbeacon:android-beacon-library:2.16.3'
    implementation 'androidx.work:work-runtime-ktx:2.4.0-beta01'

    // For GeoSync Features
    implementation 'com.google.firebase:firebase-core:17.4.3'
    implementation 'com.google.firebase:firebase-messaging:20.2.1'
}

Note: Some Android manufacturers prefer battery life over proper functionality of your apps and won’t hesitate to kill any background apps. Communicate these issues with users and provide them with hacks, workarounds and guides to keep their apps working and making their lives easier. Have a look at this great website

Enable support for Multidex (required for apps with over 64K methods) -

<application
        ...
        android:name="android.support.multidex.MultiDexApplication">

Implement the Application interface and initialise Multidex -

public class MultidexApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        MultiDex.install(this);
    }
}

If you will be using the GeoSync feature refer to GeoSync for further setup instructions.