You will need to run an OpenTreeMap server to use the Android app. If you do not have an OpenTreeMap development environment, you can use the otm-vagrant project to get started.
-
This project uses RetroLambda to support Java-8 Lambdas on Android, which requires JDK8:
- Install JDK8 (If you are running Ubuntu, see here)
-
download Android Studio
-
unzip it wherever you want
-
Using the SDK Manager, install necessary software:
- From Extras, install:
Google Play servicesGoogle RepositoryAndroid Support Repository
- For all the SDK versions that you will use, (currently API 10, API 16, API [latest]), grab:
SDK PlatformGoogle APIs(ARM if there's a choice)System Image(if you are using an emulator)
- From Extras, install:
You'll need to setup your device for debugging, because emulators aren't really viable. Follow these instructions: http://developer.android.com/tools/device.html
-
clone the OpenTreeMap_Android repo to wherever you store code
-
Put the appropriate values into the templates in OpenTreeMapSkinned (for more information, see the OpenTreeMapSkinned README)
-
Setup google maps API key. See Google's documentation for help in doing so. Set this key as the
google_maps_api_keyin thedefaults.xmltemplate in the OpenTreeMapSkinned project.
If your debug.keystore is not generated, you probably won't be able to run the keytool command. When you first try to run the OpenTreeMapSkinned project, Android Studio should create a debug.keystore if you do not already have one.
Portions of OpenTreeMap are based upon work supported by the National Institute of Food and Agriculture, U.S. Department of Agriculture, under Agreement No. 2010-33610-20937, 2011-33610-30511, 2011-33610-30862 and 2012-33610-19997 of the Small Business Innovation Research Grants Program. Any opinions, findings, and conclusions, or recommendations expressed on the OpenTreeMap website are those of Azavea and do not necessarily reflect the view of the U.S. Department of Agriculture.