EditorExportPlatformMacOS

继承： EditorExportPlatform < RefCounted < Object

macOS 导出器。

教程

• 为 macOS 导出

• 在 macOS 上运行 Godot 应用

属性

属性说明

String application/app_category

App Store 的应用程序分类。

String application/bundle_identifier

反向 DNS 格式的唯一应用程序标识符，只能包含字母数字字符（A-Z、a-z 和 0-9）、连字符（-）和句点（.）。

String application/copyright

捆绑包的（英文）版权声明，用户可见。

Dictionary application/copyright_localized

捆绑包的（本地化）版权声明，用户可见。

int application/export_angle

如果设置为 1，ANGLE 库将随导出的应用程序一起导出。如果设置为 0，则仅当 ProjectSettings.rendering/gl_compatibility/driver 被设置为 "opengl3_angle" 时才会导出 ANGLE 库。

String application/icon

应用程序图标文件。如果留空，则会回退至 ProjectSettings.application/config/macos_native_icon，继而回退至 ProjectSettings.application/config/icon。

int application/icon_interpolation

用于调整应用程序图标大小的插值方法。

String application/min_macos_version

运行该应用程序所需的最低 macOS 版本，格式为 主版本号.次版本号.补丁号 或 主版本号.次版本号，只能包含数字（0-9）和英文句点（.）。

String application/short_version

用户可见的应用程序版本，只能包含数字字符（0-9）和句点（.）。如果留空，则回退到 ProjectSettings.application/config/version。

String application/signature

特定于该捆绑包的四字符创建者码。可选的。

String application/version

机器可读的应用程序版本，采用 major.minor.patch 格式，只能包含数字字符（0-9）和句点（.）。该值必须在被推送到 App Store 的每个新版本中递增。

String binary_format/architecture

应用程序可执行文件的架构。

支持的架构有：x86_64、arm64、universal（x86_64 + arm64）。

官方导出模板中只包含 universal 的二进制文件。

String codesign/apple_team_id

Apple 团队 ID，唯一的 10 字符的字符串。要找到你的团队 ID，请检查 Apple 开发者帐户仪表板中的“会员详细信息”部分，或代码签名证书的“组织单位”。见 查找你的团队 ID。

String codesign/certificate_file

用于对 .app 捆绑包进行签名的 PKCS #12 证书文件。

可以使用环境变量 GODOT_MACOS_CODESIGN_CERTIFICATE_FILE 覆盖。

String codesign/certificate_password

用于对 .app 捆绑包进行签名的证书文件的密码。

可以使用环境变量 GODOT_MACOS_CODESIGN_CERTIFICATE_PASSWORD 覆盖。

int codesign/codesign

用于代码签名的工具。

PackedStringArray codesign/custom_options

要额外传给代码签名工具的命令行参数的数组。

bool codesign/entitlements/address_book

启用后允许访问用户地址簿中的联系人，如果启用，还应该在 privacy/address_book_usage_description 选项中提供用途信息。请参阅 com.apple.security.personal-information.addressbook。

bool codesign/entitlements/allow_dyld_environment_variables

允许应用使用动态链接器环境变量注入代码。如果你使用的插件使用了动态或自我修改的原生代码，请根据该插件文档中的说明启用。见 com.apple.security.cs.allow-dyld-environment-variables。

bool codesign/entitlements/allow_jit_code_execution

允许创建可写可执行内存，用于 JIT 代码。如果你使用的插件使用了动态或自我修改的原生代码，请根据该插件文档中的说明启用。见 com.apple.security.cs.allow-jit。

bool codesign/entitlements/allow_unsigned_executable_memory

允许创建可写可执行内存，不受 JIT 限制。如果你使用的插件使用了动态或自我修改的原生代码，请根据该插件文档中的说明启用。见 com.apple.security.cs.allow-unsigned-executable-memory。

bool codesign/entitlements/app_sandbox/device_bluetooth

启用后能够允许应用与蓝牙设备交互。使用无线控制器时，必须拥有这项权利。见 com.apple.security.device.bluetooth。

bool codesign/entitlements/app_sandbox/device_usb

启用后能够允许应用与 USB 设备交互。使用有线控制器时，必须拥有这项权利。见 com.apple.security.device.usb。

bool codesign/entitlements/app_sandbox/enabled

启用 App Sandbox 应用沙盒。App Sandbox 能够限制对用户数据、网络以及设备的访问。沙盒应用无法访问文件系统中的大部分区域，无法使用自定义文件对话框，也无法执行 .app 捆绑包之外的二进制文件。见 App Sandbox。

注意：通过 App Store 分发应用时必须启用 App Sandbox。

int codesign/entitlements/app_sandbox/files_downloads

允许对用户“下载”文件夹的读写访问。见 com.apple.security.files.downloads.read-write。

