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, для піктограм програм. Натомість він використовує лише формат Windows, який називається ICO. Ви можете створити піктограму програми в будь-якій програмі, але вам доведеться перетворити її у файл ICO за допомогою такої програми, як GIMP.

В цьому відео пояснюється як експортувати файл ICO з GIMP.

Також можна конвертувати зображення PNG у файл ICO, сприятливий для hiDPI, за допомогою цієї команди ImageMagick:

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

Щоб змінити значок панелі завдань, перейдіть до Проєкт → Параметри проєкту → Application (Застосування) → Config (Налаштування) → Icon (Піктограма). Клацніть зображення папки та виберіть ваш файл ICO.

../../_images/icon_project_settings.png

Цей параметр змінює лише піктограму експортованої гри в Windows. Щоб встановити піктограму для macOS, використовуйте Macos Native Icon. А для будь-якої іншої платформи використовуйте параметр Icon.

Зміна піктограми файлу

У версіях Godot 3.5 і вище ви можете змінити піктограму файлу без використання зовнішніх інструментів за допомогою godoticon. Зміна піктограми файла у такий спосіб має спрацювати для виконуваних файлів, які містять вбудований PCK.

Попередження

Є `відомі проблеми<https://github.com/godotengine/godot/issues/33466>`__ при зміні значка застосунку в виконуваних файлах, які вбудовують файл PCK. Наразі рекомендується уникати використання rcedit, якщо ви вирішите ввімкнути опцію Embed Pck для вашого попереднього налаштування експорту Windows у діалоговому вікні Експорт.

Піктограма файлу - це піктограма виконуваного файлу, яку ви натискаєте, щоб запустити проєкт.

../../_images/icon_file_icon.png

Перш ніж вибрати її в опціях експорту, вам потрібно буде встановити додатковий інструмент під назвою rcedit. Завантажити його можна `тут<https://github.com/electron/rcedit/releases>`_.

Після завантаження потрібно вказати Godot шлях до виконуваного файлу rcedit на вашому комп'ютері. Перейдіть до Редактор → Параметри редактора → Export → Windows. Клацніть зображення папки щоб записати rcedit. Перейдіть та виберіть виконуваний файл rcedit.

Примітка

Користувачам Linux та macOS для використання rcedit потрібно буде встановити ще й `WINE<https://www.winehq.org/>`_.

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

Тепер у вас має бути все необхідне для заміни піктограми файлу. Для цього вам потрібно буде вказати піктограму під час експорту. Перейдіть до Проєкт → Експорт. Якщо припустити, що ви вже створили попередньо встановлену програму Windows Desktop, виберіть піктограму у форматі 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.