Add information about App Management permissions to the FAQ.

This commit is contained in:
JBYoshi 2023-05-28 14:42:07 -05:00
parent 97b9b61061
commit f43847516d
No known key found for this signature in database
GPG Key ID: AE4430116622D05D

View File

@ -220,3 +220,9 @@ Or use the `--greedy` flag:
brew upgrade --greedy
Refer to the `upgrade` section of the [`brew` manual page](Manpage.md) for more details.
## Why do my apps lose their Dock position / Launchpad position / permission settings when I run `brew upgrade`?
Homebrew has two possible strategies to update apps: uninstalling the old version and reinstalling the new one, or replacing the contents of the app with the new contents. With the uninstall/reinstall strategy, [macOS thinks the app is being deleted without any intent to reinstall it](https://github.com/Homebrew/brew/pull/15138), and so it removes some internal metadata for the old app, including where it appears in the Dock and Launchpad and which permissions it's been granted. The content replacement strategy works around this by treating the upgrade as an in-place upgrade. However, starting in macOS Ventura, these in-place upgrades are only allowed when the updater application (in this case, the terminal running Homebrew) has [certain permissions granted](https://github.com/Homebrew/brew/pull/15483). Either the "App Management" or "Full Disk Access" permission will suffice.
Homebrew defaults to in-place upgrades when it has the necessary permissions. Otherwise, it will use the uninstall/reinstall strategy.