User Tools

Site Tools


doc:crazyflie:dev:env:android

Setting up an development environment for the Crazyflie Android client

This guide will help you getting started with setting up a development environment for the Crazyflie Android client, running the app from source code and contributing code.

Installation

Requirements

  • An Android device running version 4.0 or higher (the code might be changed to run on lower versions, but this has not been tested yet)
  • USB On-the-go (OTG) cable (aka. USB Host cable) to connect the Android device to the Crazyradio dongle

Installing the Android Development Tools (ADT)

  1. Download the most recent Android Development Tools from http://developer.android.com/sdk/index.html
    • get the latest ADT Bundle (eg. adt-bundle-windows-x86-20130917.zip for Win32)
  2. Extract the zip file and start Eclipse (adt-bundle-windows-x86-20130917/eclipse/eclipse.exe)
  3. Start the Android SDK Manager (Window → Android SDK Manager)
    • select Android 4.0 (API 14) and install all of its components
    • using an actual Android device for development is recommended
    • If you still want to use the emulator for development on a Windows machine, then you should use the “Intel x86 Atom System Image”.
      (Make sure that you use the Intel x86 Emulator Accelerator (HAXM) when your machine support the VT-x extension. This speeds up the emulator considerably.)

If you have problems installing the ADT environment or setting up the emulator you might find some help here:

Getting the Crazyflie Android client source code

  1. Install a Git client for your operating system
    • Windows client from http://msysgit.github.io
    • Linux client, e.g. on Debian based systems with “sudo apt-get install git”
  2. The Eclipse Git plug-in (EGit) is already included in your ADT environment, but you should update it to the latest version
  3. With the EGit plug-in you can checkout the Crazyflie Android client source code from https://github.com/bitcraze/crazyflie-android-client.git
    • or on the commandline:
      git clone https://github.com/bitcraze/crazyflie-android-client.git

Running the Android client from source code

  1. On Windows: install USB drivers for your Android device (http://developer.android.com/tools/extras/oem-usb.html)
  2. Enable USB debugging on your Android device (Settings > Developer options)
    • You might need to enable the developer options first!
  3. Connect your PC to the Android device via USB or Wifi
  4. “Run as Android application” (this deploys and installs the APK to your Android device)
  5. Use a USB On-the-go (OTG) cable (aka. USB Host cable) to connect your Android device to the Crazyradio dongle
  6. Run the Crazyflie app (see also Crazyflie Android client user guide)

More info about USB drivers, developer options and debugging setup can be found here:

Reporting bugs or requesting features

Bugs and feature requests should be added as GitHub issues: https://github.com/bitcraze/crazyflie-android-client/issues

Contributing your code

If you consider contributing code, then you should create a Github account, fork the crazyflie-android-client repository and send a pull request.

Coding standard

Due to a lack of time and laziness the code is still messy, but in general the coding style should follow the Android Code Style Guidelines for Contributors.

doc/crazyflie/dev/env/android.txt · Last modified: 2015-07-15 16:31 (external edit)