Skip to content

Instructions for sideloading on Firefox for Android #2036

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 4 commits into
base: master
Choose a base branch
from

Conversation

rebloor
Copy link
Collaborator

@rebloor rebloor commented Mar 19, 2025

  • 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 willdurand and dotproto March 19, 2025 01:44
@rebloor rebloor self-assigned this Mar 19, 2025
Copy link
Collaborator

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.

Copy link
Collaborator Author

@rebloor rebloor Mar 22, 2025

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
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
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.

- Adding the file to one of the standard extension folders.

::: 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
Collaborator

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
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.


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
Collaborator

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
Copy link
Collaborator Author

rebloor commented Apr 5, 2025

@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.

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