d95794ec8a
As many open source projects have started doing it, we're removing the current year from the copyright notice, so that we don't need to bump it every year. It seems like only the first year of publication is technically relevant for copyright notices, and even that seems to be something that many companies stopped listing altogether (in a version controlled codebase, the commits are a much better source of date of publication than a hardcoded copyright statement). We also now list Godot Engine contributors first as we're collectively the current maintainers of the project, and we clarify that the "exclusive" copyright of the co-founders covers the timespan before opensourcing (their further contributions are included as part of Godot Engine contributors). Also fixed "cf." Frenchism - it's meant as "refer to / see".
262 lines
10 KiB
C++
262 lines
10 KiB
C++
/**************************************************************************/
|
|
/* export_plugin.h */
|
|
/**************************************************************************/
|
|
/* This file is part of: */
|
|
/* GODOT ENGINE */
|
|
/* https://godotengine.org */
|
|
/**************************************************************************/
|
|
/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
|
|
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
|
|
/* */
|
|
/* Permission is hereby granted, free of charge, to any person obtaining */
|
|
/* a copy of this software and associated documentation files (the */
|
|
/* "Software"), to deal in the Software without restriction, including */
|
|
/* without limitation the rights to use, copy, modify, merge, publish, */
|
|
/* distribute, sublicense, and/or sell copies of the Software, and to */
|
|
/* permit persons to whom the Software is furnished to do so, subject to */
|
|
/* the following conditions: */
|
|
/* */
|
|
/* The above copyright notice and this permission notice shall be */
|
|
/* included in all copies or substantial portions of the Software. */
|
|
/* */
|
|
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
|
|
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
|
|
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
|
|
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
|
|
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
|
|
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
|
|
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
|
|
/**************************************************************************/
|
|
|
|
#ifndef ANDROID_EXPORT_PLUGIN_H
|
|
#define ANDROID_EXPORT_PLUGIN_H
|
|
|
|
#include "godot_plugin_config.h"
|
|
|
|
#include "core/io/zip_io.h"
|
|
#include "core/os/os.h"
|
|
#include "editor/export/editor_export_platform.h"
|
|
|
|
const String SPLASH_CONFIG_XML_CONTENT = R"SPLASH(<?xml version="1.0" encoding="utf-8"?>
|
|
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
|
|
<item android:drawable="@drawable/splash_bg_color" />
|
|
<item>
|
|
<bitmap
|
|
android:gravity="center"
|
|
android:filter="%s"
|
|
android:src="@drawable/splash" />
|
|
</item>
|
|
</layer-list>
|
|
)SPLASH";
|
|
|
|
struct LauncherIcon {
|
|
const char *export_path;
|
|
int dimensions = 0;
|
|
};
|
|
|
|
class EditorExportPlatformAndroid : public EditorExportPlatform {
|
|
GDCLASS(EditorExportPlatformAndroid, EditorExportPlatform);
|
|
|
|
Ref<ImageTexture> logo;
|
|
Ref<ImageTexture> run_icon;
|
|
|
|
struct Device {
|
|
String id;
|
|
String name;
|
|
String description;
|
|
int api_level = 0;
|
|
};
|
|
|
|
struct APKExportData {
|
|
zipFile apk;
|
|
EditorProgress *ep = nullptr;
|
|
};
|
|
|
|
Vector<PluginConfigAndroid> plugins;
|
|
String last_plugin_names;
|
|
uint64_t last_custom_build_time = 0;
|
|
SafeFlag plugins_changed;
|
|
Mutex plugins_lock;
|
|
Vector<Device> devices;
|
|
SafeFlag devices_changed;
|
|
Mutex device_lock;
|
|
#ifndef ANDROID_ENABLED
|
|
Thread check_for_changes_thread;
|
|
SafeFlag quit_request;
|
|
|
|
static void _check_for_changes_poll_thread(void *ud);
|
|
#endif
|
|
|
|
String get_project_name(const String &p_name) const;
|
|
|
|
String get_package_name(const String &p_package) const;
|
|
|
|
String get_assets_directory(const Ref<EditorExportPreset> &p_preset, int p_export_format) const;
|
|
|
|
bool is_package_name_valid(const String &p_package, String *r_error = nullptr) const;
|
|
|
|
static bool _should_compress_asset(const String &p_path, const Vector<uint8_t> &p_data);
|
|
|
|
static zip_fileinfo get_zip_fileinfo();
|
|
|
|
struct ABI {
|
|
String abi;
|
|
String arch;
|
|
|
|
bool operator==(const ABI &p_a) const {
|
|
return p_a.abi == abi;
|
|
}
|
|
|
|
ABI(const String &p_abi, const String &p_arch) {
|
|
abi = p_abi;
|
|
arch = p_arch;
|
|
}
|
|
ABI() {}
|
|
};
|
|
|
|
static Vector<ABI> get_abis();
|
|
|
|
/// List the gdap files in the directory specified by the p_path parameter.
|
|
static Vector<String> list_gdap_files(const String &p_path);
|
|
|
|
static Vector<PluginConfigAndroid> get_plugins();
|
|
|
|
static Vector<PluginConfigAndroid> get_enabled_plugins(const Ref<EditorExportPreset> &p_presets);
|
|
|
|
static Error store_in_apk(APKExportData *ed, const String &p_path, const Vector<uint8_t> &p_data, int compression_method = Z_DEFLATED);
|
|
|
|
static Error save_apk_so(void *p_userdata, const SharedObject &p_so);
|
|
|
|
static Error save_apk_file(void *p_userdata, const String &p_path, const Vector<uint8_t> &p_data, int p_file, int p_total, const Vector<String> &p_enc_in_filters, const Vector<String> &p_enc_ex_filters, const Vector<uint8_t> &p_key);
|
|
|
|
static Error ignore_apk_file(void *p_userdata, const String &p_path, const Vector<uint8_t> &p_data, int p_file, int p_total, const Vector<String> &p_enc_in_filters, const Vector<String> &p_enc_ex_filters, const Vector<uint8_t> &p_key);
|
|
|
|
static Error copy_gradle_so(void *p_userdata, const SharedObject &p_so);
|
|
|
|
bool _has_read_write_storage_permission(const Vector<String> &p_permissions);
|
|
|
|
bool _has_manage_external_storage_permission(const Vector<String> &p_permissions);
|
|
|
|
void _get_permissions(const Ref<EditorExportPreset> &p_preset, bool p_give_internet, Vector<String> &r_permissions);
|
|
|
|
void _write_tmp_manifest(const Ref<EditorExportPreset> &p_preset, bool p_give_internet, bool p_debug);
|
|
|
|
void _fix_manifest(const Ref<EditorExportPreset> &p_preset, Vector<uint8_t> &p_manifest, bool p_give_internet);
|
|
|
|
static String _parse_string(const uint8_t *p_bytes, bool p_utf8);
|
|
|
|
void _fix_resources(const Ref<EditorExportPreset> &p_preset, Vector<uint8_t> &r_manifest);
|
|
|
|
void _load_image_data(const Ref<Image> &p_splash_image, Vector<uint8_t> &p_data);
|
|
|
|
void _process_launcher_icons(const String &p_file_name, const Ref<Image> &p_source_image, int dimension, Vector<uint8_t> &p_data);
|
|
|
|
String load_splash_refs(Ref<Image> &splash_image, Ref<Image> &splash_bg_color_image);
|
|
|
|
void load_icon_refs(const Ref<EditorExportPreset> &p_preset, Ref<Image> &icon, Ref<Image> &foreground, Ref<Image> &background);
|
|
|
|
void store_image(const LauncherIcon launcher_icon, const Vector<uint8_t> &data);
|
|
|
|
void store_image(const String &export_path, const Vector<uint8_t> &data);
|
|
|
|
void _copy_icons_to_gradle_project(const Ref<EditorExportPreset> &p_preset,
|
|
const String &processed_splash_config_xml,
|
|
const Ref<Image> &splash_image,
|
|
const Ref<Image> &splash_bg_color_image,
|
|
const Ref<Image> &main_image,
|
|
const Ref<Image> &foreground,
|
|
const Ref<Image> &background);
|
|
|
|
static Vector<ABI> get_enabled_abis(const Ref<EditorExportPreset> &p_preset);
|
|
|
|
public:
|
|
typedef Error (*EditorExportSaveFunction)(void *p_userdata, const String &p_path, const Vector<uint8_t> &p_data, int p_file, int p_total, const Vector<String> &p_enc_in_filters, const Vector<String> &p_enc_ex_filters, const Vector<uint8_t> &p_key);
|
|
|
|
public:
|
|
virtual void get_preset_features(const Ref<EditorExportPreset> &p_preset, List<String> *r_features) const override;
|
|
|
|
virtual void get_export_options(List<ExportOption> *r_options) override;
|
|
|
|
virtual String get_name() const override;
|
|
|
|
virtual String get_os_name() const override;
|
|
|
|
virtual Ref<Texture2D> get_logo() const override;
|
|
|
|
virtual bool should_update_export_options() override;
|
|
|
|
virtual bool poll_export() override;
|
|
|
|
virtual int get_options_count() const override;
|
|
|
|
virtual String get_options_tooltip() const override;
|
|
|
|
virtual String get_option_label(int p_index) const override;
|
|
|
|
virtual String get_option_tooltip(int p_index) const override;
|
|
|
|
virtual Error run(const Ref<EditorExportPreset> &p_preset, int p_device, int p_debug_flags) override;
|
|
|
|
virtual Ref<Texture2D> get_run_icon() const override;
|
|
|
|
static String get_adb_path();
|
|
|
|
static String get_apksigner_path(int p_target_sdk = -1, bool p_check_executes = false);
|
|
|
|
virtual bool has_valid_export_configuration(const Ref<EditorExportPreset> &p_preset, String &r_error, bool &r_missing_templates) const override;
|
|
virtual bool has_valid_project_configuration(const Ref<EditorExportPreset> &p_preset, String &r_error) const override;
|
|
|
|
virtual List<String> get_binary_extensions(const Ref<EditorExportPreset> &p_preset) const override;
|
|
|
|
inline bool is_clean_build_required(Vector<PluginConfigAndroid> enabled_plugins) {
|
|
String plugin_names = PluginConfigAndroid::get_plugins_names(enabled_plugins);
|
|
bool first_build = last_custom_build_time == 0;
|
|
bool have_plugins_changed = false;
|
|
|
|
if (!first_build) {
|
|
have_plugins_changed = plugin_names != last_plugin_names;
|
|
if (!have_plugins_changed) {
|
|
for (int i = 0; i < enabled_plugins.size(); i++) {
|
|
if (enabled_plugins.get(i).last_updated > last_custom_build_time) {
|
|
have_plugins_changed = true;
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
last_custom_build_time = OS::get_singleton()->get_unix_time();
|
|
last_plugin_names = plugin_names;
|
|
|
|
return have_plugins_changed || first_build;
|
|
}
|
|
|
|
String get_apk_expansion_fullpath(const Ref<EditorExportPreset> &p_preset, const String &p_path);
|
|
|
|
Error save_apk_expansion_file(const Ref<EditorExportPreset> &p_preset, bool p_debug, const String &p_path);
|
|
|
|
void get_command_line_flags(const Ref<EditorExportPreset> &p_preset, const String &p_path, int p_flags, Vector<uint8_t> &r_command_line_flags);
|
|
|
|
Error sign_apk(const Ref<EditorExportPreset> &p_preset, bool p_debug, const String &export_path, EditorProgress &ep);
|
|
|
|
void _clear_assets_directory();
|
|
|
|
void _remove_copied_libs();
|
|
|
|
static String join_list(const List<String> &p_parts, const String &p_separator);
|
|
static String join_abis(const Vector<ABI> &p_parts, const String &p_separator, bool p_use_arch);
|
|
|
|
virtual Error export_project(const Ref<EditorExportPreset> &p_preset, bool p_debug, const String &p_path, int p_flags = 0) override;
|
|
|
|
Error export_project_helper(const Ref<EditorExportPreset> &p_preset, bool p_debug, const String &p_path, int export_format, bool should_sign, int p_flags);
|
|
|
|
virtual void get_platform_features(List<String> *r_features) const override;
|
|
|
|
virtual void resolve_platform_feature_priorities(const Ref<EditorExportPreset> &p_preset, HashSet<String> &p_features) override;
|
|
|
|
EditorExportPlatformAndroid();
|
|
|
|
~EditorExportPlatformAndroid();
|
|
};
|
|
|
|
#endif // ANDROID_EXPORT_PLUGIN_H
|