2023-01-05 13:25:55 +01:00
|
|
|
/**************************************************************************/
|
|
|
|
/* os_android.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. */
|
|
|
|
/**************************************************************************/
|
2018-01-05 00:50:27 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
#ifndef OS_ANDROID_H
|
|
|
|
#define OS_ANDROID_H
|
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
#include "audio_driver_opensl.h"
|
2023-06-08 14:51:32 +02:00
|
|
|
|
2018-09-11 18:13:45 +02:00
|
|
|
#include "core/os/main_loop.h"
|
2014-02-10 02:10:30 +01:00
|
|
|
#include "drivers/unix/os_unix.h"
|
2017-01-16 19:19:45 +01:00
|
|
|
#include "servers/audio_server.h"
|
2015-09-04 04:24:55 +02:00
|
|
|
|
2019-03-13 13:51:55 +01:00
|
|
|
class GodotJavaWrapper;
|
|
|
|
class GodotIOJavaWrapper;
|
2014-03-14 02:57:24 +01:00
|
|
|
|
2020-03-05 19:00:28 +01:00
|
|
|
struct ANativeWindow;
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
class OS_Android : public OS_Unix {
|
|
|
|
private:
|
2020-03-27 17:30:18 +01:00
|
|
|
Size2i display_size;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2014-06-28 04:21:45 +02:00
|
|
|
bool use_apk_expansion;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2021-10-26 17:18:39 +02:00
|
|
|
#if defined(GLES3_ENABLED)
|
2020-03-27 17:30:18 +01:00
|
|
|
const char *gl_extensions;
|
|
|
|
#endif
|
2015-12-02 15:15:48 +01:00
|
|
|
|
2020-03-05 19:00:28 +01:00
|
|
|
#if defined(VULKAN_ENABLED)
|
2022-04-04 15:06:57 +02:00
|
|
|
ANativeWindow *native_window = nullptr;
|
2020-03-05 19:00:28 +01:00
|
|
|
#endif
|
|
|
|
|
2016-07-02 16:48:02 +02:00
|
|
|
mutable String data_dir_cache;
|
2021-02-22 22:54:12 +01:00
|
|
|
mutable String cache_dir_cache;
|
2023-04-28 13:15:36 +02:00
|
|
|
mutable String remote_fs_dir;
|
2016-07-02 16:48:02 +02:00
|
|
|
|
2014-03-14 02:57:24 +01:00
|
|
|
AudioDriverOpenSL audio_driver_android;
|
|
|
|
|
2022-04-04 15:06:57 +02:00
|
|
|
MainLoop *main_loop = nullptr;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2022-11-21 14:04:01 +01:00
|
|
|
struct FontInfo {
|
|
|
|
String font_name;
|
|
|
|
HashSet<String> lang;
|
|
|
|
HashSet<String> script;
|
|
|
|
int weight = 400;
|
|
|
|
int stretch = 100;
|
|
|
|
bool italic = false;
|
|
|
|
int priority = 0;
|
|
|
|
String filename;
|
|
|
|
};
|
|
|
|
|
|
|
|
HashMap<String, String> font_aliases;
|
|
|
|
List<FontInfo> fonts;
|
|
|
|
HashSet<String> font_names;
|
|
|
|
bool font_config_loaded = false;
|
|
|
|
|
2022-04-04 15:06:57 +02:00
|
|
|
GodotJavaWrapper *godot_java = nullptr;
|
|
|
|
GodotIOJavaWrapper *godot_io_java = nullptr;
|
2019-03-13 13:51:55 +01:00
|
|
|
|
2022-11-21 14:04:01 +01:00
|
|
|
void _load_system_font_config();
|
2022-09-16 11:14:14 +02:00
|
|
|
String get_system_property(const char *key) const;
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
public:
|
2021-06-25 15:45:16 +02:00
|
|
|
static const char *ANDROID_EXEC_PATH;
|
2023-01-22 07:04:44 +01:00
|
|
|
static const int DEFAULT_WINDOW_WIDTH = 800;
|
|
|
|
static const int DEFAULT_WINDOW_HEIGHT = 600;
|
2021-06-25 15:45:16 +02:00
|
|
|
|
2024-06-16 21:14:34 +02:00
|
|
|
#ifdef TOOLS_ENABLED
|
|
|
|
Error sign_apk(const String &p_input_path, const String &p_output_path, const String &p_keystore_path, const String &p_keystore_user, const String &p_keystore_password);
|
|
|
|
Error verify_apk(const String &p_apk_path);
|
|
|
|
#endif
|
|
|
|
|
2020-12-17 18:15:59 +01:00
|
|
|
virtual void initialize_core() override;
|
|
|
|
virtual void initialize() override;
|
2020-03-27 17:30:18 +01:00
|
|
|
|
2020-12-17 18:15:59 +01:00
|
|
|
virtual void initialize_joypads() override;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2020-12-17 18:15:59 +01:00
|
|
|
virtual void set_main_loop(MainLoop *p_main_loop) override;
|
|
|
|
virtual void delete_main_loop() override;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2020-12-17 18:15:59 +01:00
|
|
|
virtual void finalize() override;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
typedef int64_t ProcessID;
|
|
|
|
|
2020-03-27 17:30:18 +01:00
|
|
|
static OS_Android *get_singleton();
|
2019-03-13 13:51:55 +01:00
|
|
|
GodotJavaWrapper *get_godot_java();
|
|
|
|
GodotIOJavaWrapper *get_godot_io_java();
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2020-12-17 18:15:59 +01:00
|
|
|
virtual bool request_permission(const String &p_name) override;
|
|
|
|
virtual bool request_permissions() override;
|
|
|
|
virtual Vector<String> get_granted_permissions() const override;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2021-07-22 18:23:48 +02:00
|
|
|
virtual void alert(const String &p_alert, const String &p_title) override;
|
|
|
|
|
2024-04-19 16:14:05 +02:00
|
|
|
virtual Error open_dynamic_library(const String &p_path, void *&p_library_handle, GDExtensionData *p_data = nullptr) override;
|
2018-01-13 14:40:20 +01:00
|
|
|
|
2020-12-17 18:15:59 +01:00
|
|
|
virtual String get_name() const override;
|
2022-09-16 11:14:14 +02:00
|
|
|
virtual String get_distribution_name() const override;
|
|
|
|
virtual String get_version() const override;
|
2020-12-17 18:15:59 +01:00
|
|
|
virtual MainLoop *get_main_loop() const override;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
void main_loop_begin();
|
2022-03-28 03:09:48 +02:00
|
|
|
bool main_loop_iterate(bool *r_should_swap_buffers = nullptr);
|
2014-02-10 02:10:30 +01:00
|
|
|
void main_loop_end();
|
|
|
|
void main_loop_focusout();
|
|
|
|
void main_loop_focusin();
|
|
|
|
|
2020-03-27 17:30:18 +01:00
|
|
|
void set_display_size(const Size2i &p_size);
|
|
|
|
Size2i get_display_size() const;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2020-03-27 17:30:18 +01:00
|
|
|
void set_opengl_extensions(const char *p_gl_extensions);
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2020-03-05 19:00:28 +01:00
|
|
|
void set_native_window(ANativeWindow *p_native_window);
|
2020-03-27 17:30:18 +01:00
|
|
|
ANativeWindow *get_native_window() const;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2024-01-09 02:36:19 +01:00
|
|
|
virtual Error shell_open(const String &p_uri) override;
|
2022-11-21 14:04:01 +01:00
|
|
|
|
|
|
|
virtual Vector<String> get_system_fonts() const override;
|
|
|
|
virtual String get_system_font_path(const String &p_font_name, int p_weight = 400, int p_stretch = 100, bool p_italic = false) const override;
|
|
|
|
virtual Vector<String> get_system_font_path_for_text(const String &p_font_name, const String &p_text, const String &p_locale = String(), const String &p_script = String(), int p_weight = 400, int p_stretch = 100, bool p_italic = false) const override;
|
2021-06-25 15:45:16 +02:00
|
|
|
virtual String get_executable_path() const override;
|
2020-12-17 18:15:59 +01:00
|
|
|
virtual String get_user_data_dir() const override;
|
2021-07-11 03:39:31 +02:00
|
|
|
virtual String get_data_path() const override;
|
|
|
|
virtual String get_cache_path() const override;
|
2020-12-17 18:15:59 +01:00
|
|
|
virtual String get_resource_dir() const override;
|
|
|
|
virtual String get_locale() const override;
|
|
|
|
virtual String get_model_name() const override;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2020-12-17 18:15:59 +01:00
|
|
|
virtual String get_unique_id() const override;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2021-07-11 03:39:31 +02:00
|
|
|
virtual String get_system_dir(SystemDir p_dir, bool p_shared_storage = true) const override;
|
2014-12-02 18:02:41 +01:00
|
|
|
|
2021-07-11 03:39:31 +02:00
|
|
|
virtual Error move_to_trash(const String &p_path) override;
|
|
|
|
|
2024-05-02 15:15:42 +02:00
|
|
|
void vibrate_handheld(int p_duration_ms, float p_amplitude = -1.0) override;
|
2016-01-24 05:11:59 +01:00
|
|
|
|
2021-06-25 15:45:16 +02:00
|
|
|
virtual String get_config_path() const override;
|
|
|
|
|
|
|
|
virtual Error execute(const String &p_path, const List<String> &p_arguments, String *r_pipe = nullptr, int *r_exitcode = nullptr, bool read_stderr = false, Mutex *p_pipe_mutex = nullptr, bool p_open_console = false) override;
|
|
|
|
virtual Error create_process(const String &p_path, const List<String> &p_arguments, ProcessID *r_child_id = nullptr, bool p_open_console = false) override;
|
|
|
|
virtual Error create_instance(const List<String> &p_arguments, ProcessID *r_child_id = nullptr) override;
|
2023-01-26 11:55:47 +01:00
|
|
|
virtual Error kill(const ProcessID &p_pid) override;
|
2023-04-13 21:17:55 +02:00
|
|
|
virtual String get_system_ca_certificates() override;
|
2021-06-25 15:45:16 +02:00
|
|
|
|
2023-04-28 13:15:36 +02:00
|
|
|
virtual Error setup_remote_filesystem(const String &p_server_host, int p_port, const String &p_password, String &r_project_path) override;
|
|
|
|
|
2023-12-08 12:52:49 +01:00
|
|
|
virtual void benchmark_begin_measure(const String &p_context, const String &p_what) override;
|
|
|
|
virtual void benchmark_end_measure(const String &p_context, const String &p_what) override;
|
2023-01-13 20:24:12 +01:00
|
|
|
virtual void benchmark_dump() override;
|
|
|
|
|
2023-07-17 21:11:37 +02:00
|
|
|
virtual void load_platform_gdextensions() const override;
|
|
|
|
|
2020-12-17 18:15:59 +01:00
|
|
|
virtual bool _check_internal_feature_support(const String &p_feature) override;
|
2019-03-13 13:51:55 +01:00
|
|
|
OS_Android(GodotJavaWrapper *p_godot_java, GodotIOJavaWrapper *p_godot_io_java, bool p_use_apk_expansion);
|
2014-02-10 02:10:30 +01:00
|
|
|
~OS_Android();
|
2023-07-17 21:11:37 +02:00
|
|
|
|
|
|
|
private:
|
|
|
|
// Location where we relocate external dynamic libraries to make them accessible.
|
|
|
|
String get_dynamic_libraries_path() const;
|
2024-02-13 23:26:05 +01:00
|
|
|
// Copy a dynamic library to the given location to make it accessible for loading.
|
|
|
|
bool copy_dynamic_library(const String &p_library_path, const String &p_target_dir, String *r_copy_path = nullptr);
|
2014-02-10 02:10:30 +01:00
|
|
|
};
|
|
|
|
|
2022-05-30 23:13:49 +02:00
|
|
|
#endif // OS_ANDROID_H
|