Step-by-Step Integration

  1. Go to https://manage.extremelocation.com, log in with your credentials, and create a new App.
    Note

    Note

    Take note of the AppKey and AppSecret that are generated there for use in your application.
  2. Create an application using Android SDK version 21 or later.
  3. Add the following .aar files from the ExtremeLocation SDK download as modules in your application:
    • FootmarksSdk.aar
  4. Add the following entries to your dependencies in your application's build.gradle in addition to the SDK implementation statement.
    implementation('com.google.android.gms:play-services-ads:15.0.1')   
    implementation('com.google.android.gms:play-services-location:15.0.1')   
    implementation('com.google.code.gson:gson:2.6.1')     
    implementation 'org.greenrobot:eventbus:3.1.1'    
    implementation 'com.squareup.okhttp3:okhttp:3.11.0'
  5. Add the following compile options:
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
  6. Check out the example project located in the SDK zip to start scanning for beacons.

If targeting your application for Android M (level 23) or higher you are expected to request permissions on an Activity. ExtremeLocation Android SDK requires one further permission be granted before beacon scanning can start.

android.permission.ACCESS_FINE_LOCATION

Refer to Google documentation for information on how to request permission https://developer.android.com/training/permissions/requesting.

Note

Note

The ExtremeLocation Android SDK will not function without this permission and may respond with an error upon calling the init function().