int codesign/entitlements/app_sandbox/files_movies

允许对用户“影片”文件夹的读写访问。见 com.apple.security.files.movies.read-write。

int codesign/entitlements/app_sandbox/files_music

允许对用户“音乐”文件夹的读写访问。见 com.apple.security.files.music.read-write。

int codesign/entitlements/app_sandbox/files_pictures

允许对用户“图片”文件夹的读写访问。见 com.apple.security.files.pictures.read-write。

int codesign/entitlements/app_sandbox/files_user_selected

允许对用户使用原生文件对话框选择的位置进行读或写访问。请参阅 com.apple.security.files.user-selected.read-write。

Array codesign/entitlements/app_sandbox/helper_executables

要嵌入应用捆绑包的辅助可执行文件列表。沙盒应用仅限于执行这些可执行文件。见 Embedding a command-line tool in a sandboxed app。

bool codesign/entitlements/app_sandbox/network_client

启用后允许应用建立出站的网络连接。见 com.apple.security.network.client。

bool codesign/entitlements/app_sandbox/network_server

启用后允许应用监听入站的网络连接。见 com.apple.security.network.server。

bool codesign/entitlements/apple_events

启用后允许应用向其他应用发送 Apple 事件。见 com.apple.security.automation.apple-events。

bool codesign/entitlements/audio_input

需要使用麦克风或其他音频输入源时启用，启用时还应在 privacy/microphone_usage_description 选项中提供用途信息。请参阅 com.apple.security.device.audio-input。

bool codesign/entitlements/calendars

启用后允许访问用户的日历，启用时还应在 privacy/calendar_usage_description 选项中提供用途信息。请参阅 com.apple.security.personal-information.calendars。

bool codesign/entitlements/camera

需要使用相机时启用，启用时还应在 privacy/camera_usage_description 选项中提供用途信息。请参阅 com.apple.security.device.camera。

String codesign/entitlements/custom_file

自定义权利 .plist 文件，如果指定，则会忽略导出配置中的其他权利。

bool codesign/entitlements/debugging

临时启用这个权利就可以对导出的应用使用原生调试器（GDB、LLDB）。生产导出应该禁用这项权利。见 Embedding a command-line tool in a sandboxed app。

bool codesign/entitlements/disable_library_validation

允许应用加载任意库和框架（没有使用与主可执行文件相同的团队 ID 进行签名，也没有经过 Apple 的签名）。如果你使用了 GDExtension 插件或 ad-hoc 签名，或者想要支持用户提供的外部插件，请启用该选项。见 com.apple.security.cs.disable-library-validation。

bool codesign/entitlements/location

需要使用位置服务中的位置信息时启用，启用时还应在 privacy/location_usage_description 选项中提供用途信息。请参阅 com.apple.security.personal-information.location。

bool codesign/entitlements/photos_library

启用后允许访问用户的照片库，启用时还应在 privacy/photos_library_usage_description 选项中提供用途消息。请参阅 com.apple.security.personal-information.photos-library。

String codesign/identity

用于对 .app 捆绑包进行签名的签名身份的“全名”“通用名”或 SHA-1 哈希。

String codesign/installer_identity

用于对通过 App Store 分发的 .pkg 安装器进行签名的签名身份的“全名”“通用名”或 SHA-1 哈希，使用 3rd Party Mac Developer Installer: Name. 身份。

String codesign/provisioning_profile

从 Apple 开发者账户控制面板下载到的预置描述文件。见 编辑、下载或删除预置描述文件。

可以使用环境变量 GODOT_MACOS_CODESIGN_PROVISIONING_PROFILE 覆盖。

String custom_template/debug

到自定义导出模板的路径。如果留空，则默认模板将被使用。

String custom_template/release

到自定义导出模板的路径。如果留空，则默认模板将被使用。

int debug/export_console_wrapper

启用后，会在导出后的应用程序旁创建一个封装程序，可以用来以带命令行输出的形式运行该应用程序。

bool display/high_res

如果为 true，则应用程序使用原生显示器分辨率渲染，否则始终使用 loDPI 分辨率渲染，必要时由操作系统放大。

int export/distribution_type

应用程序分发目标。

String notarization/api_key

Apple App Store Connect API 发行者密钥文件。

可以使用环境变量 GODOT_MACOS_NOTARIZATION_API_KEY 覆盖。

String notarization/api_key_id

Apple App Store Connect API 发行者密钥 ID。

可以使用环境变量 GODOT_MACOS_NOTARIZATION_API_KEY_ID 覆盖。

String notarization/api_uuid

Apple App Store Connect API 发行者 UUID。

可以使用环境变量 GODOT_MACOS_NOTARIZATION_API_UUID 覆盖。

String notarization/apple_id_name

Apple ID 账户名（邮箱地址）。

