Open Spatial SDK for Android contains:
| Components | Notes |
|---|---|
| SDK Sources | Sources for OpenSpatial SDK APIs |
| OpenSpatialSDK.jar | Used to build applications against the APIs (added for convenience) |
| An example app | Demonstrates how to use the APIs to register and log events |
Sources needed to build the OpenSpatialSDK.jar are in the net.openspatial package. Sources for the example app are in the com.example.openspatial package.
The SDK is distributed under Apache2.0 license (see LICENSE.md).
OpenSpatial SDK sources are built with buck.
- Install Android SDK - instructions
- Install Oracle JDK 7 - instructions
- Install Python 2.7 - instructions
- Install Ant - instructions
- Install git - instructions
- Install buck - instructions
Set the locations of various tools (in the instructions below, replace "path_to_android_sdk" and "path_to_openspatial_sdk" with the actual pathname where you unpacked the Android and OpenSpatial SDKs):
$ export ANDROID_SDK=path_to_android_sdk
$ export PATH=$PATH:$ANDROID_SDK/sdk/platform-tools
$ export OPENSPATIAL_SDK=path_to_openspatial_sdk
After the one time setup, use buck to build the example app.
$ cd $OPENSPATIAL_SDK
$ buck build example
Connect the host computer to the Android device using a USB cable.
To install the example app on an Android device, use the "buck install" or the "adb install" command.
$ buck install example
or
$ adb install buck-out/gen/apps/OpenSpatialExample/OpenSpatialExample.apk
To generate the API documentation, use the command below, modifying the Android API version as needed.
$ javadoc -d release/javadoc -sourcepath src/ -classpath $ANDROID_SDK/platforms/android-18/android.jar net.openspatial
For information on Open Spatial SDK for iOS see (https://github.com/openspatial/iOS-SDK)