This addon provides some tools to assist developers with remote settings.
- Trigger synchronization manually
- Inspect local data
- Clear local data
- Switch from/to STAGE and PROD
- Load from preview collections
- Pick the .xpi file from the releases page.
- When asked for comnfirmation, select "Continue to installation".
Note: it is highly recommended to use a temporary or development user profile
This addon relies on the Experiments API in order to expose Remote Settings internals to the Web Extension.
Unsigned addons with experiments can only be loaded in Firefox Nightly and Developer Edition, with specific preferences set.
- Download Nightly
- Install dependencies with
npm install
- We'll use the
web-ext
runner, with a persistent profile:
npx web-ext run --verbose --firefox-binary /path/to/nightly/firefox -s extension --firefox-profile rs-devtools --profile-create-if-missing
- (first run only) Adjust preferences in
about:config
:
xpinstall.signatures.required
:false
extensions.experiments.enabled
:true
- Reload the addon to take these prefs changes into account, in
about:debugging
- Enjoy!
- Create a ticket to be added to the VPN group (can clone and edit this Bugzilla ticket)
- Ask in the #addons-pipeline channel to be added to the
XPI_PRIVILEGED_BUILD_GROUP
to get access to create an XPI release forremote-settings-devtools
on Ship-It
- Bump version in
package.json
,update.json
(has three version instances that need to be updated), andextension/manifest.json
- Tag commit
git tag -a X.Y.Z
and push itgit push origin X.Y.Z
- Create release with changelog on GitHub's releases page
- Check that
FirefoxCI
action has run for tagged commit
- Ensure you're connected to the VPN
- Go to Ship-It
- Login with SSO at the top right
- Click
NEW XPI RELEASE
at the top and select the following options:Available XPIs
→remote-settings-devtools
Available revisions
→ revision with the commit hash associated with the tag that's being released
- Ensure the version that was tagged is the one shown
- Select
CREATE RELEASE
→SUBMIT
- Scroll to the bottom of the pending releases page
- Click
Build
on the new release labeledremote-settings-devtools-X.Y.Z-build1
- Submit a sign off request
- Go to XPI Releases
- Click on
Promote task
on the XPI release you want to download the signed binary from, which will take you to Taskcluster - Click on the
release-signing-remote-settings-devtools
task - Click the
Artifacts
dropdown on the right side of the page - Download the artifact named
public/build/remote-settings-devtools.xpi
to your machine - Append
-X.Y.Z
to the end of the filename - Attach
remote-settings-devtools-X.Y.Z.xpi
signed binary file to the corresponding GitHub release
Additional information may be found here.