Up to date

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

Running Godot apps on macOS

См.также

This page covers running Godot projects on macOS. If you haven't exported your project yet, read Экспорт для macOS first.

По умолчанию 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 Developer Program и настроить параметры подписи и нотариального заверения во время экспорта, а затем загрузить приложение в App Store.

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

Приложение подписано, нотариально заверено и распространено за пределами App Store

Примечание

Разработчикам приложений нужно присоединиться к программе Apple Developer Program и настроить параметры подписи и нотариального заверения во время экспорта, а затем распространить приложение как ".DMG" или ".ZIP" архив.

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

../../_images/signed_and_notarized_0.png

Нажмите Open, чтобы запустить приложение.

Если вы видите следующее диалоговое окно с предупреждением, ваш Mac настроен так, чтобы разрешать использование приложений только из App Store.

../../_images/signed_and_notarized_1.png

To allow third-party apps, open System Preferences, click Security & Privacy, then click General, unlock settings, and select 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

  • Или щёлкните правой кнопкой мыши на значке приложения в окне поиск и выберите Open из меню.

    ../../_images/signed_1.png

  • Затем нажмите «Открыть» в диалоговом окне подтверждения.

    ../../_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

Чтобы запустить это приложение, вы можете для данного случая подписать его самостоятельно:

  • Install Xcode for the App Store, start it and confirm command line tools installation.

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

  • Перейдите в папку, содержащую целевое приложение.

    Используйте команду cd path_to_the_app_folder, например. cd ~/Downloads/, если оно в папке Downloads.

  • Run the following commands:

    xattr -dr com.apple.quarantine «Unsigned Game.app» (включая кавычки и расширение ".app").

    codesign -s - --force --deep "Unsigned Game.app" (включая кавычки и расширение ".app").