Contribute

Revision 5 as of 2013-02-22 07:58:19

Clear message

Warning /!\ Ubuntu Touch is no longer maintained as a core product by Canonical. However, the Ubports community are continuing development.

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, so stay tuned to updates to 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 12.10 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 12.10 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 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.

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 cdimages.ubuntu.com.

Currently the images are built from an internal Jenkins instance and are manually copied to cdimages.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! Ubuntu is the only place for bug filing at the moment, if you do submit bugs against Ubuntu please tag them ubuntu-touch-preview with details about the build you are using and the device you are testing on.

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-phone 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.