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.

EditorExportPlatformMacOS

继承: EditorExportPlatform < RefCounted < Object

macOS 导出器。

教程

属性

String

application/app_category

String

application/bundle_identifier

String

application/copyright

Dictionary

application/copyright_localized

int

application/export_angle

String

application/icon

int

application/icon_interpolation

String

application/min_macos_version

String

application/short_version

String

application/signature

String

application/version

String

binary_format/architecture

String

codesign/apple_team_id

String

codesign/certificate_file

String

codesign/certificate_password

int

codesign/codesign

PackedStringArray

codesign/custom_options

bool

codesign/entitlements/address_book

bool

codesign/entitlements/allow_dyld_environment_variables

bool

codesign/entitlements/allow_jit_code_execution

bool

codesign/entitlements/allow_unsigned_executable_memory

bool

codesign/entitlements/app_sandbox/device_bluetooth

bool

codesign/entitlements/app_sandbox/device_usb

bool

codesign/entitlements/app_sandbox/enabled

int

codesign/entitlements/app_sandbox/files_downloads

int

codesign/entitlements/app_sandbox/files_movies

int

codesign/entitlements/app_sandbox/files_music

int

codesign/entitlements/app_sandbox/files_pictures

int

codesign/entitlements/app_sandbox/files_user_selected

Array

codesign/entitlements/app_sandbox/helper_executables

bool

codesign/entitlements/app_sandbox/network_client

bool

codesign/entitlements/app_sandbox/network_server

bool

codesign/entitlements/apple_events

bool

codesign/entitlements/audio_input

bool

codesign/entitlements/calendars

bool

codesign/entitlements/camera

String

codesign/entitlements/custom_file

bool

codesign/entitlements/debugging

bool

codesign/entitlements/disable_library_validation

bool

codesign/entitlements/location

bool

codesign/entitlements/photos_library

String

codesign/identity

String

codesign/installer_identity

String

codesign/provisioning_profile

String

custom_template/debug

String

custom_template/release

int

debug/export_console_wrapper

bool

display/high_res

int

export/distribution_type

String

notarization/api_key

String

notarization/api_key_id

String

notarization/api_uuid

String

notarization/apple_id_name

String

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

bool

ssh_remote_deploy/enabled

String

ssh_remote_deploy/extra_args_scp

String

ssh_remote_deploy/extra_args_ssh

String

ssh_remote_deploy/host

String

ssh_remote_deploy/port

String

ssh_remote_deploy/run_script

String

xcode/platform_build

String

xcode/sdk_build

String

xcode/sdk_name

String

xcode/sdk_version

String

xcode/xcode_build

String

xcode/xcode_version


属性说明

String application/app_category

App Store 的应用程序分类。


String application/bundle_identifier

反向 DNS 格式的唯一应用程序标识符,只能包含字母数字字符(A-Za-z0-9)、连字符(-)和句点(.)。


捆绑包的(英文)版权声明,用户可见。


捆绑包的(本地化)版权声明,用户可见。


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_64arm64universalx86_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 版本。