Maven setup presents some challenges, namely telling Maven where the Android SDK jars live, and telling Maven how to build your Android application.
The Google API jars, such as the maps.jar, are not available for download from Sonatype. If you plan on using a Google API add-ons you may be interested in maven-android-sdk-deployer. Using this project will make the maps jars available to your local Maven install.
The maven-android-plugin makes it easy to add Robolectric to your Android project.
Create a file named pom.xml in the root of your project based on this example:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>MySampleApp</artifactId>
<version>1.0.0-SNAPSHOT</version>
<packaging>apk</packaging>
<name>My Sample App</name>
<dependencies>
<dependency>
<groupId>com.google.android</groupId>
<artifactId>android</artifactId>
<version>2.2.1</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>com.google.android.maps</groupId>
<artifactId>maps</artifactId>
<version>8_r2</version>
<scope>provided</scope>
</dependency>
<!-- Make sure this is below the android dependencies -->
<dependency>
<groupId>com.pivotallabs</groupId>
<artifactId>robolectric</artifactId>
<version>X.X.X</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.8.2</version>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<finalName>${project.artifactId}</finalName>
<plugins>
<plugin>
<!-- See http://code.google.com/p/maven-android-plugin/ -->
<groupId>com.jayway.maven.plugins.android.generation2</groupId>
<artifactId>maven-android-plugin</artifactId>
<version>2.8.3</version>
<configuration>
<sdk>
<!-- platform or api level (api level 8 = platform 2.2)-->
<platform>8</platform>
</sdk>
</configuration>
<extensions>true</extensions>
</plugin>
</plugins>
</build>
</project>
Note that you need Robolectric and JUnit 4 in ‘test’ scope, and android, android-test, and maps in ‘provided’ scope.
You’ll need the standard AndroidManifest.xml file in your root directory, as well as something like the following files:
/res/layout/main.xml /res/values/strings.xml /src/main/java/com/pivotallabs/MyActivity.java /src/test/java/com/pivotallabs/MyActivityTest.java
You should then be able to build your project and run tests using maven install.
In Project View, right click on MyProject>code>test -> New -> Java class -> MyActivityTest Add the following source:
import com.example.MyActivity;
import com.example.R;
import com.xtremelabs.robolectric.RobolectricTestRunner;
import org.junit.Test;
import org.junit.runner.RunWith;
import static org.hamcrest.CoreMatchers.equalTo;
import static org.junit.Assert.assertThat;
@RunWith(RobolectricTestRunner.class)
public class MyActivityTest {
@Test
public void shouldHaveHappySmiles() throws Exception {
String appName = new MyActivity().getResources().getString(R.string.app_name);
assertThat(appName, equalTo("MyActivity"));
}
}
Typing: mvn clean test will run the tests.
Go check out the Maven sections of IntelliJ and Eclipse.
When running tests from within IntelliJ or Eclipse, be sure to run tests using the JUnit runner, not the Android Test runner.
export the ANDROID_HOME environment variable. You might want to set this in .bash_profile or .bashrc.
export ANDROID_HOME="PATH/TO/THE/ANDROID/SDK"-or-
Tell Maven where to find Android by making your ~/.m2/settings.xml file look something like this:
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
http://maven.apache.org/xsd/settings-1.0.0.xsd">
<profiles>
<profile>
<id>android</id>
<properties>
<android.sdk.path>
PATH / TO / THE / ANDROID / SDK
</android.sdk.path>
</properties>
</profile>
</profiles>
<activeProfiles>
<!--make the profile active all the time -->
<activeProfile>android</activeProfile>
</activeProfiles>
</settings>