From 8507ddd06e033ed70c03c3b0270388993b07a04c Mon Sep 17 00:00:00 2001 From: Simeon Vincent Date: Wed, 21 Aug 2024 16:02:50 -0700 Subject: [PATCH] Revise MV2 ID requirement note --- .../develop/extensions-and-the-add-on-id.md | 9 +++++---- .../publish/signing-and-distribution-overview.md | 6 +++--- 2 files changed, 8 insertions(+), 7 deletions(-) diff --git a/src/content/documentation/develop/extensions-and-the-add-on-id.md b/src/content/documentation/develop/extensions-and-the-add-on-id.md index 66f66f21..fa9e8434 100644 --- a/src/content/documentation/develop/extensions-and-the-add-on-id.md +++ b/src/content/documentation/develop/extensions-and-the-add-on-id.md @@ -22,10 +22,11 @@ contributors: wbamberg, willdurand, djbrown, - kirinokirino + kirinokirino, + dotproto ] -last_updated_by: kirinokirino -date: 2023-10-28 +last_updated_by: dotproto +date: 2024-08-21 --- @@ -61,7 +62,7 @@ For Manifest V2 extensions, you need to add an add-on ID when: - You want to install an unsigned add-on from its XPI file, rather than loading it temporarily using `about:debugging`. - You want a specific ID, rather than one randomly generated when [your extension is first signed](/documentation/publish/#get-your-extension-signed). -- You use [AMO's API](https://addons-server.readthedocs.io/en/latest/topics/api/v4_frozen/signing.html) for uploading your add-on, rather than uploading it manually on its page, you must include the add-on's ID in the request. +- You use [AMO's API](https://addons-server.readthedocs.io/en/latest/topics/api/v4_frozen/signing.html) or the [web-ext](/documentation/develop/getting-started-with-web-ext/) CLI tool when submitting updates to AMO. - You use WebExtension APIs that use the add-on ID and expect it to be the same from one browser session to the next. If you use these APIs, you must explicitly set the ID using the [`browser_specific_settings`](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_specific_settings) key. This applies to the following APIs: - [`storage.managed`](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/API/storage/managed "A storage.StorageArea object that represents the managed storage area. Items in managed storage are set by the domain administrator or other native applications installed on user's computer, and are read-only for the extension. Trying to modify this storage area results in an error.") - [`storage.sync`](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/API/storage/sync 'Represents the sync storage area. Items in sync storage are synced by the browser, and are available across all instances of that browser that the user is logged into (e.g. via Firefox sync, or a Google account), across different devices.') diff --git a/src/content/documentation/publish/signing-and-distribution-overview.md b/src/content/documentation/publish/signing-and-distribution-overview.md index 556c39eb..3720e06c 100644 --- a/src/content/documentation/publish/signing-and-distribution-overview.md +++ b/src/content/documentation/publish/signing-and-distribution-overview.md @@ -38,7 +38,7 @@ contributors: dotproto ] last_updated_by: dotproto -date: 2024-06-26 +date: 2024-08-21 --- @@ -77,7 +77,7 @@ Mozilla signs add-ons through [addons.mozilla.org](https://addons.mozilla.org). | Signing method | Supported distribution channel(s) | | ------------------------------------- | ------------------- | | Web upload via the [AMO Developer Hub](https://addons.mozilla.org/developers/) | Public listing on AMO or self-distribution (unlisted). | -| Upload using [`web-ext sign`](https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#web-ext-sign) | **Version 8 and higher**: Public listing on AMO or self-distribution (unlisted).

**Version 7 and lower**: Initial submissions only provide for self-distributed (unlisted) extensions. Updates can be for extensions listed on AMO or self-distributed (unlisted). | +| Upload using [`web-ext sign`](https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#web-ext-sign) | **Version 8 and higher**: Public listing on AMO or self-distribution (unlisted).

**Version 7 and lower**: Initial submissions only provide for self-distributed (unlisted) extensions. Updates can be for extensions listed on AMO or self-distributed (unlisted). | | The AMO [Add-on Create API (V5)](https://mozilla.github.io/addons-server/topics/api/addons.html#create) and [Version Create API (V5)](https://mozilla.github.io/addons-server/topics/api/addons.html#version-create) | Public listing on AMO or self-distribution (unlisted). | | The AMO [Signing API (V4)](https://addons-server.readthedocs.io/en/latest/topics/api/v4_frozen/signing.html) | Initial submissions only provide for self-distributed (unlisted) extensions. Updates can be to extensions publicly listed on AMO or self-distributed (unlisted). | @@ -115,7 +115,7 @@ For more information on how to submit an add-on for distribution on AMO or self- ### Self-distribution Self-distributed add-ons are sometimes referred to as “unlisted” extensions because they cannot be publicly viewed or installed from AMO. You may want to self-distribute your extension if it is a beta version or if it is intended to be used by a limited audience. All add-ons, including self-distributed ones, are subject to be manually reviewed at any time after submission to check for compliance with the [Add-on Policies](/documentation/publish/add-on-policies/). -If you choose this method, be sure to read the article on [self-distribution](/documentation/publish/self-distribution/) to learn how users can install self-distributed add-ons and how to push automatic updates to your users. +If you choose this method, be sure to read the article on [self-distribution](/documentation/publish/self-distribution/) to learn how users can install self-distributed add-ons and how to push automatic updates to your users. {% endcapture %} {% include modules/one-column.liquid,