Изменение значка приложения для Windows

По умолчанию, значок экспортированного проекта будет значком Godot. Скорее всего, вы захотите изменить это для своего проекта. В Windows можно изменить значки двух типов: значок файла и значок на панели задач.

Создание собственного файла ICO

Примечание

Начиная с версии Godot 4.1, Godot может создавать ICO-файл на основе файла значка, заданного в шаблоне экспорта Windows. Этот файл значка может быть в формате PNG, WebP или SVG. Если в шаблоне экспорта Windows значок не определён, автоматически используется настройка проекта application/config/icon.

Это означает, что вам больше не нужно следовать инструкциям в этом разделе для ручного создания ICO-файла, если только вы не хотите управлять дизайном значка в зависимости от его отображаемого размера. Обратите внимание, что даже если Godot создаст ICO-файл автоматически, вам всё равно необходимо настроить rcedit, чтобы значок файла действительно изменился.

Windows не использует такие форматы, как PNG или JPEG, для значков приложений. Вместо этого используется формат ICO, доступный только в Windows. Вы можете создать значок приложения в любой программе, но вам придётся преобразовать его в ICO-файл с помощью, например, GIMP.

В этом видеоуроке рассказывается, как экспортировать файл ICO с помощью GIMP.

Также можно использовать команду ImageMagick для преобразования изображений PNG в файл ICO:

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

В зависимости от установленной версии ImageMagick вам может потребоваться исключить magick и выполнить вместо этого следующую команду:

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

Предупреждение

Чтобы файл ICO эффективно заменял значок Godot по умолчанию, он должен содержать все размеры, включенные в значок Godot по умолчанию: 16×16, 32×32, 48×48, 64×64, 128×128, 256×256 . Если файл ICO не содержит всех размеров, значок Godot по умолчанию будет сохранен для размеров, которые не были переопределены.

Приведенная выше команда ImageMagick учитывает это.

Изменение значка на панели задач

Значок панели задач - это значок, который отображается на панели задач во время выполнения вашего проекта.

../../_images/icon_taskbar_icon.png

Чтобы изменить значок на панели задач, перейдите в раздел Project > Project Settings > Application > Config. Убедитесь, что Advanced Settings включены для отображения этого параметра. Затем перейдите в раздел Windows Native Icon. Щёлкните по значку папки и выберите ICO-файл.

../../_images/icon_project_settings.webp

Этот параметр изменяет только значок экспортируемой игры в Windows. Чтобы установить значок для macOS, используйте Macos Native Icon. А для любой другой платформы используйте настройку Icon.

Изменение значка файла

В Godot 3.5 и более поздних версиях можно изменить значок файла без внешних инструментов, используя godoticon. Изменение значка файла таким способом должно работать для исполняемых файлов, содержащих встроенный PCK.

Значок файла является значком исполняемого файла, на который вы нажимаете, чтобы начать проект.

../../_images/icon_file_icon.png

Прежде чем выбрать его в параметрах экспорта, вам необходимо установить дополнительный инструмент под названием rcedit. Вы можете скачать его здесь.

После загрузки укажите Godot путь к исполняемому файлу rcedit на вашем компьютере. Перейдите в раздел Editor > Editor Settings > Export > Windows. Щелкните значок папки с файлом rcedit. Найдите и выберите исполняемый файл rcedit.

Примечание

Пользователям Linux и macOS также необходимо установить WINE для использования rcedit.

На macOS обязательно используйте 64-разрядную версию WINE и rcedit, поскольку 32-разрядные приложения больше не поддерживаются.

../../_images/icon_rcedit.webp

Теперь у вас всё готово для изменения значка файла. Для этого вам потребуется указать значок при экспорте. Перейдите в раздел Project > Export. Если вы уже создали шаблон рабочего стола Windows, выберите значок в формате ICO в поле Application > Icon.

Предупреждение

Все предоставленные метаданные должны быть корректными. Самое главное, идентификаторы версий должны иметь вид major.minor.patch.revision, где каждый компонент обязателен и является положительным целым числом. Например, 1.2.0.0 корректно, а 1.2.0 — нет.

Если в настройках экспорта указаны неверные метаданные, значок приложения не изменится, поскольку rcedit не сможет изменить метаданные исполняемого файла.

../../_images/icon_export_settings.webp

Примечание

Если rcedit не может изменить значок, вы можете вместо этого скомпилировать свои собственные шаблоны экспорта Windows с измененным значком. Для этого замените platform/windows/godot.ico своим собственным файлом ICO перед компиляцией экспорта шаблоны.

Как только это будет сделано, вы можете указать свои шаблоны экспорта в качестве настраиваемых шаблонов экспорта в предустановке экспорта Windows вашего проекта.

Проверка результата

Теперь вы можете экспортировать проект. Если всё сработало правильно, вы должны увидеть следующее:

../../_images/icon_result.png

Примечание

Если ваш значок не отображается должным образом, в Windows 10 попробуйте очистить кеш значков. Для этого откройте диалоговое окно Выполнить и введите ie4uinit.exe -ClearIconCache или ie4uinit.exe -show.