docs:bosp:android_build

Building BarbequeRTRM for Android

The BarbequeRTRM has been ported to run natively on Android devices. For the time being we are still missing a full stack integration, i.e. it is not possible to access the framework directly from Java coded application. However, this initial porting is just enough to start testing the framework on this environment.

Before starting the compilation you should have a complete and updated local repository of the BOSP source trees. This can be easily done by following the steps described in Getting the BarbequeRTRM Sources. This tutorial assumes that you already compiled BOSP to run on your machine and that you are quite confident with the framework usage. If this is not your case, please come back to this page once you completed the steps described in Compiling the BOSP Sources and Running the BarbequeRTRM.

Pre-requisites

In addition to what is required for a successful BOSP build, you need a local installation of the Android SDK. This guide assumes that it has been installed under /opt/android_sdk. To download and install the Android SDK please refers to the official Get the Android SDK page.

Configuration

Make sure to start from a clean BOSP installation:

$ make distclean

Now you can start the KConfig tool to properly setup your “Android build”.

$ make menuconfig

Make sure to select Android (ARM) - P2012 Device as Target platform and to enable this option:

Barbeqeue => Use Test Platform Data (TPD)

Probably you don't have a P2012 many-core enabled Android device, thus you need to enable the TPD in order to run the BarbequeRTRM framework on a generic Android device, e.g. the SDK emulator.

Regarding applications you should enable just the bbque-testapp, which is just enough to test the framework on Android:

Applications => bbque-testapp

Finally you have to configure the deployment of the framework on the target Android device. This could be done under the Deployment menu. The default configuration is to install all the compilation products under /data/bosp, this is a suitable option for installation both on the Android emulator as well as most of real devices.

The BOSP building system is able to build an update.zip installation package, ready to be deployed on the target device. To build such a package, ensure to select

Deployment => Build installation package

This is not only an option but also a submenu, which should be entered to properly configure the building and deployment of the installation package. Under this menu, enable the Apply update.zip option if you want that the BOSP building system installs the package into the target device once it has been built.

To successfully install the package you need to configure the folder where your Android SDK has been installed, by properly setting this option

Deployment => Build installation package => Apply update.zip => Android SDK

Save and exit the configuration menu. Now you are ready to run the building and installation of BarbequeRTRM with this command:

$ make

Before starting the compilation, make sure to have either a device connected with ADB support enabled or the SDK provided Android emulator running.

Here is a screencast which shows all these steps and how to start both the BarbequeRTRM and the bbque-testapp using the Andoid emulator:

Regarding this screencast, ignore all the steps which are related to the STHORM platform, look just at the options described in the previous sections.

docs/bosp/android_build.txt · Last modified: 2012/08/01 19:08 by derkling

Page Tools