index.rst (3424B)
1 ===================== 2 Desktop Launcher app 3 ===================== 4 5 A substantial number of users will upgrade to Windows 11 in a way that leaves no trace of Firefox on their device. To address these cases we will leave 6 an install entry point in their personal files, which will migrate at a higher rate than the app itself. In particular, files in the Desktop folder are 7 backed up by OneDrive and other cloud storage products, and likely to find their way back onto a new device. 8 9 This app acts as a replacement for the desktop shortcut to Firefox. 10 11 When Firefox is installed on the user's machine, when the user launches this app, it finds the path to Firefox in the appropriate Windows Registry keys 12 and attempts to launch Firefox from that path. 13 14 When there is no Firefox installation found, this app will attempt to download and run the Firefox "stub" installer. 15 16 As a final fallback, this app will open the Firefox download URL in the default browser. 17 18 19 What controls whether or not Desktop Launcher is installed? 20 =========================================================== 21 22 At installation time: 23 24 - What kind of installer is this? 25 - Stub: install the launcher, do not install shortcuts 26 - Full: Let the user decide whether to get launcher, shortcuts, both, or neither. (Currently the full installer can only select to install the launcher 27 using a command-line parameter. Eventually, there will be UI in the full installer. Work tracked by https://bugzilla.mozilla.org/show_bug.cgi?id=1981597) 28 - Other (MSI, MSIX, zip): install shortcuts 29 30 At update time: 31 - YES: Does this user already have the launcher installed? 32 - YES: Then update it with the new version. 33 - NO: Is this a stub-installed package? (This is stored in `installation_telemetry.json`, see e.g. [BrowserUsageTelemetry.sys.mjs](https://searchfox.org/firefox-main/rev/cd6acbe9eaa55fb4da4fbdec275db6eddd4833b8/browser/modules/BrowserUsageTelemetry.sys.mjs#1875-1904)) 34 - NO: Do nothing 35 - NO: Did we already install the launcher for the user? 36 - YES: Don't install. This is how we avoid re-installing the launcher after a user has removed it. 37 - NO: Does the user have a desktop shortcut that points to Firefox, either in their own Desktop or the public Desktop? 38 - YES: Remove the shortcut and install the launcher into the user's Desktop folder. 39 - NO: Do nothing 40 41 42 43 In elevated installer, we will delete the public shortcut and record the event if: 44 - It exists 45 - We haven't deleted it before 46 - This is a stub installed Firefox 47 48 In the unelevated installer, we will delete the user shortcut and record the event if: 49 - There is a user shortcut (i.e. this is a personal install) 50 - We haven't deleted it before 51 - This is a stub installed Firefox 52 53 In the unelevated installer, we will install the desktop launcher and record the event if: 54 - It is already installed OR 55 - It wasn't previously installed 56 - There is or was a shortcut (shared or personal) 57 - The installation type is "stub" 58 59 60 61 FAQ 62 === 63 64 Q: I don't like the Desktop Launcher. How can I get rid of it? 65 66 A: Delete it from your Desktop folder. It won't be reinstalled by updates, even if you create a new Firefox shortcut there. (We remember that it was previously installed using a Windows registry key.)