docs: Explain macOS Python.app Dock icon limitation

This change adds a comment to the `create-macos-app.sh` script to explain why the Solaar application may still show a Dock icon on macOS, even when it is not desired for a background utility.

On macOS, Python often runs as `Python.app`, which has its own `Info.plist` file. This built-in `Info.plist` takes precedence over the one generated for the Solaar app bundle. As a result, settings like `LSUIElement=true`, which would normally hide the Dock icon, are overridden. This comment clarifies that this behavior is a known limitation of the Python distribution on macOS and not a bug in the Solaar packaging script.
This commit is contained in:
Din Tort 2025-10-27 21:39:59 +01:00
parent dcdf159463
commit 39aeaf07ef
1 changed files with 4 additions and 0 deletions

View File

@ -36,6 +36,10 @@ set -euo pipefail
# that may prevent GTK from creating a tray icon properly.
# Workaround: Launch solaar in a detached background process
# NOTE: macOS Python always uses Python.app which shows a Dock icon
# LSUIElement=true in Info.plist would have hidden it, but Python.app has its own Info.plist
# that overrides ours. This is a limitation of Python on macOS.
if [[ "\${SOLAAR_RELAUNCHED:-}" != "1" ]]; then
# First invocation from .app bundle - relaunch detached
export SOLAAR_RELAUNCHED=1