Contribute to development of Ubuntu on mobile devices. Join us and be part of the revolution!

If you want to port the Touch Developer Preview to other devices than those currently supported, Friday, 22nd February 2013 we are going to kick off the Ubuntu Touch Port-A-Thon, be sure to check out our Porting guide.

The following sections describe how to the code and infrastructure for the Touch Preview is currently published and used.

Code overview

The Touch Developer Preview is currently built from Ubuntu 13.04 combined with some modified and new packages and some Android components to enable specific devices. In the coming weeks development will start being based on the current Ubuntu development version, codenamed Raring Ringtail.

Source code

The Touch Developer Preview currently consists of a collection of open source projects in Launchpad and an Android layer.

Ubuntu code

Some Ubuntu 13.04 packages are unmodified, and their source code is found directly in the Ubuntu archive. Contributions should follow the usual patch submission guidelines for these packages.

New software and packages are developed in using the Bazaar distributed version control system, in various Launchpad sub-projects from the Ubuntu Touch Developer Preview project group. The Ubuntu Touch Developer Preview project group provides a list of those projects used to build the preview. From there you can easily find the code and everything else.

To hack on these system apps, you can pick the one you're interested in from the list, check out the code using Bazaar and submit a merge proposal in Launchpad.

Android layer

You can find all the needed Android code on the Android layer's public git repositories. This is essentially a mirror of CyanogenMod 10.1, but containing only the needed low level services used by Android (e.g. no Dalvik at all).

For any Android related project at our git server, you'll find a branch named phablet-10.1. This branch contains a static known git HEAD and the required changes needed for Ubuntu, including our custom Android manifest.

A porting guide for adapting this layer to other devices is coming soon; stay tuned!

Image building

Building and publishing Touch Preview images

Images are currently built in the Canonical data center and they are based on quantal. Over the next days all necessary changes for Ubuntu Touch are going to go into Ubuntu raring and images will be built using raring as a basis. They will be published on cdimage.ubuntu.com.

Currently the images are built from an internal Jenkins instance and are manually copied to cdimage.ubuntu.com. In the next few days, we'll be working on moving away from this internal instance and fully automate the build process.

If you have any questions about the images or would like to get images added, ask us on the mailing list.

The upcoming Porting Guide will contain more information about this.

How to report bugs

We expect a large amount of feedback and will do our best to go through it!

For general bugs, please use https://bugs.launchpad.net/touch-preview-images/+filebug to open a new bug. Make sure you include the /system/quantal-ubuntu_stamp file and the output of

adb shell getprop ro.cm.device

otherwise your bug will very likely be useless. If possible, also include the steps to reproduce, an automated testcase (if possible) and the frequency of the bug. Generally, please try to do your best to make sure you put enough information so we can track the hardware and build.

However, if you have bugs which concern the image tools (phablet-tools), bug tracking is open and bugs are welcome; go to https://bugs.launchpad.net/phablet-tools/+filebug to open a new bug.

If you want to help out with triaging bugs, that's great. Ask on IRC or the mailing list if you're unsure. We've got to work all together on this to make Ubuntu Touch truly rock!

Where to discuss

If you got lost somewhere, you found a bug or need some help, we're happy to help you. Ubuntu Touch is put together by a community of many, who are eager to work together with you on this.

Simply:

• Join us on IRC in #ubuntu-touch on irc.freenode.net and/or

• Join our mailing list by

  1. Joining the ubuntu-phone team on Launchpad and

  2. leaving the "Subscribe me to the team's mailing list" option checked.