Einstellen des Anwendungssymbols

Das Anwendungssymbol, das in der Regel in der oberen linken Ecke des obersten Fensters einer Anwendung angezeigt wird, wird durch den Aufruf der Methode QWindow::setIcon() festgelegt.

Um das Symbol der ausführbaren Anwendungsdatei selbst zu ändern, so wie es auf dem Desktop angezeigt wird (d. h. vor dem Start der Anwendung), ist eine andere, plattformabhängige Technik erforderlich.

Einstellen des Anwendungssymbols unter Windows

Erstellen Sie zunächst eine Bitmap-Datei im ICO-Format, die das Symbolbild enthält. Dies kann mit Microsoft Visual Studio erfolgen: Wählen Sie File >> New, und wählen Sie die Icon File.

Alternativ kann eine .ico Datei aus einer Reihe von Bildern mit dem Konvertierungstool von ImageMagick erstellt werden:

magick.exe convert icon-16.png icon-32.png icon-256.png icon.ico

Speichern Sie die ICO-Datei im Quellcode-Verzeichnis Ihrer Anwendung, z. B. unter dem Namen appico.ico.

Verwendung von CMake unter Windows

Um das Symbol Ihrer Anwendung zu konfigurieren, benötigen Sie eine Ressourcendatei, die Informationen über das Symbol enthält. Eine Ressourcendatei ist eine Textdatei, die Informationen über die Anwendungsressourcen enthält, wie z. B. Symbole, Cursor, Schriftarten usw. Weitere Informationen über Ressourcendateien und deren Inhalt finden Sie unter Über Ressourcendateien.

Sobald Sie die Datei .rc haben, fügen Sie ihr Informationen über die ICO-Datei hinzu und verwenden sie zur Konfiguration Ihres Anwendungssymbols.

Der folgende Ausschnitt zeigt, wie die Beispielanwendung Photo Surface CMake verwendet, um ein Anwendungssymbol einzurichten:

    set(app_icon_resource_windows "${CMAKE_CURRENT_SOURCE_DIR}/resources/photosurface.rc")
    qt_add_executable(photosurfaceexample main.cpp ${app_icon_resource_windows})

Beachten Sie, dass der Befehl set die Variable app_icon_windows definiert, die den Pfad der RC-Datei enthält. Diese Variable wird mit dem Befehl add_executable verwendet, um das Symbol der Anwendung zu setzen.

Verwendung von qmake unter Windows

Wenn Sie immer noch qmake verwenden, um Ihre Makefiles zu erzeugen, müssen Sie eine einzige Zeile zu Ihrer .pro Projektdatei hinzufügen:

RC_ICONS = myappico.ico

Anschließend generieren Sie Ihr Makefile und Ihre Anwendung neu. Die Datei .exe wird nun durch Ihr Symbol im Explorer dargestellt.

Wenn Sie jedoch bereits eine .rc Datei haben, zum Beispiel mit dem Namen myapp.rc, die Sie wiederverwenden möchten, sind die folgenden zwei Schritte erforderlich. Fügen Sie zunächst eine einzelne Textzeile in die Datei myapp.rc ein:

IDI_ICON1               ICON    "myappico.ico"

Fügen Sie dann diese Zeile in Ihre Datei myapp.pro ein:

RC_FILE = myapp.rc

Wenn Sie qmake nicht verwenden, sind folgende Schritte erforderlich: Erstellen Sie zunächst eine Datei .rc und führen Sie das Programm rc oder windres auf der Datei .rc aus, dann verknüpfen Sie Ihre Anwendung mit der resultierenden Datei .res.

Einstellen des Programmsymbols unter macOS

Das Anwendungssymbol, das normalerweise im Anwendungsdock angezeigt wird, wird durch den Aufruf von QWindow::setWindowIcon() in einem Fenster gesetzt. Es ist möglich, dass das Programm vor dem Funktionsaufruf im Bereich des Anwendungsdocks erscheint. In diesem Fall wird ein Standardsymbol während der Sprunganimation angezeigt.

Um sicherzustellen, dass das richtige Symbol erscheint, sowohl beim Start der Anwendung als auch im Finder, ist es notwendig, eine plattformabhängige Technik anzuwenden.

