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.

EditorExportPlatformIOS

Inherits: EditorExportPlatform < RefCounted < Object

Exporter for iOS.

Tutorials

Properties

String

application/additional_plist_content

String

application/app_store_team_id

String

application/bundle_identifier

String

application/code_sign_identity_debug

String

application/code_sign_identity_release

int

application/export_method_debug

int

application/export_method_release

bool

application/export_project_only

int

application/icon_interpolation

String

application/min_ios_version

String

application/provisioning_profile_uuid_debug

String

application/provisioning_profile_uuid_release

String

application/short_version

String

application/signature

int

application/targeted_device_family

String

application/version

bool

architectures/arm64

bool

capabilities/access_wifi

bool

capabilities/performance_a12

bool

capabilities/performance_gaming_tier

bool

capabilities/push_notifications

String

custom_template/debug

String

custom_template/release

String

icons/app_store_1024x1024

String

icons/ipad_76x76

String

icons/ipad_152x152

String

icons/ipad_167x167

String

icons/iphone_120x120

String

icons/iphone_180x180

String

icons/notification_40x40

String

icons/notification_60x60

String

icons/settings_58x58

String

icons/settings_87x87

String

icons/spotlight_40x40

String

icons/spotlight_80x80

String

privacy/camera_usage_description

Dictionary

privacy/camera_usage_description_localized

String

privacy/microphone_usage_description

Dictionary

privacy/microphone_usage_description_localized

String

privacy/photolibrary_usage_description

Dictionary

privacy/photolibrary_usage_description_localized

Color

storyboard/custom_bg_color

String

storyboard/custom_image@2x

String

storyboard/custom_image@3x

int

storyboard/image_scale_mode

bool

storyboard/use_custom_bg_color

bool

user_data/accessible_from_files_app

bool

user_data/accessible_from_itunes_sharing


Property Descriptions

String application/additional_plist_content

Additional data added to the root <dict> section of the Info.plist file. The value should be an XML section with pairs of key-value elements, e.g.:

<key>key_name</key>
<string>value</string>

String application/app_store_team_id

Apple Team ID, unique 10-character string. To locate your Team ID check "Membership details" section in your Apple developer account dashboard, or "Organizational Unit" of your code signing certificate. See Locate your Team ID.


String application/bundle_identifier

Unique application identifier in a reverse-DNS format, can only contain alphanumeric characters (A-Z, a-z, and 0-9), hyphens (-), and periods (.).


String application/code_sign_identity_debug

The "Full Name", "Common Name" or SHA-1 hash of the signing identity used for debug export.


String application/code_sign_identity_release

The "Full Name", "Common Name" or SHA-1 hash of the signing identity used for release export.


int application/export_method_debug

Application distribution target (debug export).


int application/export_method_release

Application distribution target (release export).


bool application/export_project_only

If true, exports iOS project files without building an XCArchive or .ipa file. If false, exports iOS project files and builds an XCArchive and .ipa file at the same time. When combining Godot with Fastlane or other build pipelines, you may want to set this to true.


int application/icon_interpolation

Interpolation method used to resize application icon.


String application/min_ios_version

Minimum version of iOS required for this application to run in the major.minor.patch or major.minor format, can only contain numeric characters (0-9) and periods (.).


String application/provisioning_profile_uuid_debug

UUID of the provisioning profile. If left empty, Xcode will download or create a provisioning profile automatically. See Edit, download, or delete provisioning profiles.

Can be overridden with the environment variable GODOT_IOS_PROVISIONING_PROFILE_UUID_DEBUG.


String application/provisioning_profile_uuid_release

UUID of the provisioning profile. If left empty, Xcode will download or create a provisioning profile automatically. See Edit, download, or delete provisioning profiles.

Can be overridden with the environment variable GODOT_IOS_PROVISIONING_PROFILE_UUID_RELEASE.


String application/short_version

Application version visible to the user, can only contain numeric characters (0-9) and periods (.). Falls back to ProjectSettings.application/config/version if left empty.


String application/signature

A four-character creator code that is specific to the bundle. Optional.


int application/targeted_device_family

Supported device family.


String application/version

Machine-readable application version, in the major.minor.patch format, can only contain numeric characters (0-9) and periods (.). This must be incremented on every new release pushed to the App Store.


bool architectures/arm64

If true, arm64 binaries are included into exported project.


