Get advancedmap3d to start

AdvancedMap3D sample application has number of dependencies, and it is not just plug-and-play project. You can choose whether you want to use Maven for dependency management, or just use it without Maven.

No Maven

If you are new to Maven, and just want to get it running, then skipping Maven installation hurdles could be good option. AdvancedMap from start to end should work as:

1. download and install Android Development Tools package (ADT) from http://developer.android.com/sdk/index.html
2. select Import > GIT project, enter URI https://github.com/nutiteq/hellomap3d.git
3. Select project: AdvancedMap3D, master branch.
4. Add android-support-v4.jar as external library to the project. See http://stackoverflow.com/questions/18299898/the-import-android-support-cannot-be-resolved for a guide
5. if asked, select the highest Android API version what you have installed. Suggested are 4.0 and newer ones
6. Start the app

With Maven

If you have not installed any Maven tools, then following steps should get you started:

1. same as 1.-3. above
2. install Maven 3.0.5 from http://maven.apache.org/download.html
3. install m2e plugin to Eclipse. Select Eclipse update site, search m2e.
4. Configure Maven environment variables. my .bash_profile in Mac is following:

export M2_HOME=/Users/jaak/Downloads/apache-maven-3.0.5
export PATH=$PATH:$M2_HOME/bin
export ANDROID_HOME=/Users/jaak/Downloads/adt-bundle-mac-x86_64-20131030/sdk
export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools 

4. test build from command-line. In project folder run

    mvn clean install

5. Configure SDK path for maven. You can set it via environment, but for Eclipse safest should be to create .m2/settings.xml to your home folder as instructed in in http://stackoverflow.com/questions/19133913/maven-android-pluginno-android-sdk-path-could-be-found

p.s. Some version combinations of Maven might not build on OSX. According to https://code.google.com/p/maven-android-plugin/issues/detail?id=395 should install older Maven version 3.0.5 instead of 3.1.1