Up to date

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

Запуск застосунків Godot на macOS

Дивись також

Ця сторінка охоплює запуск проектів Godot на macOS. Якщо ви ще не експортували свій проект, спочатку прочитайте Експорт на macOS.

За замовчуванням macOS буде запускати тільки застосунки, які підписані і нотаріально завірені.

Примітка

When running an app from the Downloads folder or when still in quarantine, Gatekeeper will perform path randomization as a security measure. This breaks access to relative paths from the app, which the app relies upon to work. To resolve this issue, move the app to the /Applications folder.

In general, macOS apps should avoid relying on relative paths from the application folder.

Залежно від способу підписування та розповсюдження програми macOS, можливі такі сценарії:

Застосунок підписаний, нотаріально завірений та розповсюджується через App Store

Примітка

Розробники застосунків повинні приєднатися до Програми розробників Apple, а також налаштувати параметри підписання та нотаріального засвідчення під час експорту, а потім завантажити застосунок в App Store.

Застосунок повинен вийти з коробки, без додаткової взаємодії з користувачем.

Застосунок підписаний, нотаріально завірений і поширюється за межами App Store

Примітка

Розробникам застосунків необхідно приєднатися до Програми розробників Apple, а також налаштувати параметри підписання та нотаріального засвідчення під час експорту, а потім розповсюдити застосунок як ". DMG", або ".ZIP", архів.

Під час першого запуску програми буде відображатися таке діалогове вікно:

../../_images/signed_and_notarized_0.png

Клацніть Open, щоб запустити програму.

Якщо з'явиться наступне діалогове вікно попередження, ваш Mac налаштовано на те, щоб дозволити програми лише з App Store.

../../_images/signed_and_notarized_1.png

Щоб дозволити програми сторонніх виробників, відкрийте System Preferences, клацніть Security & Privacy, а потім виберіть General, розблокуйте параметри та виберіть App Store and identified developers.

../../_images/sys_pref_0.png

Застосунок підписаний (включаючи підписи без точок доступу), але нотаріально не завірений

Примітка

Розробник програми використовував сертифікат із власним підписом, або підписом без точок доступу (поведінка Godot за замовчуванням для експортованого проекту).

Під час першого запуску програми буде відображатися таке діалогове вікно:

../../_images/signed_0.png

Щоб запустити цю програму, ви можете тимчасово перевизначити Gatekeeper:

  • Відкрийте System Preferences, клацніть Security & Privacy, потім клацніть General, і натисніть кнопку Open Anyway.

    ../../_images/sys_pref_1.png
  • Або клацніть правою клавішею мишки (клацніть елементом керування) на піктограмі програми у вікні Finder і виберіть у меню Open.

    ../../_images/signed_1.png
  • Потім клацніть Open у діалоговому вікні підтвердження.

    ../../_images/signed_2.png
  • Введіть пароль, якщо з'явиться відповідний запит.

Another option is to disable Gatekeeper entirely. Note that this does decrease the security of your computer by allowing you to run any software you want. To do this, run sudo spctl --master-disable in the Terminal, enter your password, and then the Anywhere option will be available:

../../_images/macos_allow_from_anywhere.png

Note that Gatekeeper will re-enable itself when macOS updates.

App is not signed, executable is linker-signed

Примітка

Застосунок побудований з використанням офіційних шаблонів експорту, але він не підписаний.

Під час першого запуску програми буде відображатися таке діалогове вікно:

../../_images/linker_signed_1.png

Щоб запустити цю програму, слід видалити атрибут розширеного файлу карантину вручну:

  • Open Terminal.app (press Cmd + Space and enter Terminal).

  • Перейдіть до папки, що містить цільовий застосунок.

    Використовуйте команду cd path_to_the_app_folder, наприклад cd ~/Downloads/, якщо він знаходиться в папці Downloads.

  • Запустіть команду xattr -dr com.apple.quarantine "Unsigned Game.app" (з лапками та розширенням .app).

Neither app nor executable is signed (relevant for Apple Silicon Macs only)

Примітка

Застосунок побудований з використанням користувацьких шаблонів експорту, скомпільований за допомогою OSXCross, і він взагалі не підписаний.

Під час першого запуску програми буде відображатися таке діалогове вікно:

../../_images/unsigned_1.png

Щоб запустити цей застосунок, ви можете підписати його без точок доступу самостійно:

  • Встановіть Xcode для App Store, запустіть його і підтвердьте установку інструментів командного рядка.

  • Open Terminal.app (press Cmd + Space and enter Terminal).

  • Перейдіть до папки, що містить цільовий застосунок.

    Використовуйте команду cd path_to_the_app_folder, наприклад cd ~/Downloads/, якщо він знаходиться в папці Downloads.

  • Виконайте наступні команди:

    xattr -dr com.apple.quarantine "Unsigned Game.app" (з лапками та розширенням ".app").

    codesign -s - --force --deep "Unsigned Game.app" (з лапками та розширенням ".app").