DevelopmentGuide

Differences between revisions 2 and 5 (spanning 3 versions)
Revision 2 as of 2013-01-29 17:19:58
Size: 2025
Editor: 99-41-167-234
Comment:
Revision 5 as of 2013-02-01 04:01:48
Size: 2261
Editor: mhall119
Comment:
Deletions are marked like this. Additions are marked like this.
Line 10: Line 10:
 * Sign the Contributor Agreement - email kevin.wright@canonical.com for details - we need to ask folks to sign this as many carriers and handset manufacturers require specific license agreements, and this allows us to dual-license the code between both a a fully Free Software license and a license that might be required for a handset manufacturer or operator.  * Sign the [[https://forms.canonical.com/contributor|Contributor Agreement]] - email kevin.wright@canonical.com for details - we need to ask folks to sign this as many carriers and handset manufacturers require specific license agreements, and this allows us to dual-license the code between both a a fully Free Software license and a license that might be required for a handset manufacturer or operator.
Line 14: Line 14:
Here is how you get started. If you have any questions, feel free to email kevin.wright@canonical.com. Here is how you get started. If you have any questions, feel free to email [[LaunchpadHome:kevin-wright-1|Kevin Wright]]
Line 16: Line 16:
== Join The Mailing List == === Join The Mailing List ===
Line 28: Line 28:
== Getting The Code == === Getting The Code ===
Line 30: Line 30:
To get the code, go to the wiki page for the app you are interested in and click the ''Code'' link. You can then see how to branch the code. To get the code, go to the wiki page for the app you are interested in and click the ''Launchpad Project'' link. You can then see how to branch the code.
Line 38: Line 38:
== Coordinating What To Work On == === Using Bzr ===

=== Using Launchpad ===

== For Developers ==
Line 56: Line 60:
== Reviewing Branches == === Contributing Your Branch ===

how to upload the branch to LP and then submit a merge proposal

== For the Project Team ==

=== Reviewing Branches ===
Line 60: Line 70:
== Contributing Your Branch == === Triaging Bugs ===
Line 62: Line 72:
how to upload the branch to LP and then submit a merge proposal how to manage bug reports and get them ready for developers

Development Guide

Before Your Start

There are a few things you should do before you start hacking:

  • Download and install the SDK from http://developer.ubuntu.com - you should also run through the tutorial to get acquainted with the technology.

  • Sign the Contributor Agreement - email kevin.wright@canonical.com for details - we need to ask folks to sign this as many carriers and handset manufacturers require specific license agreements, and this allows us to dual-license the code between both a a fully Free Software license and a license that might be required for a handset manufacturer or operator.

Getting Started

Here is how you get started. If you have any questions, feel free to email Kevin Wright

Join The Mailing List

You should first join the ubuntu-phone mailing list. To do this, head over to https://launchpad.net/~ubuntu-phone and join the list. You can see the list archives at https://lists.launchpad.net/ubuntu-phone/

When sending emails to the list, please put app name from the Launchpad project in square brackets in your subject line. As an example, for the Calendar app:

[ubuntu-calendar-app] My subject title

This helps us to filter the list better.

Getting The Code

To get the code, go to the wiki page for the app you are interested in and click the Launchpad Project link. You can then see how to branch the code.

For example, for the calendar you run:

bzr branch lp:ubuntu-calendar-app 

Using Bzr

Using Launchpad

For Developers

Feature Development

join meetings

coordinate features in meetings and on the list

use blueprints to track this work

Fixing Bugs

find the bugs list

assign the bug to you

fix the bug and submit as a merge proposal

Contributing Your Branch

how to upload the branch to LP and then submit a merge proposal

For the Project Team

Reviewing Branches

how to review someone elses branch

Triaging Bugs

how to manage bug reports and get them ready for developers

Touch/CoreApps/DevelopmentGuide (last edited 2014-06-05 12:10:08 by popey)