Festlegen des Anwendungssymbols

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

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

Festlegen 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 dann „ Icon File “.

Alternativ kann eine „ .ico “-Datei aus einer Reihe von Bildern mit dem „convert “-Tool 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, beispielsweise unter dem Namen „ appico.ico “.

Verwendung von CMake unter Windows

Um das Symbol Ihrer Anwendung zu konfigurieren, ist eine Ressourcendatei erforderlich, die Informationen zum Symbol enthält. Eine Ressourcendatei ist eine Textdatei, die Informationen zu den Ressourcen der Anwendung enthält, wie z. B. Symbole, Cursor, Schriftarten usw. Weitere Informationen zu Ressourcendateien und deren Inhalt finden Sie unter „Über Ressourcendateien“.

Sobald Sie die Datei „ .rc “ haben, fügen Sie Informationen zur ICO-Datei hinzu und verwenden Sie diese, um das Symbol Ihrer Anwendung zu konfigurieren.

Der folgende Codeausschnitt veranschaulicht, wie die Beispielanwendung „Photo Surface“ CMake zum Einrichten eines Anwendungssymbols verwendet:

    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 zur RC-Datei enthält. Diese Variable wird zusammen mit dem Befehl „ add_executable “ verwendet, um das Anwendungssymbol festzulegen.

Verwendung von qmake unter Windows

Wenn Sie weiterhin qmake zur Erstellung Ihrer Makefiles verwenden, müssen Sie Ihrer Projektdatei „ .pro “ eine einzige Zeile hinzufügen:

RC_ICONS = myappico.ico

Erstellen Sie abschließend Ihr Makefile und Ihre Anwendung neu. Die Datei „ .exe “ wird nun im Explorer durch Ihr Symbol dargestellt.

Wenn Sie jedoch bereits über eine „ .rc “-Datei verfügen, beispielsweise mit dem Namen „ myapp.rc “, die Sie wiederverwenden möchten, sind die folgenden zwei Schritte erforderlich. Fügen Sie zunächst eine einzige Textzeile in die Datei „ myapp.rc “ ein:

IDI_ICON1               ICON    "myappico.ico"

Fügen Sie anschließend 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 „ .rc “-Datei und führen Sie das Programm „ rc “ oder „ windres “ für die Datei „ .rc “ aus. Verknüpfen Sie anschließend Ihre Anwendung mit der resultierenden „ .res “-Datei.

Festlegen des Anwendungssymbols unter macOS

Das Anwendungssymbol, das normalerweise im Anwendungs-Dock angezeigt wird, wird durch den Aufruf von ` QWindow::setIcon()` für ein Fenster festgelegt. Es ist möglich, dass das Programm bereits vor dem Funktionsaufruf im Anwendungs-Dock erscheint; in diesem Fall wird während der Sprunganimation ein Standardsymbol angezeigt.

Um sicherzustellen, dass sowohl beim Start der Anwendung als auch im Finder das richtige Symbol angezeigt wird, muss eine plattformabhängige Methode verwendet werden.

Obwohl viele Programme Icon-Dateien erstellen können (.icns), empfiehlt es sich, das von Apple bereitgestellte Programm „iconutil“ zu verwenden. „iconutil“ ist ein Befehlszeilen-Tool, das Icon-Set-Ordner in bereitstellungsfähige, hochauflösende ICNS-Dateien konvertiert. Bei Verwendung dieses Tools wird die resultierende ICNS-Datei zudem komprimiert, sodass Sie keine zusätzliche Komprimierung vornehmen müssen.

Verwendung von CMake unter macOS

Um das Icon der Anwendung zu konfigurieren, muss die von CMake generierte Datei „ Info.plist “ die Icon-Informationen enthalten. Dies kann erreicht werden, indem der Dateiname „ .icns “ in der Variablen „ MACOSX_BUNDLE_ICON_FILE “ festgelegt wird.

Der folgende Codeausschnitt veranschaulicht, wie die Beispielanwendung „Photo Surface“ CMake zum Einrichten eines Anwendungssymbols verwendet:

    # 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 Symbol-Datei zur Datei „ Info.plist “ hinzuzufügen. Der zweite Befehl „ set “ definiert die Variable „ app_icon_macos “ mit dem absoluten Pfad zur Symbol-Datei. Diese Variable wird dann verwendet, um „MACOSX_PACKAGE_LOCATION“ zu konfigurieren, wodurch der Installationsort der Symbol-Datei festgelegt wird. Schließlich verwendet der Befehl „ add_executable “ die Variable „ app_icon_macOS “, um das Symbol der Anwendung festzulegen.

Verwendung von qmake unter macOS

Wenn Sie weiterhin qmake zur Erstellung Ihrer Makefiles verwenden, müssen Sie lediglich eine einzige Zeile zu Ihrer Projektdatei „ .pro “ hinzufügen. Wenn der Name Ihrer Icon-Datei beispielsweise „ myapp.icns “ lautet und Ihre Projektdatei „ myapp.pro “ heißt, fügen Sie folgende Zeile zu „ myapp.pro “ hinzu:

ICON = myapp.icns

