Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

Anwendungs-Icon für Windows ändern

Standardmäßig ist das Icon des exportierten Projekts das Godot-Icon. Sie werden das höchstwahrscheinlich für Ihr Projekt ändern wollen. Es gibt zwei Arten von Icons, die unter Windows geändert werden können: das Datei-Icon und das Taskleisten-Icon.

Erstellen einer ICO-Datei

Windows benutzt keine Formate wie png oder jpg für Applikations-Icons. Stattdessen benutzt es ein windows-spezifisches Format namens ICO. Sie können das Applikations-Icon in jedem Programm erstellen, aber es muss mit einem Programm wie GIMP in eine ICO-Datei konvertiert werden.

In dieser Video-Anleitung erfahren Sie, wie Sie eine ICO-Datei mit GIMP exportieren können.

Es ist auch möglich, ein PNG-Bild mit diesem ImageMagick Befehl in eine hiDPI-freundliche ICO-Datei zu konvertieren:

magick convert icon.png -define icon:auto-resize=256,128,64,48,32,16 icon.ico

Abhängig davon, welche Version von ImageMagick Sie installiert haben, müssen Sie eventuell das magick weglassen und stattdessen diesen Befehl ausführen:

convert icon.png -define icon:auto-resize=256,128,64,48,32,16 icon.ico

Warnung

Damit die ICO-Datei das Default-Godot-Icon vollständig ersetzen kann, muss sie alle die Größen enthalten, die im Default-Godot-Icon enthalten sind: 16×16, 32×32, 48×48, 64×64, 128×128, 256×256. Wenn die ICO-Datei nicht alle Größen enthält, wird das Default-Godot-Icon für die Größen beibehalten, die nicht überschrieben wurden.

Der obige ImageMagick-Befehl berücksichtigt dies.

Ändern des Taskleisten-Icons

Das Taskleisten-Icon ist das Icon, das in der Taskleiste angezeigt wird, wenn Ihr Projekt ausgeführt wird.

../../_images/icon_taskbar_icon.png

Um das Taskleisten-Icon zu ändern, gehen Sie zu Projekt → Projekteinstellungen → Anwendung → Konfiguration → Natives Windows-Icon. Klicken Sie auf das Ordner-Icon und wählen Sie das gewünschte Icon aus.

../../_images/icon_project_settings.png

Diese Einstellung ändert nur das Icon für Ihr exportiertes Spiel unter Windows. Um das Icon für MacOS einzustellen, verwenden Sie Natives Macos-Icon. Und für jede andere Plattform verwenden Sie die Einstellung Icon.

Ändern des Datei-Icons

In Godot 3.5 und höher können Sie das Datei-Icon ohne externe Werkzeuge mit godoticon ändern. Das Ändern des Datei-Icons auf diese Weise sollte für ausführbare Dateien funktionieren, die ein eingebettetes PCK enthalten.

Warnung

Es gibt bekannte Probleme beim Ändern des Anwendungs-Icons in ausführbaren Dateien, die eine PCK-Datei einbetten. Es wird empfohlen, die Verwendung von rcedit vorerst zu vermeiden, wenn Sie sich dafür entscheiden, die Option Pck Einbetten für Ihr Windows-Exportprofil im Export-Dialog zu aktivieren.

Das Datei-Icon ist das Icon der ausführbaren Datei, auf die Sie klicken, um das Projekt zu starten.

../../_images/icon_file_icon.png

Bevor Sie es in den Exportoptionen auswählen, müssen Sie ein zusätzliches Tool namens rcedit installieren. Sie können es hier herunterladen.

Nach dem Herunterladen müssen Sie Godot den Pfad zur ausführbaren rcedit-Datei auf Ihrem Computer mitteilen. Gehen Sie zu Editor → Editoreinstellungen → Exportieren → Windows. Klicken Sie auf das Ordner-Icon für den Eintrag rcedit. Navigieren Sie zu der ausführbaren Datei rcedit und wählen Sie diese aus.

Bemerkung

Linux- und MacOS-Benutzer müssen außerdem WINE installieren, um rcedit verwenden zu können.

Unter macOS 10.15 (Catalina) oder später sollten Sie sicherstellen, dass Sie eine 64-Bit-Version von WINE und rcedit verwenden, da 32-Bit-Anwendungen nicht mehr unterstützt werden.

../../_images/icon_rcedit.png

Es sollte jetzt alles vorhanden sein, um das Datei-Icon zu ändern. Dazu müssen Sie beim Exportieren das Icon angeben. Gehen Sie zu Projekt → Exportieren. Angenommen, Sie haben bereits eine Windows Desktop-Vorgabe erstellt, wählen Sie Ihr Icon im ICO-Format im Feld Anwendung → Icon aus.

Warnung

Alle angegebenen Metadaten müssen gültig sein. Am wichtigsten ist, dass die Versionsbezeichner die Form major.minor.patch.revision haben müssen, wobei jede Komponente erforderlich und eine positive ganze Zahl ist. Zum Beispiel ist 1.2.0.0 gültig, aber 1.2.0 ist es nicht.

Wenn Sie in der Exportvorgabe ungültige Metadaten angeben, wird sich das Anwendungs-Icon nicht ändern, da rcedit die Metadaten der ausführbaren Datei nicht ändern kann.

../../_images/icon_export_settings.png

Bemerkung

Wenn rcedit das Icon nicht ändert, können Sie stattdessen Ihre eigenen Windows-Exportvorlagen mit geändertem Icon kompilieren. Ersetzen Sie dazu platform/windows/godot.ico <https://github.com/godotengine/godot/blob/master/platform/windows/godot.ico> __ durch Ihre eigene ICO-Datei, bevor Sie die Exportvorlagen kompilieren.

Sobald dies geschehen ist, können Sie Ihre Exportvorlagen als benutzerdefinierte Exportvorlagen in der Windows-Exportvorgabe Ihres Projekts angeben.

Testen des Ergebnisses

Sie können das Projekt jetzt exportieren. Wenn es richtig funktioniert hat, sollten Sie Folgendes sehen:

../../_images/icon_result.png

Bemerkung

Wenn Ihr Icon nicht richtig angezeigt wird, versuchen Sie unter Windows 10, den Icon-Cache zu leeren. Öffnen Sie dazu den Ausführen-Dialog und geben Sie ie4uinit.exe -ClearIconCache oder ie4uinit.exe -show ein.