Obwohl viele Programme Icon-Dateien (.icns) erstellen können, wird empfohlen, das von Apple mitgelieferte Programm iconutil zu verwenden. iconutil ist ein Befehlszeilenprogramm, das Iconset-Ordner in einsatzbereite, hochauflösende icns-Dateien konvertiert. Die Verwendung dieses Tools komprimiert auch die resultierende icns-Datei, so dass Sie keine zusätzliche Komprimierung durchführen müssen.

Verwendung von CMake unter macOS

Um das Symbol der Anwendung zu konfigurieren, muss die von CMake erzeugte Datei Info.plist die Symbolinformationen enthalten. Dies kann erreicht werden, indem der Dateiname .icns auf die Variable MACOSX_BUNDLE_ICON_FILE gesetzt wird.

Der folgende Ausschnitt zeigt, wie die Beispielanwendung Photo Surface CMake verwendet, um ein Anwendungssymbol einzurichten:

    # The MACOSX_BUNDLE_ICON_FILE variable is added to the Info.plist
    # generated by CMake. This variable contains the .icns file name,
    # without the path.
    set(MACOSX_BUNDLE_ICON_FILE photosurface.icns)

    # And the following tells CMake where to find and install the file itself.
    set(app_icon_macos "${CMAKE_CURRENT_SOURCE_DIR}/resources/photosurface.icns")
    set_source_files_properties(${app_icon_macos} PROPERTIES
           MACOSX_PACKAGE_LOCATION "Resources")

    qt_add_executable(photosurfaceexample MACOSX_BUNDLE main.cpp ${app_icon_macos})

Beachten Sie, dass der erste Befehl set die Variable MACOSX_BUNDLE_ICON_FILE definiert, die erforderlich ist, um die Icon-Datei zur Datei Info.plist hinzuzufügen. Der zweite Befehl set definiert die Variable app_icon_macos mit dem absoluten Pfad zur Icon-Datei. Diese Variable wird dann zur Konfiguration von MACOSX_PACKAGE_LOCATION verwendet, die den Installationsort der Icon-Datei definiert. Schließlich verwendet add_executable die Variable app_icon_macOS, um das Icon der Anwendung zu setzen.

Verwendung von qmake unter macOS

Wenn Sie immer noch qmake verwenden, um Ihre Makefiles zu erzeugen, müssen Sie nur eine einzige Zeile zu Ihrer .pro Projektdatei hinzufügen. Wenn zum Beispiel der Name Ihrer Icon-Datei myapp.icns lautet und Ihre Projektdatei myapp.pro, fügen Sie diese Zeile zu myapp.pro hinzu:

ICON = myapp.icns

Dadurch wird sichergestellt, dass qmake Ihre Icons an der richtigen Stelle ablegt und einen Info.plist Eintrag für das Icon erstellt.

Wenn Sie qmake nicht verwenden, müssen Sie die folgenden Schritte manuell durchführen:

1. Erstellen Sie eine Info.plist Datei für Ihre Anwendung (unter Verwendung der PropertyListEditor, zu finden in Developer/Applications).
2. Verknüpfen Sie Ihren .icns -Eintrag mit dem CFBundleIconFile -Eintrag in der Info.plist -Datei (wiederum unter Verwendung der PropertyListEditor).
3. Kopieren Sie die Datei Info.plist in das Verzeichnis Contents Ihres Anwendungspakets.
4. Kopieren Sie die Datei .icns in das Verzeichnis Contents/Resources Ihres Anwendungs-Bundles.

Einstellen des Anwendungssymbols auf gängigen Linux-Desktops

In diesem Abschnitt werden kurz die Probleme beschrieben, die bei der Bereitstellung von Symbolen für Anwendungen für zwei gängige Linux-Desktop-Umgebungen auftreten: KDE und GNOME. Die Kerntechnologie, die zur Beschreibung von Anwendungssymbolen verwendet wird, ist für beide Desktops gleich und kann auch für andere Desktops gelten, aber es gibt Details, die für beide spezifisch sind. Die wichtigste Quelle für Informationen über die von diesen Linux-Desktops verwendeten Standards ist freedesktop.org. Informationen über andere Linux-Desktops finden Sie in der Dokumentation der jeweiligen Desktops.

