Installation

How do I install DroydSDK and run a sample application on my computer?

Basically, the Droyd SDK archive contains the following files:

  • Droyd SDK libraries: the native DroydSDK C++ library named "libMicroMapJNI-arm.so" and the Java jar file named "DroydSDK-Android-x.y.z.jar".
    In order to develop your own Android application based on DroydSDK you just need these two libraries.
  • Assets: required resource files
  • Documentation:  Java API documentation (JavaDoc format)
  • Examples: Some sample applications

However, to make your life easier we've created a full Eclipse project which includes a simple demo application located in the subfolder samples. Follow the steps below to build the DroydSDK demo application in your environment:

Installation Instructions:
  1. Download the DroydSDK zip file from this place and save the archive to a temporary folder on your disk, e.g. "/home/john/downloads"
  2. Unpack the archive file into your Eclipse workspace, e.g. "/home/john/workspace". Afterwards you will see a new subfolder named DroydSDK-Android-x.y.z
  3. Copy the folders assets and lib into your samples directory samples/DroydSDKDemo
  4. Since these two libraries are required for any DroydSDK application you need to repeat this step for every of your project.
  5. In Eclipse, follow the following steps to import the prepared folder as a new project:
    • Choose File -> Import -> General -> Existing Project into Workspace
    • Select "samples/DroydSDKDemo/" as root directory
    • Click on "Finish" to import the DroydSDK project into your Eclipse workspace
    • Finally check if the project compiles properly
    • You will see a new project called "DroydSDKDemo" which you can compile and run, either on an emulator or real device
  6. Copy some sample map data into "/sdcard/DroydSDKDemo" on your device's external storage folder.
  7. Droyd SDk runs on Android 1.5 an higher
  8. You can change the map theme by menue

Now you can proceed to section Sample Maps to download and install sample maps.