Up to date
This page is up to date for Godot 4.2
.
If you still find outdated information, please open an issue.
Экспорт для macOS¶
См.также
This page describes how to export a Godot project to macOS. If you're looking to compile editor or export template binaries from source instead, read Compiling for macOS.
macOS apps exported with the official export templates are exported as a single "Universal 2" binary .app
bundle, a folder with a specific structure which stores the executable, libraries and all the project files.
This bundle can be exported as is, packed in a ZIP archive or DMG disk image (only supported when exporting from a computer running macOS).
Universal binaries for macOS support both Intel x86_64 and ARM64 (Apple silicon, i.e. M1) architectures.
Требования¶
Загрузите шаблоны экспорта Godot. Используйте меню Godot:
Editor > Manage Export Templates
.Действительный и уникальный идентификатор
Bundle
должен быть установлен в разделеApplication
вариантов экспорта.
Предупреждение
Проекты, экспортируемые без подписи кода и нотариализации, будут заблокированы Gatekeeper, если они будут загружены из неизвестных источников, см.:ref:Запуск Godot приложения на macOS <doc_running_on_macos> для получения дополнительной информации.
Code signing and notarization¶
По умолчанию macOS будет запускать только приложения, которые подписаны и нотариально заверены. Если вы используете любую другую конфигурацию подписи, см.:ref:Запуск Godot-приложения на macOS <doc_running_on_macos> для обходов.
Чтобы зафиксировать приложение, вы ** должны иметь действительный Apple Developer ID Certificate.
If you have an Apple Developer ID Certificate and exporting from macOS¶
Install Xcode command line tools and open Xcode at least once or run the sudo xcodebuild -license accept
command to accept license agreement.
To sign exported app¶
Select
Xcode codesign
in theCode Signing > Codesign
option.Set valid Apple ID certificate identity (certificate "Common Name") in the
Code Signing > Identity
section.
To notarize exported app¶
Select
Xcode altool
in theNotarization > Notarization
option.Disable the
Debugging
entitlement.Set valid Apple ID login / app. specific password or App Store Connect API UUID / Key in the
Notarization
section.
Вы можете использовать команду xcrun notarytool History
для проверки статуса нотариального заверения и использовать команду xcrun notarytool log {ID}
для загрузки журнала нотариального заверения.
Если у вас возникли проблемы с нотариальным заверением, дополнительную информацию см. в разделе «Решение распространённых проблем с нотариальным заверением <https://developer.apple.com/documentation/security/notarizing_macos_software_before_distribution/resolve_common_notarization_issues>».
After notarization is completed, staple the ticket to the exported project.
If you have an Apple Developer ID Certificate and exporting from Linux or Windows¶
Install PyOxidizer rcodesign, and configure the path to rcodesign
in the Editor Settings > Export > macOS > rcodesign
.
To sign exported app¶
Select
PyOxidizer rcodesign
in theCode Signing > Codesign
option.Set valid Apple ID PKCS #12 certificate file and password in the
Code Signing
section.
To notarize exported app¶
Select
PyOxidizer rcodesign
in theNotarization > Notarization
option.Disable the
Debugging
entitlement.Set valid App Store Connect API UUID / Key in the
Notarization
section.
You can use the rcodesign notary-log
command to check notarization status.
After notarization is completed, use the rcodesign staple
command to staple the ticket to the exported project.
Если у вас нет сертификата Apple Developer ID¶
Select
Built-in (ad-hoc only)
in theCode Signing > Codesign
option.Select
Disabled
in theNotarization > Notarization
option.
In this case Godot will use a ad-hoc signature, which will make running an exported app easier for the end users, see the Running Godot apps on macOS page for more information.
Signing Options¶
Option |
Описание |
---|---|
Codesign |
Tool to use for code signing. |
Identity |
The "Full Name" or "Common Name" of the signing identity, store in the macOS keychain. 1 |
Certificate File |
The PKCS #12 certificate file. 2 |
Certificate Password |
Password for the certificate file. 2 |
Custom Options |
Array of command line arguments passed to the code signing tool. |
Notarization Options¶
Option |
Описание |
---|---|
Notarization |
Tool to use for notarization. |
Имя Apple ID |
Apple ID account name (email address). 3 |
Пароль Apple ID |
Apple ID app-specific password. See Using app-specific passwords to enable two-factor authentication and create app password. 3 |
Apple ID команды |
Team ID ("Organization Unit"), if your Apple ID belongs to multiple teams (optional). 3 |
API UUID |
Apple App Store Connect API issuer UUID. |
API Key |
Apple App Store Connect API key. |
Примечание
You should set either Apple ID Name/Password or App Store Connect API UUID/Key.
See Notarizing macOS Software Before Distribution for more info.
Entitlements¶
Hardened Runtime Entitlements¶
Hardened Runtime entitlements manage security options and resource access policy. See Hardened Runtime for more info.
Entitlement |
Описание |
---|---|
Allow JIT Code Execution 4 |
Allows creating writable and executable memory for JIT code. If you are using add-ons with dynamic or self-modifying native code, enable them according to the add-on documentation. |
Allow Unsigned Executable Memory 4 |
Allows creating writable and executable memory without JIT restrictions. If you are using add-ons with dynamic or self-modifying native code, enable them according to the add-on documentation. |
Allow DYLD Environment Variables 4 |
Allows app to uss dynamic linker environment variables to inject code. If you are using add-ons with dynamic or self-modifying native code, enable them according to the add-on documentation. |
Отключить валидацию библиотеки |
Allows app to load arbitrary libraries and frameworks. Enable it if you are using GDExtension add-ons or ad-hoc signing, or want to support user-provided external add-ons. |
Аудио вход |
Enable if you need to use the microphone or other audio input sources, if it's enabled you should also provide usage message in the privacy/microphone_usage_description option. |
Камера |
Enable if you need to use the camera, if it's enabled you should also provide usage message in the privacy/camera_usage_description option. |
Расположение |
Enable if you need to use location information from Location Services, if it's enabled you should also provide usage message in the privacy/location_usage_description option. |
Адресная книга |
5 Enable to allow access contacts in the user's address book, if it's enabled you should also provide usage message in the privacy/address_book_usage_description option. |
Календари |
5 Enable to allow access to the user's calendar, if it's enabled you should also provide usage message in the privacy/calendar_usage_description option. |
Photo Library |
5 Enable to allow access to the user's Photos library, if it's enabled you should also provide usage message in the privacy/photos_library_usage_description option. |
Apple события |
5 Enable to allow app to send Apple events to other apps. |
Отладка |
6 You can temporarily enable this entitlement to use native debugger (GDB, LLDB) with the exported app. This entitlement should be disabled for production export. |
- 4(1,2,3)
The
Allow JIT Code Execution
,Allow Unsigned Executable Memory
andAllow DYLD Environment Variables
entitlements are always enabled for the Godot Mono exports, and are not visible in the export options.- 5(1,2,3,4)
Эти функции не поддерживаются Godot по умолчанию, включайте их только в том случае, если вы используете дополнения, которые их требуют.
- 6
To notarize an app, you must disable the
Debugging
entitlement.
App Sandbox Entitlement¶
The App Sandbox restricts access to user data, networking and devices.
Sandboxed apps can't access most of the file system, can't use custom file dialogs and execute binaries (using OS.execute
and OS.create_process
) outside the .app
bundle.
See App Sandbox for more info.
Примечание
To distribute an app through the App Store, you must enable the App Sandbox.
Entitlement |
Описание |
---|---|
Включено |
Enables App Sandbox. |
Сетевой сервер |
Включите, чтобы приложение могло прослушивать входящие сетевые подключения. |
Сетевой клиент |
Включите, чтобы разрешить приложению устанавливать исходящие сетевые подключения. |
Устройство USB |
Enable to allow app to interact with USB devices. This entitlement is required to use wired controllers. |
Устройство Bluetooth |
Включить, чтобы разрешить приложению взаимодействовать с Bluetooth устройствами. Это разрешение требуется для использования беспроводных контроллеров. |
Files Downloads 7 |
Разрешает доступ для чтения или записи в папку пользователя "Загрузки". |
Files Pictures 7 |
Allows read or write access to the user's "Pictures" folder. |
Files Music 7 |
Разрешает доступ для чтения или записи в папку пользователя "Музыка". |
Files Movies 7 |
Разрешает доступ для чтения или записи в папку пользователя "Видео". |
Files User Selected 7 |
Allows read or write access to arbitrary folder. To gain access, a folder must be selected from the native file dialog by the user. |
Helper Executable |
List of helper executables to embedded to the app bundle. Sandboxed app are limited to execute only these executable. |
- 7(1,2,3,4,5)
You can optionally provide usage messages for various folders in the privacy/*_folder_usage_description options.
Примечание
You can override default entitlements by selecting custom entitlements file, in this case all other entitlement are ignored.
Environment variables¶
You can use the following environment variables to set export options outside of the editor. During the export process, these override the values that you set in the export menu.
Export option |
Environment variable |
---|---|
Encryption / Encryption Key |
|
Options / Codesign / Certificate File |
|
Options / Codesign / Certificate Password |
|
Options / Codesign / Provisioning Profile |
|
Options / Notarization / API UUID |
|
Options / Notarization / API Key |
|
Options / Notarization / API Key ID |
|
Options / Notarization / Apple ID Name |
|
Options / Notarization / Apple ID Password |
|