Häufig verwenden Benutzer keine ausführbaren Dateien direkt, sondern starten Anwendungen durch Anklicken von Symbolen auf dem Desktop. Diese Symbole sind Repräsentationen von "Desktop-Eingabedateien", die eine Beschreibung der Anwendung enthalten, die auch Informationen über das Symbol enthält. Beide Desktop-Umgebungen sind in der Lage, die Informationen in diesen Dateien abzurufen und verwenden sie, um Verknüpfungen zu Anwendungen auf dem Desktop, im Startmenü und in der Systemsteuerung zu erstellen.

Weitere Informationen über Desktop-Eintragsdateien finden Sie in der Spezifikation für Desktop-Einträge.

Obwohl Desktop-Eingabedateien die Details der Anwendung sinnvoll kapseln können, müssen wir die Symbole immer noch an einem konventionellen Ort für jede Desktop-Umgebung speichern. Eine Reihe von Speicherorten für Icons sind in der Icon Theme Specification angegeben.

Obwohl der Pfad, in dem die Icons abgelegt werden, vom verwendeten Desktop und seiner Konfiguration abhängt, sollte die Verzeichnisstruktur unter jedem dieser Verzeichnisse demselben Muster folgen: Unterverzeichnisse werden nach Thema, Icon-Größe und Anwendungstyp angeordnet. Im Allgemeinen werden Anwendungssymbole zum Thema hicolor hinzugefügt, so dass ein quadratisches Anwendungssymbol mit einer Größe von 32 Pixeln im Verzeichnis hicolor/32x32/apps unterhalb des Symbolpfads gespeichert würde.

K Desktop-Umgebung (KDE)

Anwendungssymbole können für die Verwendung durch alle Benutzer oder für jeden einzelnen Benutzer installiert werden. Ein Benutzer, der gerade auf seinem KDE 4-Desktop angemeldet ist, kann diese Speicherorte mithilfe von kde4-config ermitteln, indem er z. B. Folgendes in ein Terminalfenster eintippt:

kde4-config --path icon

Anwendungen, die Qt 5 und KDE Frameworks 5 verwenden, finden ihre Symbole in der Liste, die von diesem Befehl zurückgegeben wird:

qtpaths --locate-dirs GenericDataLocation icons

Die Liste der durch Doppelpunkte getrennten Pfade, die auf stdout ausgegeben wird, enthält in der Regel den benutzerspezifischen Symbolpfad und den systemweiten Pfad. Unterhalb dieser Verzeichnisse sollte es möglich sein, die Icons gemäß den in der Icon Theme Specification beschriebenen Konventionen zu finden und zu installieren.

Wenn Sie ausschließlich für KDE entwickeln, sollten Sie die Vorteile des KDE-Build-Systems nutzen, um Ihre Anwendung zu konfigurieren. Dadurch wird sichergestellt, dass Ihre Icons an den für KDE geeigneten Stellen installiert werden.

Die Website für KDE-Entwickler finden Sie unter http://techbase.kde.org/.

GNOME

Anwendungssymbole werden in einem systemweiten Standardverzeichnis gespeichert, das architekturunabhängige Dateien enthält. Dieser Speicherort kann mit gnome-config ermittelt werden, indem Sie z. B. Folgendes in ein Terminal-Fenster eintippen:

gnome-config --datadir

Der auf stdout ausgegebene Pfad verweist auf einen Ort, der ein Verzeichnis namens pixmaps enthalten sollte; die Verzeichnisstruktur innerhalb des Verzeichnisses pixmaps ist in der Spezifikation des Icon-Themas beschrieben.

Wenn Sie ausschließlich für GNOME entwickeln, sollten Sie den Standardsatz der GNU Build Tools verwenden. Weitere Informationen finden Sie im Abschnitt Integrationsrichtlinien. Dadurch wird sichergestellt, dass Ihre Symbole an den für GNOME geeigneten Stellen installiert werden.

Die GNOME-Entwickler-Webseite http://developer.gnome.org/ bietet weitere Einblicke in die Entwicklung von Anwendungen.