123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579 |
- :github_url: hide
- .. DO NOT EDIT THIS FILE!!!
- .. Generated automatically from Godot engine sources.
- .. Generator: https://github.com/godotengine/godot/tree/4.1/doc/tools/make_rst.py.
- .. XML source: https://github.com/godotengine/godot/tree/4.1/platform/windows/doc_classes/EditorExportPlatformWindows.xml.
- .. _class_EditorExportPlatformWindows:
- EditorExportPlatformWindows
- ===========================
- **Inherits:** :ref:`EditorExportPlatformPC<class_EditorExportPlatformPC>` **<** :ref:`EditorExportPlatform<class_EditorExportPlatform>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
- Exporter for Windows.
- .. rst-class:: classref-introduction-group
- Tutorials
- ---------
- - :doc:`Exporting for Windows <../tutorials/export/exporting_for_windows>`
- .. rst-class:: classref-reftable-group
- Properties
- ----------
- .. table::
- :widths: auto
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`application/company_name<class_EditorExportPlatformWindows_property_application/company_name>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`application/console_wrapper_icon<class_EditorExportPlatformWindows_property_application/console_wrapper_icon>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`application/copyright<class_EditorExportPlatformWindows_property_application/copyright>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`application/file_description<class_EditorExportPlatformWindows_property_application/file_description>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`application/file_version<class_EditorExportPlatformWindows_property_application/file_version>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`application/icon<class_EditorExportPlatformWindows_property_application/icon>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`application/icon_interpolation<class_EditorExportPlatformWindows_property_application/icon_interpolation>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`application/modify_resources<class_EditorExportPlatformWindows_property_application/modify_resources>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`application/product_name<class_EditorExportPlatformWindows_property_application/product_name>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`application/product_version<class_EditorExportPlatformWindows_property_application/product_version>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`application/trademarks<class_EditorExportPlatformWindows_property_application/trademarks>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`binary_format/architecture<class_EditorExportPlatformWindows_property_binary_format/architecture>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`binary_format/embed_pck<class_EditorExportPlatformWindows_property_binary_format/embed_pck>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`PackedStringArray<class_PackedStringArray>` | :ref:`codesign/custom_options<class_EditorExportPlatformWindows_property_codesign/custom_options>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`codesign/description<class_EditorExportPlatformWindows_property_codesign/description>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`codesign/digest_algorithm<class_EditorExportPlatformWindows_property_codesign/digest_algorithm>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`codesign/enable<class_EditorExportPlatformWindows_property_codesign/enable>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`codesign/identity<class_EditorExportPlatformWindows_property_codesign/identity>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`codesign/identity_type<class_EditorExportPlatformWindows_property_codesign/identity_type>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`codesign/password<class_EditorExportPlatformWindows_property_codesign/password>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`codesign/timestamp<class_EditorExportPlatformWindows_property_codesign/timestamp>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`codesign/timestamp_server_url<class_EditorExportPlatformWindows_property_codesign/timestamp_server_url>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`custom_template/debug<class_EditorExportPlatformWindows_property_custom_template/debug>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`custom_template/release<class_EditorExportPlatformWindows_property_custom_template/release>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`debug/export_console_wrapper<class_EditorExportPlatformWindows_property_debug/export_console_wrapper>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`ssh_remote_deploy/cleanup_script<class_EditorExportPlatformWindows_property_ssh_remote_deploy/cleanup_script>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`ssh_remote_deploy/enabled<class_EditorExportPlatformWindows_property_ssh_remote_deploy/enabled>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`ssh_remote_deploy/extra_args_scp<class_EditorExportPlatformWindows_property_ssh_remote_deploy/extra_args_scp>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`ssh_remote_deploy/extra_args_ssh<class_EditorExportPlatformWindows_property_ssh_remote_deploy/extra_args_ssh>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`ssh_remote_deploy/host<class_EditorExportPlatformWindows_property_ssh_remote_deploy/host>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`ssh_remote_deploy/port<class_EditorExportPlatformWindows_property_ssh_remote_deploy/port>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`ssh_remote_deploy/run_script<class_EditorExportPlatformWindows_property_ssh_remote_deploy/run_script>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`texture_format/bptc<class_EditorExportPlatformWindows_property_texture_format/bptc>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`texture_format/etc<class_EditorExportPlatformWindows_property_texture_format/etc>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`texture_format/etc2<class_EditorExportPlatformWindows_property_texture_format/etc2>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`texture_format/s3tc<class_EditorExportPlatformWindows_property_texture_format/s3tc>` |
- +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+
- .. rst-class:: classref-section-separator
- ----
- .. rst-class:: classref-descriptions-group
- Property Descriptions
- ---------------------
- .. _class_EditorExportPlatformWindows_property_application/company_name:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **application/company_name**
- Company that produced the application. Required. See `StringFileInfo <https://learn.microsoft.com/en-us/windows/win32/menurc/stringfileinfo-block>`__.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_application/console_wrapper_icon:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **application/console_wrapper_icon**
- Console wrapper icon file. If left empty, it will fallback to :ref:`application/icon<class_EditorExportPlatformWindows_property_application/icon>`, then to :ref:`ProjectSettings.application/config/windows_native_icon<class_ProjectSettings_property_application/config/windows_native_icon>`, and lastly, :ref:`ProjectSettings.application/config/icon<class_ProjectSettings_property_application/config/icon>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_application/copyright:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **application/copyright**
- Copyright notice for the bundle visible to the user. Optional. See `StringFileInfo <https://learn.microsoft.com/en-us/windows/win32/menurc/stringfileinfo-block>`__.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_application/file_description:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **application/file_description**
- File description to be presented to users. Required. See `StringFileInfo <https://learn.microsoft.com/en-us/windows/win32/menurc/stringfileinfo-block>`__.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_application/file_version:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **application/file_version**
- Version number of the file. Required. See `StringFileInfo <https://learn.microsoft.com/en-us/windows/win32/menurc/stringfileinfo-block>`__.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_application/icon:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **application/icon**
- Application icon file. If left empty, it will fallback to :ref:`ProjectSettings.application/config/windows_native_icon<class_ProjectSettings_property_application/config/windows_native_icon>`, and then to :ref:`ProjectSettings.application/config/icon<class_ProjectSettings_property_application/config/icon>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_application/icon_interpolation:
- .. rst-class:: classref-property
- :ref:`int<class_int>` **application/icon_interpolation**
- Interpolation method used to resize application icon.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_application/modify_resources:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **application/modify_resources**
- If enabled, icon and metadata of the exported executable is set according to the other ``application/*`` values.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_application/product_name:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **application/product_name**
- Name of the application. Required. See `StringFileInfo <https://learn.microsoft.com/en-us/windows/win32/menurc/stringfileinfo-block>`__.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_application/product_version:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **application/product_version**
- Application version visible to the user. Required. See `StringFileInfo <https://learn.microsoft.com/en-us/windows/win32/menurc/stringfileinfo-block>`__.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_application/trademarks:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **application/trademarks**
- Trademarks and registered trademarks that apply to the file. Optional. See `StringFileInfo <https://learn.microsoft.com/en-us/windows/win32/menurc/stringfileinfo-block>`__.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_binary_format/architecture:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **binary_format/architecture**
- Application executable architecture.
- Supported architectures: ``x86_32``, ``x86_64``, and ``arm64``.
- Official export templates include ``x86_32`` and ``x86_64`` binaries only.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_binary_format/embed_pck:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **binary_format/embed_pck**
- If ``true``, project resources are embedded into the executable.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_codesign/custom_options:
- .. rst-class:: classref-property
- :ref:`PackedStringArray<class_PackedStringArray>` **codesign/custom_options**
- Array of the additional command line arguments passed to the code signing tool. See `Sign Tool <https://learn.microsoft.com/en-us/dotnet/framework/tools/signtool-exe>`__.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_codesign/description:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **codesign/description**
- Description of the signed content. See `Sign Tool <https://learn.microsoft.com/en-us/dotnet/framework/tools/signtool-exe>`__.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_codesign/digest_algorithm:
- .. rst-class:: classref-property
- :ref:`int<class_int>` **codesign/digest_algorithm**
- Digest algorithm to use for creating signature. See `Sign Tool <https://learn.microsoft.com/en-us/dotnet/framework/tools/signtool-exe>`__.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_codesign/enable:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **codesign/enable**
- If ``true``, executable signing is enabled.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_codesign/identity:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **codesign/identity**
- PKCS #12 certificate file used to sign executable or certificate SHA-1 hash (if :ref:`codesign/identity_type<class_EditorExportPlatformWindows_property_codesign/identity_type>` is set to "Use certificate store"). See `Sign Tool <https://learn.microsoft.com/en-us/dotnet/framework/tools/signtool-exe>`__.
- Can be overridden with the environment variable ``GODOT_WINDOWS_CODESIGN_IDENTITY``.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_codesign/identity_type:
- .. rst-class:: classref-property
- :ref:`int<class_int>` **codesign/identity_type**
- Type of identity to use. See `Sign Tool <https://learn.microsoft.com/en-us/dotnet/framework/tools/signtool-exe>`__.
- Can be overridden with the environment variable ``GODOT_WINDOWS_CODESIGN_IDENTITY_TYPE``.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_codesign/password:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **codesign/password**
- Password for the certificate file used to sign executable. See `Sign Tool <https://learn.microsoft.com/en-us/dotnet/framework/tools/signtool-exe>`__.
- Can be overridden with the environment variable ``GODOT_WINDOWS_CODESIGN_PASSWORD``.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_codesign/timestamp:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **codesign/timestamp**
- If ``true``, time-stamp is added to the signature. See `Sign Tool <https://learn.microsoft.com/en-us/dotnet/framework/tools/signtool-exe>`__.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_codesign/timestamp_server_url:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **codesign/timestamp_server_url**
- URL of the time stamp server. If left empty, the default server is used. See `Sign Tool <https://learn.microsoft.com/en-us/dotnet/framework/tools/signtool-exe>`__.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_custom_template/debug:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **custom_template/debug**
- Path to the custom export template. If left empty, default template is used.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_custom_template/release:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **custom_template/release**
- Path to the custom export template. If left empty, default template is used.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_debug/export_console_wrapper:
- .. rst-class:: classref-property
- :ref:`int<class_int>` **debug/export_console_wrapper**
- If ``true``, a console wrapper executable is exported alongside the main executable, which allows running the project with enabled console output.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_ssh_remote_deploy/cleanup_script:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **ssh_remote_deploy/cleanup_script**
- Script code to execute on the remote host when app is finished.
- The following variables can be used in the script:
- - ``{temp_dir}`` - Path of temporary folder on the remote, used to upload app and scripts to.
- - ``{archive_name}`` - Name of the ZIP containing uploaded application.
- - ``{exe_name}`` - Name of application executable.
- - ``{cmd_args}`` - Array of the command line argument for the application.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_ssh_remote_deploy/enabled:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **ssh_remote_deploy/enabled**
- Enables remote deploy using SSH/SCP.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_ssh_remote_deploy/extra_args_scp:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **ssh_remote_deploy/extra_args_scp**
- Array of the additional command line arguments passed to the SCP.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_ssh_remote_deploy/extra_args_ssh:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **ssh_remote_deploy/extra_args_ssh**
- Array of the additional command line arguments passed to the SSH.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_ssh_remote_deploy/host:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **ssh_remote_deploy/host**
- Remote host SSH user name and address, in ``user@address`` format.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_ssh_remote_deploy/port:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **ssh_remote_deploy/port**
- Remote host SSH port number.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_ssh_remote_deploy/run_script:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **ssh_remote_deploy/run_script**
- Script code to execute on the remote host when running the app.
- The following variables can be used in the script:
- - ``{temp_dir}`` - Path of temporary folder on the remote, used to upload app and scripts to.
- - ``{archive_name}`` - Name of the ZIP containing uploaded application.
- - ``{exe_name}`` - Name of application executable.
- - ``{cmd_args}`` - Array of the command line argument for the application.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_texture_format/bptc:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **texture_format/bptc**
- If ``true``, project textures are exported in the BPTC format.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_texture_format/etc:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **texture_format/etc**
- If ``true``, project textures are exported in the ETC format.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_texture_format/etc2:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **texture_format/etc2**
- If ``true``, project textures are exported in the ETC2 format.
- .. rst-class:: classref-item-separator
- ----
- .. _class_EditorExportPlatformWindows_property_texture_format/s3tc:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **texture_format/s3tc**
- If ``true``, project textures are exported in the S3TC format.
- .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
- .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
- .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
- .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
- .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
- .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
- .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`
|