Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Експорт на Windows

Дивись також

На цій сторінці описано, як експортувати проект Godot на Windows. Якщо ви хочете замість цього скомпілювати редактор, або експортувати шаблони бінарників з джерела, прочитайте Компіляція для Windows.

Найпростіший спосіб розповсюдження ігор на ПК - це скопіювати виконувані файли (godot.exe), стиснути папку та надіслати її комусь іншому. Однак часто цього не бажано робити.

Godot пропонує елегантніший підхід до розповсюдження на ПК при використанні системи експорту. Під час експорту на Windows, експортер бере всі файли проєкту та створює файл data.pck. Цей файл укомплектований спеціально оптимізованим бінарним файлом, який є меншим, швидшим та не містить редактора і налагоджувача.

Архітектура

There are 3 different processor architectures that exported Godot projects can run on in Windows:

  • x86_64

  • x86_32

  • arm64

The default is x86_64, this is the most common architecture of PC processors today. All modern Intel and AMD processors as of writing this are x86_64.

x86_32 will give you a 32bit executable that can run on 32bit-only versions of Windows as well as modern versions which are 64bit. It is not recommended to use this option unless you are trying to get your project to run on an old 32bit version of Windows. And it should be noted that no 32bit versions of Windows receive Microsoft support anymore.

arm64 processors are modern but less common than x86_64, and run Windows on ARM. Snapdragon X Elite is an example of a modern Windows ARM processor. Using this export option will allow your project to run natively on arm processors without Microsoft's Prism emulator. Executables made using this option will not run on regular Windows with an x86_64 processor. If you're uploading your project to a platform that allows multiple executables, such as itch.io, and are confident a Snapdragon X Elite processor is powerful enough to run it, we would recommend providing an ARM version. Prism emulation is far from perfect, and Godot does not require you to build or design your game in any special way to run on ARM.

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

Godot автоматично використовуватиме будь-яке зображення, встановлене як значок вашого проєкту в налаштуваннях проєкту, та конвертуватиме його у файл ICO для експортованого проєкту. Якщо ви хочете вручну створити файл ICO для кращого контролю над тим, як значок виглядає в різних роздільних здатностях, дивіться сторінку Ручна зміна значка програми для Windows.

PCK embedding

PCK embedding is only supported on executables up to ~3.89 GB in size. This metric includes both the executable and embedded PCK size, so in practice, the PCK file may only weigh up to ~3.75 GB. This can also vary depending on build options when using a custom export template.

Підписання коду

Godot здатний автоматично підписувати код під час експорту. Для цього у вас має бути встановлено Windows SDK (у Windows) або osslsigncode (у будь-якій іншій ОС). Вам також знадобиться сертифікат підпису пакета, інформацію про його створення можна знайти тут.

Налаштування

Налаштування потрібно змінити в двох місцях. Спочатку в налаштуваннях редактора в розділі Експорт > Windows. Клацніть папку поруч із налаштуванням Sign Tool, якщо ви використовуєте Windows, перейдіть до та виберіть SignTool.exe, якщо ви користуєтеся іншою ОС, виберіть osslsigncode.

../../_images/windows_editor_settings.webp

Друге розташування — це стиль експорту Windows, який можна знайти в Проект > Експорт.... Додайте стиль робочого столу Windows, якщо ви ще цього не зробили. Під параметрами є категорія підпису коду.

../../_images/windows_export_codesign.webp

Enabled має бути встановлено на true, а Identity має бути встановлено на сертифікат підпису. Інші параметри можна налаштувати за потреби. Після цього Godot підпише ваш проект під час експорту.

Змінні середовища

Ви можете використовувати такі змінні середовища, щоб налаштувати параметри експорту поза редактором. Під час процесу експорту вони замінюють значення, встановлені в меню експорту.

Експорт змінних середовища Windows

Варіант експорту

Змінна середовища

Шифрування / ключ шифрування

GODOT_SCRIPT_ENCRYPTION_KEY

Параметри / Кодовий дизайн / Тип ідентифікації

GODOT_WINDOWS_CODESIGN_IDENTITY_TYPE

Опції / Кодовий дизайн / Ідентифікація

GODOT_WINDOWS_CODESIGN_IDENTITY

Параметри / Кодовий дизайн / Пароль

GODOT_WINDOWS_CODESIGN_PASSWORD

Параметри експортування

Повний список доступних опцій експорту можна знайти в довіднику класу EditorExportPlatformWindows.