Step-by-step guide

1. Install the aar lib provided by GREENSPECTOR in your project or in an available Maven local or remote repository.

mvn

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

...