Development

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
• USB On-the-go (OTG) cable (aka. USB Host cable) to connect the Android device to the Crazyradio dongle

Installing Android Studio

1. Download the most recent Android Studio version for your platform from https://developer.android.com/studio/index.html
2. Start the Android SDK Manager (Tools → Android → SDK Manager)
   • install the latest Android SDK and SDK tools

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

• https://developer.android.com/studio/intro/update.html
• https://developer.android.com/studio/run/managing-avds.html
• https://developer.android.com/studio/run/device.html

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. Checkout the Crazyflie Android client
   • 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 (https://developer.android.com/studio/run/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 CrazyflieControl (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:

• https://developer.android.com/studio/run/device.html

Reporting bugs or requesting features

Bugs and feature requests should be added as GitHub 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.

• Use spaces for indentation
• Follow field naming conventions (this is not consistently used yet)