Skip to content

Instructions for sideloading on Firefox for Android - #2036

Merged
rebloor merged 5 commits into
mozilla:masterfrom
rebloor:Sideload-to-Firefox-for-Android
Apr 25, 2025
Merged

rebloor merged 5 commits into
mozilla:masterfrom
rebloor:Sideload-to-Firefox-for-Android

Conversation

@rebloor

@rebloor rebloor commented Mar 19, 2025

Copy link
Copy Markdown
Collaborator
  • Removes the term sideloading (and replaces with "manual installation")
  • Adds instructions to the (now) installing self-distributed add-ons page on how to activate and use Install Extension from File on Firefox for Android.
  • Completed various minor edits to the affected pages.

Fixes #2028

@rebloor
rebloor requested review from dotproto and willdurand March 19, 2025 01:44
@rebloor rebloor self-assigned this Mar 19, 2025

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The naming of this article is unfortunate as this term has a specific meaning. As described in Support for extension sideloading has ended, "sideloading" generally refers to an installation method where installing an application on your system would also result in adding and extension to Firefox.

The "Installation using the standard extension folders" section does call out that this feature is no longer supported, but the intro still seems to suggest it is supported.

@rebloor rebloor Mar 22, 2025

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@dotproto Isn't sideloading a general term meaning "installing applications or software on a device from sources other than the official app store or distribution channels, bypassing the usual vetting process"? The feature removed was the ability to sideload "without the user taking an action."

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@dotproto I have revisited and removed the information about installing with an app. Given this was removed five years ago, there seems a little point in including the documentation.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree we should not use "sideloading" here. Install from file is not sideloading, it's manual install if you want, and it's official. Just like we have install from file in about:addons.


::: note
No automatic updates will be performed for add-ons installed using these methods. You will have to deliver a new XPI file to your user for each update. However, automatic compatibility checks are still performed.
No automatic updates are performed for add-ons installed using these methods. You have to deliver a new XPI file to your user for each update. However, automatic compatibility checks are performed.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think this is accurate. I tried walking through extensions source files on searchfox but I didn't see anything that suggested updates are handled different based on installation method.

@willdurand, can you confirm?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@dotproto after reviewing the documentation, I believe this statement was actually intended to refer to extensions offered as a beta update release to a listed extension. I've updated the note.

## Install add-on from file on a computer

To use Install Add-on From File in Add-on Manager, send the user the signed add-on with the following instructions:
To sideload an add-on in desktop Firefox, send the user the signed add-on with these instructions:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should avoid the term "sideload" here as that has a more specific meaning.

Suggested change
To sideload an add-on in desktop Firefox, send the user the signed add-on with these instructions:
To install an add-on from a file in desktop Firefox, send the user the signed add-on with these instructions:

@rebloor
rebloor requested a review from dotproto March 24, 2025 15:49
@rebloor

rebloor commented Apr 5, 2025

Copy link
Copy Markdown
Collaborator Author

@dotproto @willdurand I have now adjusted the content to remove the term sideloading. I've also renamed the page's md file and created #2045 for the introduction of a redirect.

@dotproto dotproto left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approving as I only have a pair of nits and they're not worth blocking the PR over.

Comment thread src/content/documentation/publish/install-self-distributed.md Outdated
Comment thread src/content/documentation/publish/self-distribution.md Outdated
Co-authored-by: Simeon Vincent <svincent@gmail.com>
@rebloor
rebloor merged commit 0fecb3c into mozilla:master Apr 25, 2025
@rebloor
rebloor deleted the Sideload-to-Firefox-for-Android branch April 25, 2025 18:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

"Self Distribution" page should state that Android cannot directly install self-distributed extensions

3 participants