bool capabilities/access_wifi

If true, networking features related to Wi-Fi access are enabled. See Required Device Capabilities.


bool capabilities/performance_a12

Requires the graphics performance and features of the A12 Bionic and later chips (devices supporting all Vulkan renderer features).

Enabling this option limits supported devices to: iPhone XS, iPhone XR, iPad Mini (5th gen.), iPad Air (3rd gen.), iPad (8th gen) and newer.


bool capabilities/performance_gaming_tier

Requires the graphics performance and features of the A17 Pro and later chips.

Enabling this option limits supported devices to: iPhone 15 Pro and newer.


bool capabilities/push_notifications

If true, push notifications are enabled. See Required Device Capabilities.


String custom_template/debug

Path to the custom export template. If left empty, default template is used.


String custom_template/release

Path to the custom export template. If left empty, default template is used.


String icons/app_store_1024x1024

App Store application icon file. If left empty, it will fallback to ProjectSettings.application/config/icon. See App icons.


String icons/ipad_76x76

Home screen application icon file on iPad (1x DPI). If left empty, it will fallback to ProjectSettings.application/config/icon. See App icons.


String icons/ipad_152x152

Home screen application icon file on iPad (2x DPI). If left empty, it will fallback to ProjectSettings.application/config/icon. See App icons.


String icons/ipad_167x167

Home screen application icon file on iPad (3x DPI). If left empty, it will fallback to ProjectSettings.application/config/icon. See App icons.


String icons/iphone_120x120

Home screen application icon file on iPhone (2x DPI). If left empty, it will fallback to ProjectSettings.application/config/icon. See App icons.


String icons/iphone_180x180

Home screen application icon file on iPhone (3x DPI). If left empty, it will fallback to ProjectSettings.application/config/icon. See App icons.


String icons/notification_40x40

Notification icon file on iPad and iPhone (2x DPI). If left empty, it will fallback to ProjectSettings.application/config/icon. See App icons.


String icons/notification_60x60

Notification icon file on iPhone (3x DPI). If left empty, it will fallback to ProjectSettings.application/config/icon. See App icons.


String icons/settings_58x58

Application settings icon file on iPad and iPhone (2x DPI). If left empty, it will fallback to ProjectSettings.application/config/icon. See App icons.


String icons/settings_87x87

Application settings icon file on iPhone (3x DPI). If left empty, it will fallback to ProjectSettings.application/config/icon. See App icons.


String icons/spotlight_40x40

Spotlight icon file on iPad (1x DPI). If left empty, it will fallback to ProjectSettings.application/config/icon. See App icons.


String icons/spotlight_80x80

Spotlight icon file on iPad and iPhone (2x DPI). If left empty, it will fallback to ProjectSettings.application/config/icon. See App icons.


String privacy/camera_usage_description

A message displayed when requesting access to the device's camera (in English).


Dictionary privacy/camera_usage_description_localized

A message displayed when requesting access to the device's camera (localized).


String privacy/microphone_usage_description

A message displayed when requesting access to the device's microphone (in English).


Dictionary privacy/microphone_usage_description_localized

A message displayed when requesting access to the device's microphone (localized).


String privacy/photolibrary_usage_description

A message displayed when requesting access to the user's photo library (in English).


Dictionary privacy/photolibrary_usage_description_localized

A message displayed when requesting access to the user's photo library (localized).


Color storyboard/custom_bg_color

A custom background color of the storyboard launch screen.


String storyboard/custom_image@2x

Application launch screen image file (2x DPI). If left empty, it will fallback to ProjectSettings.application/boot_splash/image.


String storyboard/custom_image@3x

Application launch screen image file (3x DPI). If left empty, it will fallback to ProjectSettings.application/boot_splash/image.


int storyboard/image_scale_mode

Launch screen image scaling mode.


bool storyboard/use_custom_bg_color

If true, storyboard/custom_bg_color is used as a launch screen background color, otherwise application/boot_splash/bg_color project setting is used.


bool user_data/accessible_from_files_app

If true, the app "Documents" folder can be accessed via "Files" app. See LSSupportsOpeningDocumentsInPlace.


bool user_data/accessible_from_itunes_sharing

If true, the app "Documents" folder can be accessed via iTunes file sharing. See UIFileSharingEnabled.


User-contributed notes

Please read the User-contributed notes policy before submitting a comment.