Up to date

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

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

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

Создание ICO файла

Windows не использует такие форматы, как png или jpg для значков приложений. Вместо этого он использует формат 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

Depending on which version of ImageMagick you installed, you might need to leave out the magick and run this command instead:

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 →Windows Native Icon**(Проект → Настройки проекта → Приложение → Конфигурация → Нативный Значок Windows). Щёлкните значок папки и выберите нужный ICO файл.

../../_images/icon_project_settings.png

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

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

In Godot 3.5 and later, you can change the file icon without external tools using godoticon. Changing the file icon this way should work for executables containing an embedded PCK.

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

Существуют известные проблемы при изменении значка приложения в исполняемых файлах, которые встраивают файл PCK. Рекомендуется пока воздержаться от использования rcedit, если вы решите включить опцию Embed Pck для предустановки экспорта Windows в диалоговом окне «Экспорт».

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

../../_images/icon_file_icon.png

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

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

Примечание

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

On macOS 10.15 (Catalina) or later, make sure to use a 64-bit version of both WINE and rcedit since 32-bit applications aren't supported anymore.

../../_images/icon_rcedit.png

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

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

All the supplied metadata must be valid. Most importantly, the version identifiers must take the form major.minor.patch.revision where every component is required and is a positive integer. For instance, 1.2.0.0 is valid but 1.2.0 is not.

If you provide invalid metadata in the export preset, the application icon won't change as rcedit will fail to change the executable's metadata.

../../_images/icon_export_settings.png

Примечание

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

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

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

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

../../_images/icon_result.png

Примечание

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