Dadurch wird sichergestellt, dass „ qmake “ Ihre Symbole an der richtigen Stelle ablegt und einen Eintrag „ Info.plist “ für das Symbol erstellt.

Wenn Sie „ qmake “ nicht verwenden, müssen Sie Folgendes manuell vornehmen:

1. Erstellen Sie eine „ Info.plist “-Datei für Ihre Anwendung (mithilfe der „ PropertyListEditor “, die Sie unter Developer/Applications finden).
2. Ordnen Sie Ihren „ .icns “-Eintrag dem „ CFBundleIconFile “-Eintrag in der Datei „ Info.plist “ zu (auch hierfür verwenden Sie das „ PropertyListEditor “).
3. Kopieren Sie die Datei „ Info.plist “ in das Verzeichnis „ Contents “ Ihres Anwendungsbundles.
4. Kopieren Sie die Datei „ .icns “ in das Verzeichnis „ Contents/Resources “ Ihres Anwendungs-Bundles.

Festlegen des Anwendungssymbols auf gängigen Linux-Desktopumgebungen

In diesem Abschnitt beschreiben wir kurz die Aspekte, die bei der Bereitstellung von Symbolen für Anwendungen in zwei gängigen Linux-Desktopumgebungen zu beachten sind: KDE und GNOME. Die Kerntechnologie zur Beschreibung von Anwendungssymbolen ist für beide Desktops identisch und lässt sich möglicherweise auch auf andere anwenden, doch gibt es Details, die für jeden Desktop spezifisch sind. Die wichtigste Informationsquelle zu den von diesen Linux-Desktops verwendeten Standards ist freedesktop.org. Informationen zu anderen Linux-Desktops finden Sie in der Dokumentation der jeweiligen Desktops, für die Sie sich interessieren.

Häufig verwenden Benutzer ausführbare Dateien nicht direkt, sondern starten Anwendungen durch Klicken auf Symbole auf dem Desktop. Diese Symbole sind Darstellungen von „Desktop-Eintragsdateien“, die eine Beschreibung der Anwendung enthalten, einschließlich Informationen zu ihrem Symbol. Beide Desktop-Umgebungen sind in der Lage, die Informationen aus diesen Dateien abzurufen, und nutzen sie, um Verknüpfungen zu Anwendungen auf dem Desktop, im Startmenü und auf dem Panel zu erstellen.

Weitere Informationen zu Desktop-Eintragsdateien finden Sie in der Desktop-Eintragsspezifikation.

Obwohl Desktop-Eintragsdateien die Details der Anwendung sinnvoll zusammenfassen können, müssen wir die Symbole dennoch am üblichen Speicherort für die jeweilige Desktop-Umgebung ablegen. Eine Reihe von Speicherorten für Symbole ist in der Icon-Theme-Spezifikation angegeben.

Obwohl der Pfad zum Auffinden der Symbole von der verwendeten Desktop-Umgebung und deren Konfiguration abhängt, sollte die Verzeichnisstruktur unterhalb jeder dieser Umgebungen demselben Muster folgen: Unterverzeichnisse sind nach Thema, Symbolgröße und Anwendungstyp angeordnet. Im Allgemeinen werden Anwendungssymbole dem „hicolor“-Thema hinzugefügt, sodass ein quadratisches Anwendungssymbol mit einer Größe von 32 Pixeln im Verzeichnis „ hicolor/32x32/apps “ unterhalb des Symbolpfads gespeichert würde.

K Desktop Environment (KDE)

Anwendungssymbole können für alle Benutzer oder benutzerspezifisch installiert werden. Ein Benutzer, der derzeit bei seinem KDE-4-Desktop angemeldet ist, kann diese Speicherorte mit „kde4-config“ ermitteln, indem er beispielsweise Folgendes in ein Terminalfenster eingibt:

kde4-config --path icon

Anwendungen, die Qt 5 und KDE Frameworks 5 verwenden, finden ihre Symbole in der Liste, die dieser Befehl ausgibt:

qtpaths --locate-dirs GenericDataLocation icons

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

Wenn Sie ausschließlich für KDE entwickeln, möchten Sie vielleicht das KDE-Build-System nutzen, um Ihre Anwendung zu konfigurieren. Dadurch wird sichergestellt, dass Ihre Symbole an den für KDE vorgesehenen Speicherorten installiert werden.

Die KDE-Entwickler-Website finden Sie unter https://techbase.kde.org/.

GNOME

Anwendungssymbole werden in einem standardmäßigen, systemweiten Verzeichnis gespeichert, das architekturunabhängige Dateien enthält. Dieser Speicherort lässt sich mit dem Befehl „ gnome-config “ ermitteln, beispielsweise durch Eingabe des folgenden Befehls in einem Terminalfenster:

gnome-config --datadir

Der auf stdout ausgegebene Pfad verweist auf einen Speicherort, der ein Verzeichnis namens „ pixmaps “ enthalten sollte; die Verzeichnisstruktur innerhalb des Verzeichnisses „ pixmaps “ ist in der Icon-Theme-Spezifikation 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 vorgesehenen Speicherorten installiert werden.

Die GNOME-Entwickler-Website, https://developer.gnome.org/, bietet weitere Einblicke in die Entwicklung von Anwendungen.