2017-09-15 23:46:14 +00:00
<?xml version="1.0" encoding="UTF-8" ?>
2021-06-04 16:03:15 +00:00
<class name= "EditorExportPlugin" inherits= "RefCounted" version= "4.0" >
2017-09-15 23:46:14 +00:00
<brief_description >
2020-12-29 11:23:29 +00:00
A script that is executed when exporting the project.
2017-09-15 23:46:14 +00:00
</brief_description>
<description >
2021-10-15 12:30:58 +00:00
[EditorExportPlugin]s are automatically invoked whenever the user exports the project. Their most common use is to determine what files are being included in the exported project. For each plugin, [method _export_begin] is called at the beginning of the export process and then [method _export_file] is called for each exported file.
To use [EditorExportPlugin], register it using the [method EditorPlugin.add_export_plugin] method first.
2017-09-15 23:46:14 +00:00
</description>
<tutorials >
</tutorials>
<methods >
<method name= "_export_begin" qualifiers= "virtual" >
2021-07-30 13:28:05 +00:00
<return type= "void" />
<argument index= "0" name= "features" type= "PackedStringArray" />
<argument index= "1" name= "is_debug" type= "bool" />
<argument index= "2" name= "path" type= "String" />
<argument index= "3" name= "flags" type= "int" />
2017-09-15 23:46:14 +00:00
<description >
2020-12-29 11:23:29 +00:00
Virtual method to be overridden by the user. It is called when the export starts and provides all information about the export. [code]features[/code] is the list of features for the export, [code]is_debug[/code] is [code]true[/code] for debug builds, [code]path[/code] is the target path for the exported project. [code]flags[/code] is only used when running a runnable profile, e.g. when using native run on Android.
2019-05-23 21:31:02 +00:00
</description>
</method>
<method name= "_export_end" qualifiers= "virtual" >
2021-07-30 13:28:05 +00:00
<return type= "void" />
2019-05-23 21:31:02 +00:00
<description >
2020-03-03 18:21:21 +00:00
Virtual method to be overridden by the user. Called when the export is finished.
2017-09-15 23:46:14 +00:00
</description>
</method>
<method name= "_export_file" qualifiers= "virtual" >
2021-07-30 13:28:05 +00:00
<return type= "void" />
<argument index= "0" name= "path" type= "String" />
<argument index= "1" name= "type" type= "String" />
<argument index= "2" name= "features" type= "PackedStringArray" />
2017-09-15 23:46:14 +00:00
<description >
2020-12-29 11:23:29 +00:00
Virtual method to be overridden by the user. Called for each exported file, providing arguments that can be used to identify the file. [code]path[/code] is the path of the file, [code]type[/code] is the [Resource] represented by the file (e.g. [PackedScene]) and [code]features[/code] is the list of features for the export.
Calling [method skip] inside this callback will make the file not included in the export.
2017-09-15 23:46:14 +00:00
</description>
</method>
<method name= "add_file" >
2021-07-30 13:28:05 +00:00
<return type= "void" />
<argument index= "0" name= "path" type= "String" />
<argument index= "1" name= "file" type= "PackedByteArray" />
<argument index= "2" name= "remap" type= "bool" />
2017-09-15 23:46:14 +00:00
<description >
2020-12-29 11:23:29 +00:00
Adds a custom file to be exported. [code]path[/code] is the virtual path that can be used to load the file, [code]file[/code] is the binary data of the file. If [code]remap[/code] is [code]true[/code], file will not be exported, but instead remapped to the given [code]path[/code].
2017-09-15 23:46:14 +00:00
</description>
</method>
2017-11-24 08:16:27 +00:00
<method name= "add_ios_bundle_file" >
2021-07-30 13:28:05 +00:00
<return type= "void" />
<argument index= "0" name= "path" type= "String" />
2017-11-24 08:16:27 +00:00
<description >
2020-12-29 11:23:29 +00:00
Adds an iOS bundle file from the given [code]path[/code] to the exported project.
2017-11-24 08:16:27 +00:00
</description>
</method>
<method name= "add_ios_cpp_code" >
2021-07-30 13:28:05 +00:00
<return type= "void" />
<argument index= "0" name= "code" type= "String" />
2017-11-24 08:16:27 +00:00
<description >
2020-12-29 11:23:29 +00:00
Adds a C++ code to the iOS export. The final code is created from the code appended by each active export plugin.
2017-11-24 08:16:27 +00:00
</description>
</method>
2020-08-31 09:25:11 +00:00
<method name= "add_ios_embedded_framework" >
2021-07-30 13:28:05 +00:00
<return type= "void" />
<argument index= "0" name= "path" type= "String" />
2017-11-24 08:16:27 +00:00
<description >
2020-08-31 09:25:11 +00:00
Adds a dynamic library (*.dylib, *.framework) to Linking Phase in iOS's Xcode project and embeds it into resulting binary.
[b]Note:[/b] For static libraries (*.a) works in same way as [code]add_ios_framework[/code].
This method should not be used for System libraries as they are already present on the device.
2020-08-05 17:55:29 +00:00
</description>
</method>
2020-08-31 09:25:11 +00:00
<method name= "add_ios_framework" >
2021-07-30 13:28:05 +00:00
<return type= "void" />
<argument index= "0" name= "path" type= "String" />
2020-08-05 17:55:29 +00:00
<description >
2020-08-31 09:25:11 +00:00
Adds a static library (*.a) or dynamic library (*.dylib, *.framework) to Linking Phase in iOS's Xcode project.
2017-11-24 08:16:27 +00:00
</description>
</method>
<method name= "add_ios_linker_flags" >
2021-07-30 13:28:05 +00:00
<return type= "void" />
<argument index= "0" name= "flags" type= "String" />
2017-11-24 08:16:27 +00:00
<description >
2020-12-29 11:23:29 +00:00
Adds linker flags for the iOS export.
2017-11-24 08:16:27 +00:00
</description>
</method>
<method name= "add_ios_plist_content" >
2021-07-30 13:28:05 +00:00
<return type= "void" />
<argument index= "0" name= "plist_content" type= "String" />
2017-11-24 08:16:27 +00:00
<description >
2020-12-29 11:23:29 +00:00
Adds content for iOS Property List files.
2017-11-24 08:16:27 +00:00
</description>
</method>
2020-04-03 08:11:23 +00:00
<method name= "add_ios_project_static_lib" >
2021-07-30 13:28:05 +00:00
<return type= "void" />
<argument index= "0" name= "path" type= "String" />
2020-04-03 08:11:23 +00:00
<description >
2020-12-29 11:23:29 +00:00
Adds a static lib from the given [code]path[/code] to the iOS project.
2020-04-03 08:11:23 +00:00
</description>
</method>
2017-09-15 23:46:14 +00:00
<method name= "add_shared_object" >
2021-07-30 13:28:05 +00:00
<return type= "void" />
<argument index= "0" name= "path" type= "String" />
<argument index= "1" name= "tags" type= "PackedStringArray" />
2017-09-15 23:46:14 +00:00
<description >
2020-12-29 11:23:29 +00:00
Adds a shared object with the given [code]tags[/code] and destination [code]path[/code].
2017-09-15 23:46:14 +00:00
</description>
</method>
<method name= "skip" >
2021-07-30 13:28:05 +00:00
<return type= "void" />
2017-09-15 23:46:14 +00:00
<description >
2020-12-29 11:23:29 +00:00
To be called inside [method _export_file]. Skips the current file, so it's not included in the export.
2017-09-15 23:46:14 +00:00
</description>
</method>
</methods>
</class>