This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
doc:crazyflie:dev:env:android [2014-04-09 00:50] fred [Contributing your code] |
doc:crazyflie:dev:env:android [2015-01-29 14:05] macke Page moved and renamed from projects:crazyflie:android_client:dev_guide to doc:crazyflie:dev:env:android |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== 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) ==== | ||
- | - Download the most recent Android Development Tools from http:// | ||
- | * get the latest ADT Bundle (eg. adt-bundle-windows-x86-20130917.zip for Win32) | ||
- | - Extract the zip file and start Eclipse (adt-bundle-windows-x86-20130917/ | ||
- | - 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" | ||
- | |||
- | If you have problems installing the ADT environment or setting up the emulator you might find some help here: | ||
- | * http:// | ||
- | * http:// | ||
- | * http:// | ||
- | * http:// | ||
- | |||
- | ==== Getting the Crazyflie Android client source code ==== | ||
- | - Install a Git client for your operating system | ||
- | * Windows client from http:// | ||
- | * Linux client, e.g. on Debian based systems with "sudo apt-get install git" | ||
- | - The Eclipse Git plug-in (EGit) is already included in your ADT environment, | ||
- | * Use the Update manager (Help -> Install new software...) | ||
- | * Update site: http:// | ||
- | - With the EGit plug-in you can checkout the Crazyflie Android client source code from https:// | ||
- | * or on the commandline: | ||
- | |||
- | ==== Running the Android client from source code ==== | ||
- | - On Windows: install USB drivers for your Android device (http:// | ||
- | - Enable USB debugging on your Android device (Settings > Developer options) | ||
- | * You might need to enable the developer options first! | ||
- | - Connect your PC to the Android device via USB or Wifi | ||
- | - "Run as Android application" | ||
- | - Use a USB On-the-go (OTG) cable (aka. USB Host cable) to connect your Android device to the Crazyradio dongle | ||
- | - Run the Crazyflie app (see also [[projects: | ||
- | |||
- | More info about USB drivers, developer options and debugging setup can be found here: | ||
- | * http:// | ||
- | |||
- | ===== Reporting bugs or requesting features ==== | ||
- | Bugs and feature requests should be added as Bitbucket issues: https:// | ||
- | |||
- | ===== Contributing your code ==== | ||
- | If you consider contributing code, then you should create a [[https:// | ||
- | |||
- | ==== Coding standard ==== | ||
- | Due to a lack of time and laziness the code is still messy, but in general the coding style should follow the [[http:// | ||
- | |||
- | * [[http:// | ||
- | * [[http:// | ||