Up to date
This page is up to date for Godot 4.2.
If you still find outdated information, please open an issue.
EditorExportPlatformMacOS¶
继承： EditorExportPlatform < RefCounted < Object
macOS 导出器。
教程¶
属性¶
属性说明¶
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 版本。