#Android for Maven Eclipse

Copyright (c) 2009, 2010, 2011, 2012, 2013, 2014, 2015 Ricardo Gladwell, Hugo Josefson, Anthony Dannane, Mykola Nikishov, Raphael Ackermann, Csaba Kozák, and Sonatype Inc.. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License 1.0 which accompanies this distribution

Android for Maven Eclipse (m2e-android) adds Maven support to the Android Developer Tools (ADT). This is developer documentation, for user instructions on how to install please see the project web site.

Lead Maintainer: Ricardo Gladwell

Special thanks to our patrons who crowdfunded project development through Patreon:

• Raphael Ackermann
• George Baker.
• Weizhi Yao.
• Stephen Buergler.

#Building

Before you start you need to:

• Install the Android SDK.
• Create ANDROID_HOME environment variable containing the Android SDK install path.
• Ensure you have installed the requried Android dependencies (execute android update sdk --filter platform-tools,build-tools-21.1.1,android-18,addon-google_apis-google-18,android-10,addon-google_apis-google-10,android-8,addon-google_apis-google-8 --no-ui --force).
• Install the latest Maven 3 for command line Tycho support.
• Install the Maven Android SDK Deployer and deploy the 4.1 and 4.3 APIs (mvn install -P 4.3,2.2).

To build execute the following command from the project folder:

$ mvn install

###Eclipse Set-up

To configure your development environment please follow these steps:

• Install Eclipse Luna.
• Install Eclipse Plug-in Development Environment..
• Restart Eclipse.

This project consists of several sub-modules, including:

• Parent POM.
• Core Eclipse plugin.
• Test suite.
• Eclipse feature.
• Various target definitions.
• and the update site.

To clone them into your Eclipse workspace follow these steps:

• Clone this git repository into your local workspace.
• In Eclipse select File -> Import... in the menu and then select Maven -> Existing Maven Projects.
• Select the m2e-android folder you just cloned and select the parent and some of the sub-projects (excluding the targets i.e. luna, mars, etc., but including the compile target).
• Click Finish.
• This should install some additional m2e extensions if not already installed
• Restart Eclipse when prompted.
• In Preferences -> Plug-In Development -> Target Platform choose Maven for Android Eclipse and click OK. It may take some time to downloads the dependencies required to compile m2e-android.

##Further Reading

For more information on developing the m2e-android plug-in please see the following:

• Contributing
• Deployment
• Travis
• Maven Eclipse
• Maven Android Plugin