Skip to content

Latest commit

 

History

History
82 lines (48 loc) · 3.65 KB

README.md

File metadata and controls

82 lines (48 loc) · 3.65 KB
Raw

aerogear-android Build Status

This project is the core Aerogear library for Android. It is build using Maven as an apk lib.

Get Started With AeroGear on Android

Introduction

AeroGear's Android libraries are built as apklib projects using Maven and the android-maven-plugin. The project follows the standard Android project layout so sources will be in /src instead of /src/main/java and can be imported directly into Eclipse as an Android project.

After the library has been built, we will clone and run the TODO sample application to confirm it is working.

If you are unfamiliar with Maven, developerWorks has a detailed introduction. This guide will cargo cult everything you need to build and test the AeroGear library and real familiarity isn't necessary.

Android AeroGear Library

Prerequisites

  • Java 6.0 (Java SDK 1.6)+
  • Maven 3+
  • Git
  • Android SDK
  • Need to have an AVD image running 2.3.3 (API level 10)
  • You may use any IDE that supports Maven, but this guide currently focuses on the command line.

Setup Maven Android SDK Deployer

We need to have the Android Maven SDK Deployer installed and configured. These are only quickstart instructions, the Android Maven SDK Deployer GitHub has a much more in depth install guide.

You must have the version of the platform installed through the Android SDK as you are using for your profile. In this example, make sure Android 4.1 is installed.

git clone https://github.com/mosabua/maven-android-sdk-deployer.git
cd maven-android-sdk-deployer
export ANDROID_HOME=YOUR_ANDROID_SDK_DIRECTORY
mvn install -P 4.1

Note: During the instalation you might face with some issues like this https://issues.jboss.org/browse/AEROGEAR-951. The workaround is:

cd maven-android-sdk-deployer/extras/

Edit the pom.xml file commenting following modules:

<!-- <module>analytics</module> -->
<!-- <module>admob</module> -->
<!-- <module>google-play-services</module> -->

Now Maven will be able to include Android 4.1 as a dependency. There are also profiles for other version of Android.

Installing aerogear-android

From the command line run the following. This will clone the aerogear-android git repository (thus creating a aerogear-android directory) and then build the library and install it in your local maven repository.

git clone https://github.com/aerogear/aerogear-android.git
cd aerogear-android/
mvn install

If your build fails with "Could not find tool 'aapt'"

Android SDK version r17 broke our Maven build tool, android-maven-plugin. This is a known issue and will be fixed with version 3.7.0 of the tool. However, as a workaround (in Linux and Mac envrionments), you can create a symbolic link to the missing binaries.

If you have Jelly Bean MR1 (API Level 17) installed:

 cd $ANDROID_HOME/platform-tools
 ln -s ../build-tools/android-4.2.2/aapt aapt
 ln -s ../build-tools/android-4.2.2/lib lib
 ln -s ../build-tools/android-4.2.2/aidl aidl

Some installations use a slightly different structure such that the following will work instead:

 cd $ANDROID_HOME/platform-tools
 ln -s ../build-tools/17.0.0/aapt aapt
 ln -s ../build-tools/17.0.0/lib lib
 ln -s ../build-tools/17.0.0/aidl aidl

If you are having troubles feel free to contact us via IRC #aerogear or our mailing list [email protected].