Confirmed users
250
edits
Jetpack/Integration Process: Difference between revisions
→Checking changes: mention build files which need to be updated.
(→Checking changes: mention build files which need to be updated.) |
|||
| (25 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
This page | This page includes instructions on updating fx-team with the latest version of the SDK code. | ||
= | = 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/ | hg clone https://hg.mozilla.org/integration/fx-team/ fx-team | ||
cd | cd fx-team/addon-sdk/source | ||
git init | git init | ||
git remote add origin | git remote add origin git@github.com:mozilla/addon-sdk.git | ||
git fetch origin | git fetch origin | ||
git | git checkout -f <i>firefoxXX</i> #where XX is the current version you're uplifting to | ||
This will give you the latest | This will give you the latest fx-team code and update the SDK files to the latest versions from the <i>firefoxXX</i> branch, in some cases that might be newer than those already in fx-team. | ||
= | = Performing the uplift = | ||
cd | == Check for changes requiring uplift to git == | ||
hg pull -u | |||
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 <i>firefoxXX</i> #where XX is the new Firefox version number on fx-team | |||
git push -u origin <i>firefoxXX</i> | |||
This creates a new <i>firefoxXX</i> 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 <i>firefoxXX</i> directly: | |||
git checkout master | |||
git pull origin master | |||
git checkout <i>firefoxXX</i> # XX is the current m-i version number | |||
git merge master | |||
git push origin <i>firefoxXX</i> | |||
== 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 | cd addon-sdk/source | ||
git pull origin integration | git reset --hard <i>firefoxXX</i> # undoes any backouts that happened in hg, XX is current m-i version number | ||
git pull origin <i>firefoxXX</i> | |||
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 [http://trychooser.pub.build.mozilla.org/ 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 == | == Viewing and committing changes == | ||
hg | 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. | |||