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" архив.
При первом запуске приложения отображается следующее диалоговое окно:
Нажмите Open
, чтобы запустить приложение.
Если вы видите следующее диалоговое окно с предупреждением, ваш Mac настроен так, чтобы разрешать использование приложений только из App Store.
To allow third-party apps, open System Preferences
, click Security & Privacy
, then click General
, unlock settings, and select App Store and identified developers
.
Приложение подписано (включая специальные подписи), но не нотариально заверено¶
Примечание
Разработчик приложения использовал самозаверяющий сертификат или специальную подпись (поведение Godot по умолчанию для экспортированного проекта).
При первом запуске приложения отображается следующее диалоговое окно:
Чтобы запустить это приложение, вы можете временно переопределить Gatekeeper:
Либо откройте
System Preferences
, нажмитеSecurity & Privacy
, затем нажмитеGeneral
, и нажмитеOpen Anyway
.Или щёлкните правой кнопкой мыши на значке приложения в окне поиск и выберите
Open
из меню.Затем нажмите «Открыть» в диалоговом окне подтверждения.
Введите свой пароль, если вам будет предложено.
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:
Note that Gatekeeper will re-enable itself when macOS updates.
App is not signed, executable is linker-signed¶
Примечание
Приложение создано с использованием официальных шаблонов экспорта, но не подписано.
При первом запуске приложения отображается следующее диалоговое окно:
Чтобы запустить это приложение, вы должны удалить атрибут расширенного файла карантина вручную:
Open
Terminal.app
(press Cmd + Space and enterTerminal
).Перейдите в папку, содержащую целевое приложение.
Используйте команду
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 и вообще не подписано.
При первом запуске приложения отображается следующее диалоговое окно:
Чтобы запустить это приложение, вы можете для данного случая подписать его самостоятельно:
Install
Xcode
for the App Store, start it and confirm command line tools installation.Open
Terminal.app
(press Cmd + Space and enterTerminal
).Перейдите в папку, содержащую целевое приложение.
Используйте команду
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").