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.

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

Дивись також

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

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

Примітка

Під час запуску програми з папки "Завантаження" або коли все ще знаходиться на карантині, Gatekeeper виконає рандомізацію шляху як захід безпеки. Це порушує доступ до відносних шляхів із програми, на які програма покладається для роботи. Щоб вирішити цю проблему, перемістіть програму в папку /Applications.

Загалом програми macOS не повинні покладатися на відносні шляхи з папки програми.

Залежно від способу підписування та розповсюдження програми 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
  • Введіть пароль, якщо з'явиться відповідний запит.

Інший варіант — повністю вимкнути Gatekeeper. 'Зауважте, що це знижує безпеку вашого комп’ютера, дозволяючи запускати будь-яке програмне забезпечення. Для цього запустіть sudo spctl --master-disable у терміналі, введіть свій пароль, і тоді опція Будь-де стане доступною:

../../_images/macos_allow_from_anywhere.png

Зауважте, що Gatekeeper знову ввімкнеться під час оновлення macOS.

Програма не підписана, виконуваний файл підписано компонувальником

Примітка

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

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

../../_images/linker_signed_1.png

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

  • Відкрийте Terminal.app (натисніть Cmd + Space і введіть Terminal).

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

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

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

Ні програма, ні виконуваний файл не підписані (стосується лише для Apple Silicon Mac)

Примітка

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

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

../../_images/unsigned_1.png

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

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

  • Відкрийте Terminal.app (натисніть Cmd + Space і введіть 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").