可以使用环境变量 GODOT_MACOS_NOTARIZATION_APPLE_ID_NAME 覆盖。

String notarization/apple_id_password

Apple ID 针对应用的密码。

可以使用环境变量 GODOT_MACOS_NOTARIZATION_APPLE_ID_PASSWORD 覆盖。

int notarization/notarization

用于公证的工具。

String privacy/address_book_usage_description

请求访问用户的联系人时显示的（英文）消息。

Dictionary privacy/address_book_usage_description_localized

请求访问用户的联系人时显示的（本地化）消息。

String privacy/calendar_usage_description

请求访问用户的日历数据时显示的（英文）消息。

Dictionary privacy/calendar_usage_description_localized

请求访问用户的日历数据时显示的（本地化）消息。

String privacy/camera_usage_description

请求访问设备相机时显示的（英文）消息。

Dictionary privacy/camera_usage_description_localized

请求访问设备相机时显示的（本地化）消息。

String privacy/desktop_folder_usage_description

请求访问用户的“桌面”文件夹时显示的（英文）消息。

Dictionary privacy/desktop_folder_usage_description_localized

请求访问用户的“桌面”文件夹时显示的（本地化）消息。

String privacy/documents_folder_usage_description

请求访问用户的“文档”文件夹时显示的（英文）消息。

Dictionary privacy/documents_folder_usage_description_localized

请求访问用户的“文档”文件夹时显示的（本地化）消息。

String privacy/downloads_folder_usage_description

请求访问用户的“下载”文件夹时显示的（英文）消息。

Dictionary privacy/downloads_folder_usage_description_localized

请求访问用户的“下载”文件夹时显示的（本地化）消息。

String privacy/location_usage_description

请求访问用户的位置信息时显示的（英文）消息。

Dictionary privacy/location_usage_description_localized

请求访问用户的位置信息时显示的（本地化）消息。

String privacy/microphone_usage_description

请求访问设备麦克风时显示的（英文）消息。

Dictionary privacy/microphone_usage_description_localized

请求访问设备麦克风时显示的（本地化）消息。

String privacy/network_volumes_usage_description

请求访问用户的网络驱动器时显示的（英文）消息。

Dictionary privacy/network_volumes_usage_description_localized

请求访问用户的网络驱动器时显示的（本地化）消息。

String privacy/photos_library_usage_description

请求访问用户照片图库时显示的（英文）消息。

Dictionary privacy/photos_library_usage_description_localized

请求访问用户照片图库时显示的（本地化）消息。

String privacy/removable_volumes_usage_description

请求访问用户的可移除驱动器时显示的（英文）消息。

Dictionary privacy/removable_volumes_usage_description_localized

请求访问用户的可移除驱动器时显示的（本地化）消息。

String ssh_remote_deploy/cleanup_script

应用结束时，要在远程主机上执行的脚本代码。

可以在脚本中使用以下变量：

• {temp_dir} - 远程的临时文件夹路径，用于上传应用和脚本。

• {archive_name} - 包含上传的应用程序的 ZIP 文件的名称。

• {exe_name} - 应用程序可执行文件的名称。

• {cmd_args} - 应用程序命令行参数的数组。

bool ssh_remote_deploy/enabled

启用通过 SSH/SCP 进行远程部署。

String ssh_remote_deploy/extra_args_scp

要传给 SCP 的额外命令行参数的数组。

String ssh_remote_deploy/extra_args_ssh

要传给 SSH 的额外命令行参数的数组。

String ssh_remote_deploy/host

远程主机 SSH 用户名及地址，格式为 用户名@地址。

String ssh_remote_deploy/port

远程主机 SSH 端口号。

String ssh_remote_deploy/run_script

运行应用时，要在远程主机上执行的脚本代码。

可以在脚本中使用以下变量：

• {temp_dir} - 远程的临时文件夹路径，用于上传应用和脚本。

• {archive_name} - 包含上传的应用程序的 ZIP 文件的名称。

• {exe_name} - 应用程序可执行文件的名称。

• {cmd_args} - 应用程序命令行参数的数组。

String xcode/platform_build

构建应用程序可执行文件所使用的 macOS 构建号。

String xcode/sdk_build

构建应用程序可执行文件所使用的 macOS SDK 构建号。

String xcode/sdk_name

构建应用程序可执行文件所使用的 macOS SDK 名称。

String xcode/sdk_version

构建应用程序可执行文件所使用的 macOS SDK 版本，格式为 主版本号.次版本号。

String xcode/xcode_build

构建应用程序可执行文件所使用的 Xcode 构建号。

String xcode/xcode_version

构建应用程序可执行文件所使用的 Xcode 版本。

Previous Next

© 版权所有 2014-present Juan Linietsky, Ariel Manzur and the Godot community (CC BY 3.0). Revision b1c660f7.

Built with Sphinx using a theme provided by Read the Docs.