Exporter for Android.
A list of additional command line arguments, separated by space, which the exported project will receive when started.
Path to an APK file to use as a custom export template for debug exports. If left empty, default template is used.
Note: This is only used if gradle_build/use_gradle_build is disabled.
Path to an APK file to use as a custom export template for release exports. If left empty, default template is used.
Note: This is only used if gradle_build/use_gradle_build is disabled.
If true, Swipe to dismiss will be enabled.
This functionality is intended for smartwatches and is generally ignored on standard Android devices. However, some devices may not ignore it. Therefore, it is recommended to keep this feature disabled for standard Android apps to avoid unexpected behavior.
Note: This is false by default. To enable this behavior, gradle_build/use_gradle_build is required.
Path to a ZIP file holding the source for the export template used in a Gradle build. If left empty, the default template is used.
If true, native libraries are compressed when performing a Gradle build.
Note: While enabling compression can reduce the size of the binary, it may result in slower application startup because the native libraries must be extracted before use, rather than being loaded directly.
If you're distributing your app via the Play Store, it's generally recommended to keep this option false, see official documentation.
A dictionary of custom theme attributes to include in the exported Android project. Each entry defines a theme attribute name and its value, and will be added to the GodotAppMainTheme.
For example, the key android:windowSwipeToDismiss with the value false is resolved to <item name="android:windowSwipeToDismiss">false</item>.
Note: To add a custom attribute to the GodotAppSplashTheme, prefix the attribute name with [splash].
Note: Reserved attributes configured via other export options or project settings cannot be overridden by custom_theme_attributes and are skipped during export.
Minimum Android API level required for the application to run (used during Gradle build). See android:minSdkVersion.
The Android API level on which the application is designed to run (used during Gradle build). See android:targetSdkVersion.
If true, OpenGL ES debug context will be created (additional runtime checking, validation, and logging).
Path of the debug keystore file.
Can be overridden with the environment variable GODOT_ANDROID_KEYSTORE_DEBUG_PATH.
Fallbacks to EditorSettings.export/android/debug_keystore if empty.
Password for the debug keystore file.
Can be overridden with the environment variable GODOT_ANDROID_KEYSTORE_DEBUG_PASSWORD.
Fallbacks to EditorSettings.export/android/debug_keystore_pass if both it and keystore/debug are empty.
User name for the debug keystore file.
Can be overridden with the environment variable GODOT_ANDROID_KEYSTORE_DEBUG_USER.
Fallbacks to EditorSettings.export/android/debug_keystore_user if both it and keystore/debug are empty.
Path of the release keystore file.
Can be overridden with the environment variable GODOT_ANDROID_KEYSTORE_RELEASE_PATH.
Password for the release keystore file.
Can be overridden with the environment variable GODOT_ANDROID_KEYSTORE_RELEASE_PASSWORD.
User name for the release keystore file.
Can be overridden with the environment variable GODOT_ANDROID_KEYSTORE_RELEASE_USER.
Background layer of the application adaptive icon file. See Design adaptive icons.
Foreground layer of the application adaptive icon file. See Design adaptive icons.
Monochrome layer of the application adaptive icon file. See Design adaptive icons.
Application icon file. If left empty, it will fallback to ProjectSettings.application/config/icon.
Application category for the Google Play Store. Only define this if your application fits one of the categories well. See android:appCategory.
If true, task initiated by main activity will be excluded from the list of recently used applications. See android:excludeFromRecents.
If true, when the user uninstalls an app, a prompt to keep the app's data will be shown. See android:hasFragileUserData.
Unique application identifier in a reverse-DNS format. The reverse DNS format should preferably match a domain name you control, but this is not strictly required. For instance, if you own example.com, your package unique name should preferably be of the form com.example.mygame. This identifier can only contain lowercase alphanumeric characters (a-z, and 0-9), underscores (_), and periods (.). Each component of the reverse DNS format must start with a letter: for instance, com.example.8game is not valid.
If $genname is present in the value, it will be replaced by the project name converted to lowercase. If there are invalid characters in the project name, they will be stripped. If all characters in the project name are stripped, $genname is replaced by noname.
Note: Changing the package name will cause the package to be considered as a new package, with its own installation and data paths. The new package won't be usable to update existing installations.
Note: When publishing to Google Play, the package name must be globally unique. This means no other apps published on Google Play must be using the same package name as yours. Otherwise, you'll be prevented from publishing your app on Google Play.
Allows read/write access to the "properties" table in the checkin database. See ACCESS_CHECKIN_PROPERTIES.
Allows access to the approximate location information. See ACCESS_COARSE_LOCATION.
Allows access to the precise location information. See ACCESS_FINE_LOCATION.
Allows access to the extra location provider commands. See ACCESS_LOCATION_EXTRA_COMMANDS.
Allows an application to access any geographic locations persisted in the user's shared collection. See ACCESS_MEDIA_LOCATION.
Allows access to the information about networks. See ACCESS_NETWORK_STATE.
Allows access to the information about Wi-Fi networks. See ACCESS_WIFI_STATE.
Allows applications to call into AccountAuthenticators. See ACCOUNT_MANAGER.
Allows an application to add voicemails into the system. See ADD_VOICEMAIL.
Allows an application to collect battery statistics. See BATTERY_STATS.
Must be required by an AccessibilityService, to ensure that only the system can bind to it. See BIND_ACCESSIBILITY_SERVICE.
Allows an application to tell the AppWidget service which application can access AppWidget's data. See BIND_APPWIDGET.
Must be required by device administration receiver, to ensure that only the system can interact with it. See BIND_DEVICE_ADMIN.
Must be required by an InputMethodService, to ensure that only the system can bind to it. See BIND_INPUT_METHOD.
Must be required by a HostApduService or OffHostApduService to ensure that only the system can bind to it. See BIND_NFC_SERVICE.
Must be required by a NotificationListenerService, to ensure that only the system can bind to it. See BIND_NOTIFICATION_LISTENER_SERVICE.
Must be required by a PrintService, to ensure that only the system can bind to it. See BIND_PRINT_SERVICE.
Must be required by a RemoteViewsService, to ensure that only the system can bind to it. See BIND_REMOTEVIEWS.
Must be required by a TextService (e.g. SpellCheckerService) to ensure that only the system can bind to it. See BIND_TEXT_SERVICE.
Must be required by a VpnService, to ensure that only the system can bind to it. See BIND_VPN_SERVICE.
Must be required by a WallpaperService, to ensure that only the system can bind to it. See BIND_WALLPAPER.
Allows applications to connect to paired bluetooth devices. See BLUETOOTH.
Allows applications to discover and pair bluetooth devices. See BLUETOOTH_ADMIN.
Allows applications to pair bluetooth devices without user interaction, and to allow or disallow phonebook access or message access. See BLUETOOTH_PRIVILEGED.
Allows an application to broadcast a notification that an application package has been removed. See BROADCAST_PACKAGE_REMOVED.
Allows an application to broadcast an SMS receipt notification. See BROADCAST_SMS.
Allows an application to broadcast sticky intents. See BROADCAST_STICKY.
Allows an application to broadcast a WAP PUSH receipt notification. See BROADCAST_WAP_PUSH.
Allows an application to initiate a phone call without going through the Dialer user interface. See CALL_PHONE.
Allows an application to call any phone number, including emergency numbers, without going through the Dialer user interface. See CALL_PRIVILEGED.
Allows an application to capture audio output. See CAPTURE_AUDIO_OUTPUT.
Allows an application to change whether an application component (other than its own) is enabled or not. See CHANGE_COMPONENT_ENABLED_STATE.
Allows an application to modify the current configuration, such as locale. See CHANGE_CONFIGURATION.
Allows applications to change network connectivity state. See CHANGE_NETWORK_STATE.
Allows applications to enter Wi-Fi Multicast mode. See CHANGE_WIFI_MULTICAST_STATE.
Allows applications to change Wi-Fi connectivity state. See CHANGE_WIFI_STATE.
Allows an application to clear the caches of all installed applications on the device. See CLEAR_APP_CACHE.
Allows enabling/disabling location update notifications from the radio. See CONTROL_LOCATION_UPDATES.
Allows applications to disable the keyguard if it is not secure. See DISABLE_KEYGUARD.
Allows an application to retrieve state dump information from system services. See DUMP.
Allows an application to expand or collapse the status bar. See EXPAND_STATUS_BAR.
Run as a manufacturer test application, running as the root user. See FACTORY_TEST.
Allows access to the list of accounts in the Accounts Service. See GET_ACCOUNTS.
Allows an application to find out the space used by any package. See GET_PACKAGE_SIZE.
Used on content providers to allow the global search system to access their data. See GLOBAL_SEARCH.
Allows an application to inject user events (keys, touch, trackball) into the event stream and deliver them to ANY window.
Allows an application to install a location provider into the Location Manager. See INSTALL_LOCATION_PROVIDER.
Allows an application to install packages. See INSTALL_PACKAGES.
Allows an application to install a shortcut in Launcher. See INSTALL_SHORTCUT.
Allows an application to call ActivityManager.killBackgroundProcesses(String). See KILL_BACKGROUND_PROCESSES.
Allows an application to use location features in hardware, such as the geofencing api. See LOCATION_HARDWARE.
Allows an application to manage (create, destroy, Z-order) application tokens in the window manager.
Allows an application to manage access to documents, usually as part of a document picker. See MANAGE_DOCUMENTS.
Allows an application a broad access to external storage in scoped storage. See MANAGE_EXTERNAL_STORAGE.
Allows an application to modify and delete media files on this device or any connected storage device without user confirmation. Applications must already be granted the READ_EXTERNAL_STORAGE or MANAGE_EXTERNAL_STORAGE permissions for this permission to take effect. See MANAGE_MEDIA.
Allows an application to know what content is playing and control its playback. See MEDIA_CONTENT_CONTROL.
Allows an application to modify global audio settings. See MODIFY_AUDIO_SETTINGS.
Allows modification of the telephony state - power on, mmi, etc. Does not include placing calls. See MODIFY_PHONE_STATE.
Allows formatting file systems for removable storage. See MOUNT_FORMAT_FILESYSTEMS.
Allows mounting and unmounting file systems for removable storage. See MOUNT_UNMOUNT_FILESYSTEMS.
Allows an application to post notifications. Added in API level 33. See Notification runtime permission.
Allows an application to see the number being dialed during an outgoing call with the option to redirect the call to a different number or abort the call altogether. See PROCESS_OUTGOING_CALLS.
Allows an application to read the user's calendar data. See READ_CALENDAR.
Allows an application to read the user's call log. See READ_CALL_LOG.
Allows an application to read the user's contacts data. See READ_CONTACTS.
Allows an application to read from external storage. See READ_EXTERNAL_STORAGE.
Allows an application to read the low-level system log files. See READ_LOGS.
Allows an application to read audio files from external storage. See READ_MEDIA_AUDIO.
Allows an application to read image files from external storage. See READ_MEDIA_IMAGES.
Allows an application to read video files from external storage. See READ_MEDIA_VIDEO.
Allows an application to read image or video files from external storage that a user has selected via the permission prompt photo picker. See READ_MEDIA_VISUAL_USER_SELECTED.
Allows applications to read the sync settings. See READ_SYNC_SETTINGS.
Allows applications to read the sync stats. See READ_SYNC_STATS.
Allows an application to receive the Intent.ACTION_BOOT_COMPLETED that is broadcast after the system finishes booting. See RECEIVE_BOOT_COMPLETED.
Allows an application to monitor incoming MMS messages. See RECEIVE_MMS.
Allows an application to receive WAP push messages. See RECEIVE_WAP_PUSH.
Allows an application to change the Z-order of tasks. See REORDER_TASKS.
Allows an application (Phone) to send a request to other applications to handle the respond-via-message action during incoming calls. See SEND_RESPOND_VIA_MESSAGE.
Allows an application to broadcast an Intent to set an alarm for the user. See SET_ALARM.
Allows an application to control whether activities are immediately finished when put in the background. See SET_ALWAYS_FINISH.
Allows to modify the global animation scaling factor. See SET_ANIMATION_SCALE.
Allows an application to set the maximum number of (not needed) application processes that can be running. See SET_PROCESS_LIMIT.
Allows applications to set the system time zone directly. See SET_TIME_ZONE.
Allows applications to set the wallpaper hints. See SET_WALLPAPER_HINTS.
Allow an application to request that a signal be sent to all persistent processes. See SIGNAL_PERSISTENT_PROCESSES.
Allows an application to open, close, or disable the status bar and its icons. See STATUS_BAR.
Allows an app to create windows using the type WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY, shown on top of all other apps. See SYSTEM_ALERT_WINDOW.
Allows using the device's IR transmitter, if available. See TRANSMIT_IR.
Allows an application to update device statistics. See UPDATE_DEVICE_STATS.
Allows using PowerManager WakeLocks to keep processor from sleeping or screen from dimming. See WAKE_LOCK.
Allows applications to write the apn settings and read sensitive fields of an existing apn settings like user and password. See WRITE_APN_SETTINGS.
Allows an application to write the user's calendar data. See WRITE_CALENDAR.
Allows an application to write (but not read) the user's call log data. See WRITE_CALL_LOG.
Allows an application to write the user's contacts data. See WRITE_CONTACTS.
Allows an application to write to external storage. See WRITE_EXTERNAL_STORAGE.
Allows an application to modify the Google service map. See WRITE_GSERVICES.
Allows an application to read or write the secure system settings. See WRITE_SECURE_SETTINGS.
Allows an application to read or write the system settings. See WRITE_SETTINGS.
Allows applications to write the sync settings. See WRITE_SYNC_SETTINGS.
The background color used for the root window. By default it's Color.BLACK.
If true, this makes the navigation and status bars translucent and allows the application content to extend edge to edge.
Note: You should ensure that none of the application content is occluded by system elements by using the DisplayServer.get_display_safe_area() and DisplayServer.get_display_cutouts() methods.
If true, hides the navigation and status bar. Set DisplayServer.window_set_mode() to change this at runtime.
If true, shaders will be compiled and embedded in the application. This option is only supported when using the Forward+ or Mobile renderers.
Note: When exporting as a dedicated server, the shader baker is always disabled since no rendering is performed.
The background color used for the system splash screen window.
If not set, it will fallback to launcher_icons/adaptive_background_432x432.
Note: This is only applied if gradle_build/use_gradle_build is enabled.
System splash screen branding image file. If left empty, no branding image will be used. See splash-screen dimensions.
Note: Can be used to set an image to be shown at the bottom of the splash screen.
If true, Godot's boot splash will not be shown, and the system boot splash will remain visible for a longer time, until the mainloop starts.
System splash screen icon file. If left empty, it will fall back to launcher_icons/adaptive_foreground_432x432. See splash-screen dimensions.
Note: You can provide an AnimatedVectorDrawable (AVD) XML. However, the XML file will only be used if gradle_build/use_gradle_build is enabled. If not, it will fall back to launcher_icons/adaptive_background_432x432.
Machine-readable application version. This must be incremented for every new release pushed to the Play Store.
Application version visible to the user. Falls back to ProjectSettings.application/config/version if left empty.