When the code in the
master branch is considered to be stable, a release can be made. This is the procedure:
- Tag the last commit with a version number (in the format
vx, where x is the extension's version number for that release) by running
git tag -a vx -m "vx". Note that the tag should be an annotated tag and not a lightweight tag, and it must be pushed to Gerrit after being created.
- Build the extension for both the stable and beta channels (this is explained in the next section). This will output a ZIP file for each release channel.
- Upload both release files to the Chrome Web Store, one for each release channel.
- Submit both releases to be reviewed by the Chrome Web Store team, but in the case of the stable channel uncheck the "Publish automatically after it has passed review" option.
- Upload the beta release file to the GitHub releases page under the newly created tag. Mark that release as a pre-release at GitHub.
- Wait until the beta release is reviewed and approved by Google.
- Test again the extension by using the beta channel. Check if the options have been transfered correctly from version to version, and wait some days (for instance between 3 and 5 days) to see if other people report issues with the updated version.
- If everything goes well, publish the update in the stable channel. The updated version should have already been reviewed by the Chrome Web Store team at this time.
- Update the release file in the GitHub releases page by removing the beta release file and uploading the stable release file. Also, remove the pre-release label.
If during this process the release wasn't approved by Google or an issue was found during beta testing, a new release which fixes this should be created.
Build the extension
To create a zip file with the contents of the extension, which can be uploaded to the Chrome Web Store, run
bash release.bash. You can also use
bash release.bash --channel=beta to include a beta label in the extension name and version of the resulting zip file.
The ZIP file will contain a manifest.json file with the according version name, and will be located in the
You can also get information about how to use the
release.bash script by running
bash release.bash -h.
To test translations, you might want to set your browser's locale. This section tells you how to set the locale in Windows, Mac OS X, Linux, and Chrome OS.
The beta channel is available here.