IOIO V15

IOIO FOR ANDROID BEGINNER'S GUIDE

Step by step, this tutorial will help you install and configure the software needed to start developing IOIO applications for Android!

While there is already a Beginner's guide on github's IOIO page, the information is quite scattered. The aim of this is to regroup all the needed information into a simple and convenient tutorial to quickly get you developing your first IOIO for Android application! Note: This tutorial involves a lot of downloads and installations, so make sure you have some time ahead of you!

STEP 1: System Requirements

Source: [1]

Supported Operating Systems

• Windows XP (32-bit), Vista (32- or 64-bit), or Windows 7 (32- or 64-bit)
• Mac OS X 10.5.8 or later (x86 only)
• Linux (tested on Ubuntu Linux, Lucid Lynx)
  • GNU C Library (glibc) 2.7 or later is required.
  • On Ubuntu Linux, version 8.04 or later is required.
  • 64-bit distributions must be capable of running 32-bit applications.

For information about how to add support for 32-bit applications,

see the Ubuntu Linux installation notes.

STEP 2: Installing Java Development Kit (JDK)

Get the latest Java SE version on the Java SE download page.

Click on the JDK, accept the license agreement, and download the right Java Development Kit version for your Operating System. Note: if using a 64 bits OS, you must download the 64 bits version.

Follow the installation wizard steps and install all of the components. You don't have to register.

STEP 3:Installing Eclipse IDE

Go to the Eclipse Download Page

While any of those 3 is recommended to develop Android Applications, just take

the Classic version if you're a IOIO beginner.

• Eclipse IDE for Java Developers
• Eclipse Classic
• Eclipse IDE for Java EE Developers

Download Eclipse for your OS.

Eclipse Classic is a standalone program, you don't have to install it. Just put the Eclipse folder wherever you want on your computer, and the "eclipse" executable is the application.

STEP 4: Installing the Android SDK

Source:Setting up an Existing IDE

Go to the SDK download page and download the installer for your OS.

Run the installer and follow the steps.

Troubleshoot: If the installer cannot find your Java SDK and you have the JAVA_HOME variable error, follow these steps.

When the installation finishes, the installer will ask you to run the SDK manager.

Don't, we will go through this step later.

STEP 5: Run Eclipse IDE

This is the easiest step!

Run the "eclipse" application and create a shortcut if you want.Upon first launch, Eclipse will ask you to create a workspace. Think about is as your "My Documents for Eclipse", this is where your projects will be. Set this folder as you please. This can be changed later.

STEP 6: Install the Android Development Tools (ADT) Plugin

source:ADT Plugin

• Start Eclipse, then select Help > Install New Software....

• In the "Work With:" area, click Add, in the top-right corner.

• In the Add Repository dialog that appears, enter "ADT Plugin"

• for the Nameand the following URL for the Location:

Android SDK Plugin for Eclipse

Note: If you have trouble acquiring the plugin, try using "http" in the Location URL, instead of "https" (https is preferred for security reasons).

click OK.

• In the Available Software dialog, select the checkbox next to Developer Tools and

• click Next.

• In the next window, you'll see a list of the tools to be downloaded. Click Next.

• Read and accept the license agreements, then click Finish.

Note: If you get a security warning saying that the authenticity or validity of the software can't be established, click OK.

When the installation completes, restart Eclipse.

Now you have to point the SDK to the Eclipse Plugin.

• Select Window > Preferences to open the Preferences panel

(Mac OS X: Eclipse > Preferences).

• Select Android from the left panel.

• For the SDK Location in the main panel, click Browse...

• locate your downloaded SDK directory.

• Click Apply, then OK

STEP 7: Install Android packages

In Eclipse, do Window > Android SDK Manager

The IOIO libraries need older API versions so you should install them too. You will also be able to make your application compatible with older Android versions.

This procedure will download and install the selected components. There are a few GB, so make sure you have time in front of you

Install the Google USB Driver too.

STEP 8: Create an Android emulator

source: Building Your Frist App

• In Eclipse, select Window > AVD Manager.

• Select Virtual Devices in the left panel.

• Click New....

• The Create New AVD dialog appears.

• Type the name of the AVD, such as "my_avd".

• Choose a target.

The target is the platform (that is, the version of the Android SDK, such as 2.3.3)

you want to run on the emulator.

• For this tutorial, choose the latest platform that you have installed

• Ignore the rest of the fields.

• Click Create AVD

STEP 9: Compile your first IOIO project!

Import the IOIO libraries and examples

Go to the Android Software and IOIO Application Firmware Images download page

and download the latest version.Unzip the files to a safe location.

Time to import the libraries and the IOIO example project!

In Eclipse, do File > Import, and in General, select Existing Projects Into Workspace.

Click Next.

In "Select Root Directory" browse and point to the IOIOLib folder you just unzipped.

Make sure the box is ticked in the "Projects" area and that Copy projects into workspace is also ticked, and click on Finish

Repeat this step for IOIOLibBT and IOIOLibAccessory.

IOIOLib has to be included in every IOIO project as this is the core library.

IOIOLibBT adds Bluetooth support.

Now that you have the libraries, import the Example project!

Repeat the previous steps with the HelloIOIO folder located in the Applications folder

Link the IOIO libraries to the project

In the Package Explorer on the left, right click on HelloIOIO and select Properties In the Android menu, click on Add at the bottom, and add IOIOLib, IOIOLibBT and IOIOLibAccessory.Remove the error lines if needed

You should now have that:

Configure the JAVA compiler

Android applications require the JAVA 1.6 compiler.

Right now you should have this error:

Android requires compiler compliance level 5.0 or 6.0. Found '1.7' instead.

Please use Android Tools > Fix Project Properties If you closed the project properties, open it again.

This time, in the Java Compiler menu, Enable project specific settings and select

the Compiler compliance level: 1.6

Repeat this step for every library and included project