avm99963 | bf0849a | 2020-08-08 16:16:04 +0200 | [diff] [blame^] | 1 | # TW Power Tools |
avm99963 | 03d5409 | 2020-01-18 21:33:16 +0100 | [diff] [blame] | 2 | [](https://chrome.google.com/webstore/detail/infinite-scroll-in-tw/hpgakoecmgibigdbnljgecablpipbajb) |
| 3 | |
avm99963 | bf0849a | 2020-08-08 16:16:04 +0200 | [diff] [blame^] | 4 | An extension which brings several enhancements to the Google Forums and the Community Console. |
| 5 | |
avm99963 | 666575f | 2020-08-08 15:40:39 +0200 | [diff] [blame] | 6 | ## Release cycle |
| 7 | When the code in the `master` branch is considered to be stable, a release can be made. This is the procedure: |
| 8 | |
| 9 | 1. Tag the last commit with a version number (in the format `vx`, where x is the extension's [version number](https://developer.chrome.com/extensions/manifest/version) 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. |
| 10 | 2. 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. |
| 11 | 3. [Upload both release files](https://developer.chrome.com/webstore/publish#upload-your-item) to the Chrome Web Store, one for each release channel. |
| 12 | 4. [Submit both releases](https://developer.chrome.com/webstore/publish#submit-your-item-for-publishing) 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. |
| 13 | 5. Upload the beta release file to the [GitHub releases page](https://github.com/avm99963/infinitegforums/releases) under the newly created tag. Mark that release as a pre-release at GitHub. |
| 14 | 6. Wait until the beta release is reviewed and approved by Google. |
| 15 | 7. 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. |
| 16 | 8. 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. |
| 17 | 9. 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. |
| 18 | |
| 19 | 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. |
| 20 | |
| 21 | ## Build the extension |
Alex Ivanov | 0da24a3 | 2020-04-10 09:41:08 +0300 | [diff] [blame] | 22 | 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. |
avm99963 | 03d5409 | 2020-01-18 21:33:16 +0100 | [diff] [blame] | 23 | |
avm99963 | 666575f | 2020-08-08 15:40:39 +0200 | [diff] [blame] | 24 | The ZIP file will contain a manifest.json file with the according version name, and will be located in the `out` folder. |
| 25 | |
| 26 | You can also get information about how to use the `release.bash` script by running `bash release.bash -h`. |
avm99963 | 03d5409 | 2020-01-18 21:33:16 +0100 | [diff] [blame] | 27 | |
Alex Ivanov | 4f3df18 | 2020-04-10 09:33:05 +0300 | [diff] [blame] | 28 | ## Testing notes |
Alex Ivanov | 4f3df18 | 2020-04-10 09:33:05 +0300 | [diff] [blame] | 29 | To test translations, you might want to set your browser's locale. This section tells you how to set the locale in [Windows](https://developer.chrome.com/extensions/i18n#testing-win), [Mac OS X](https://developer.chrome.com/extensions/i18n#testing-mac), [Linux](https://developer.chrome.com/extensions/i18n#testing-linux), and [Chrome OS](https://developer.chrome.com/extensions/i18n#testing-chromeos). |
avm99963 | 666575f | 2020-08-08 15:40:39 +0200 | [diff] [blame] | 30 | |
| 31 | ## Beta channel |
| 32 | The beta channel is available [here](https://chrome.google.com/webstore/detail/infinite-scroll-in-tw-bet/memmklnkkhifmflmidnflfcdepamljef). |