Android Probe API

Installation in your project libraries or in a Maven repository

Download the aar library from the GREENSPECTOR Modules page on the Web Interface and install it:

• either in the libs folder of your Android project;
• or in a local or remote Maven repository.

Example for a local Maven repository:

mvn install:install-file
-Dfile=greenspector-probe-android-[version].aar
-DgroupId=com.greenspector.probe.android
-DartifactId=greenspector-probe-android
-Dversion=[version]
-Dpackaging=aar

Integration in your Android project

If you have installed the library in the libs folder of your Android project

Add the dependency in your project's module build.gradle file:

dependencies {
	compile files('libs/greenspector-probe-android-[version].aar')
}

If you have installed the library in a Maven repository

Check your Maven repository is configured inside the project's build.gradle file.

Example for a local Maven repository:

repositories {
	mavenLocal()
}

Add the dependency in your project's module build.gradle file:

dependencies {
	compile ('com.greenspector.probe.android:greenspector-probe-android:[version]')
}

Android project configuration

In order to be able to correctly use the Probe API you need to add some permissions in your application's AndroidManifest.xml file.

• Permission to use Internet (to send the results to the GREENSPECTOR Server):

 <uses-permission android:name="android.permission.INTERNET"/>

• Permissions to read and write on the SD Card (to read and write results files):

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

IMPORTANT

From Android 6.0 (API level 23), some permissions are considered dangerous.
The permissions android.permission.READ_EXTERNAL_STORAGE and android.permission.WRITE_EXTERNAL_STORAGE must be granted explicitly via ADB commands for the measures to run correctly.

First install your application on your mobile, then launch the following commands to grant permissions:

adb shell pm grant com.example.myapp android.permission.READ_EXTERNAL_STORAGE
adb shell pm grant com.example.myapp android.permission.WRITE_EXTERNAL_STORAGE

Related articles