Jetpack/Integration Process
This page includes instructions on updating fx-team with the latest version of the SDK code.
Contents
- 1 Setting up the mercurial tree
- 2 Performing the uplift
Setting up the mercurial tree
When you don't yet have a mercurial clone dedicated for doing uplifts do this:
hg clone https://hg.mozilla.org/integration/fx-team/ fx-team cd fx-team/addon-sdk/source git init git remote add origin git@github.com:mozilla/addon-sdk.git git fetch origin git checkout -f firefoxXX #where XX is the current version you're uplifting to
This will give you the latest fx-team code and update the SDK files to the latest versions from the firefoxXX branch, in some cases that might be newer than those already in fx-team.
Performing the uplift
Check for changes requiring uplift to git
Sometimes SDK code is changed directly in mercurial. We have to make sure we aren't clobbering those when we uplift.
- Look at http://hgchanges.fractalbrew.com/fx-team/file/addon-sdk/source and see if there are any non-uplift changesets listed since the last uplift.
- If there are check if they have been uplifted to git yet, there will normally be a comment in the bug from the githubbot.
- If not you need to land the SDK part of that changes into master before doing anything else. Make sure to copy the commit message and author from the original mercurial patch.
Updating the version branches
We track the code uplifted to Firefox in branches in git, one for each version of Firefox. Each week when uplifting we merge master into the release branch for the release it will land in.
If the release branch for the current nightly version doesn't exist (the first week after a merge to aurora) then do this:
From your SDK repository:
# assuming you're merging the head from master: git checkout master git pull origin master git checkout -b firefoxXX #where XX is the new Firefox version number on fx-team git push -u origin firefoxXX
This creates a new firefoxXX branch in git and pushes it to the upstream repository for use. This new branch will track whatever code is in the SDK's folder in mercurial.
Any other week when the branch already exists:
Pick up new changes from the master branch every week or as needed:
# merge master to firefoxXX directly: git checkout master git pull origin master git checkout firefoxXX # XX is the current m-i version number git merge master git push origin firefoxXX
Creating a bug
The first step is to create a bug to track the uplift. It should be in Add-on SDK::General, P1 and contain the list of changes included in the uplift, a github link works well for this. bug 947501 is an example. This should also be used in the commit message, see https://hg.mozilla.org/integration/fx-team/rev/9ece804de146
Updating the SDK code inside mercurial
cd fx-team hg pull -u # updates to the latest version of fx-team cd addon-sdk/source git reset --hard firefoxXX # undoes any backouts that happened in hg, XX is current m-i version number git pull origin firefoxXX cd ../..
Updates the Firefox and SDK files to the latest versions from the integration branch.
Checking changes
After updating the git and hg repositories you should add any new files from git and verify you haven't accidentally changed anything outside the add-on SDK tree. From the fx-team source directory:
hg addremove addon-sdk/source hg status -X addon-sdk/source # Should show no results hg status -ur addon-sdk/source # Should show no results hg status # Shows you all the changes you're about to land
addon-sdk/moz.build
Make sure that the addon-sdk/moz.build file is correct, you can use this script to update it:
./mach generate-addon-sdk-moz-build
This is not a perfect script though, it may have bugs so if you notice something file something.
addon-sdk/source/test/jetpack-package.ini
There is no script to update this at the moment, this is bug 1119600, so updates must be done by hand.
addon-sdk/source/test/addons/jetpack-package.ini
There is no script to update this at the moment, this is bug 1119601, so updates must be done by hand.
Testing changes
Before committing you may want to test your changes by pushing to the try server. You need to have mercurial queues enabled for this to work.
hg qnew -f -e testpatch
Creates a temporary commit that can be pushed to try. Include the output of TryChooser to restrict builds and tests.
hg push -f ssh://hg.mozilla.org/try/
Pushes the temporary commit to the try server, depending on your TryChooser string you should get an email telling you where to look for results.
Failure
If the try push fails, you'll have to investigate why, and make some changes, once you've made some changes, try
hg status
This should show you only the files which you have changed, they should only be changes to the addon-sdk folder normally.
hg addremove addon-sdk
Then, you'll need to update your patch
hg qrefresh -e
You can test that this worked with
hg status
Which should have no results
hg log -l 2
Should show your one patch in a queue, now you may push to try again
hg push -f ssh://hg.mozilla.org/try/
Success
Once you're done the following converts the temporary commit in to a real commit that can be pushed to the project branch:
hg qrefresh -e # Edit the commit message to remove the try: syntax hg qfinish -a
Viewing and committing changes
If you aren't testing the changes on try then you can just commit them:
hg commit
Reverting a local commit
If you made a commit, and the tree you want to push to updates before you are able to push, then you need to revert your local commit and save it as a patch, update your local branch, and then put your patch back on top. This is basically a git rebase.
hg qimport -r tip hg qpop hg pull -u hg qpush testpatch
Now you'll have a queue with one patch, which is the patch you are rebasing.
Finalize the patch when you are ready, before doing this though you may which you push to try again..
hg qfin -a
Now you have a real commit again.
Pushing the changes to the project branch
hg outgoing --stat # Check that only one changeset is listed and it only modifies addon-sdk/source hg push ssh://hg.mozilla.org/integration/fx-team/
Pushes the changes to fx-team.
Backouts
If you missed something when doing your try pushes, then it is likely that you will be backed out, if this happens then repeat the process.