2021-06-19 17:58:49 +02:00
|
|
|
/*************************************************************************/
|
|
|
|
/* native_extension_manager.cpp */
|
|
|
|
/*************************************************************************/
|
|
|
|
/* This file is part of: */
|
|
|
|
/* GODOT ENGINE */
|
|
|
|
/* https://godotengine.org */
|
|
|
|
/*************************************************************************/
|
2022-01-03 21:27:34 +01:00
|
|
|
/* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */
|
|
|
|
/* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */
|
2021-06-19 17:58:49 +02:00
|
|
|
/* */
|
|
|
|
/* 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. */
|
|
|
|
/*************************************************************************/
|
|
|
|
|
|
|
|
#include "native_extension_manager.h"
|
2021-08-20 20:32:56 +02:00
|
|
|
#include "core/io/file_access.h"
|
2021-06-19 17:58:49 +02:00
|
|
|
|
|
|
|
NativeExtensionManager::LoadStatus NativeExtensionManager::load_extension(const String &p_path) {
|
|
|
|
if (native_extension_map.has(p_path)) {
|
|
|
|
return LOAD_STATUS_ALREADY_LOADED;
|
|
|
|
}
|
|
|
|
Ref<NativeExtension> extension = ResourceLoader::load(p_path);
|
|
|
|
if (extension.is_null()) {
|
|
|
|
return LOAD_STATUS_FAILED;
|
|
|
|
}
|
|
|
|
|
2022-02-20 14:56:58 +01:00
|
|
|
if (level >= 0) { // Already initialized up to some level.
|
2021-06-19 17:58:49 +02:00
|
|
|
int32_t minimum_level = extension->get_minimum_library_initialization_level();
|
|
|
|
if (minimum_level < MIN(level, NativeExtension::INITIALIZATION_LEVEL_SCENE)) {
|
|
|
|
return LOAD_STATUS_NEEDS_RESTART;
|
|
|
|
}
|
2022-02-20 14:56:58 +01:00
|
|
|
// Initialize up to current level.
|
2022-02-20 11:41:39 +01:00
|
|
|
for (int32_t i = minimum_level; i <= level; i++) {
|
|
|
|
extension->initialize_library(NativeExtension::InitializationLevel(i));
|
2021-06-19 17:58:49 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
native_extension_map[p_path] = extension;
|
|
|
|
return LOAD_STATUS_OK;
|
|
|
|
}
|
|
|
|
|
|
|
|
NativeExtensionManager::LoadStatus NativeExtensionManager::reload_extension(const String &p_path) {
|
|
|
|
return LOAD_STATUS_OK; //TODO
|
|
|
|
}
|
|
|
|
NativeExtensionManager::LoadStatus NativeExtensionManager::unload_extension(const String &p_path) {
|
|
|
|
if (!native_extension_map.has(p_path)) {
|
|
|
|
return LOAD_STATUS_NOT_LOADED;
|
|
|
|
}
|
|
|
|
|
|
|
|
Ref<NativeExtension> extension = native_extension_map[p_path];
|
|
|
|
|
2022-02-20 14:56:58 +01:00
|
|
|
if (level >= 0) { // Already initialized up to some level.
|
2021-06-19 17:58:49 +02:00
|
|
|
int32_t minimum_level = extension->get_minimum_library_initialization_level();
|
|
|
|
if (minimum_level < MIN(level, NativeExtension::INITIALIZATION_LEVEL_SCENE)) {
|
|
|
|
return LOAD_STATUS_NEEDS_RESTART;
|
|
|
|
}
|
2022-02-20 14:56:58 +01:00
|
|
|
// Deinitialize down to current level.
|
2021-06-19 17:58:49 +02:00
|
|
|
for (int32_t i = level; i >= minimum_level; i--) {
|
2022-02-20 11:41:39 +01:00
|
|
|
extension->deinitialize_library(NativeExtension::InitializationLevel(i));
|
2021-06-19 17:58:49 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
native_extension_map.erase(p_path);
|
|
|
|
return LOAD_STATUS_OK;
|
|
|
|
}
|
2021-08-20 20:32:56 +02:00
|
|
|
|
|
|
|
bool NativeExtensionManager::is_extension_loaded(const String &p_path) const {
|
|
|
|
return native_extension_map.has(p_path);
|
|
|
|
}
|
|
|
|
|
2021-06-19 17:58:49 +02:00
|
|
|
Vector<String> NativeExtensionManager::get_loaded_extensions() const {
|
|
|
|
Vector<String> ret;
|
2021-08-09 22:13:42 +02:00
|
|
|
for (const KeyValue<String, Ref<NativeExtension>> &E : native_extension_map) {
|
|
|
|
ret.push_back(E.key);
|
2021-06-19 17:58:49 +02:00
|
|
|
}
|
|
|
|
return ret;
|
|
|
|
}
|
|
|
|
Ref<NativeExtension> NativeExtensionManager::get_extension(const String &p_path) {
|
2022-05-13 15:04:37 +02:00
|
|
|
HashMap<String, Ref<NativeExtension>>::Iterator E = native_extension_map.find(p_path);
|
2021-06-19 17:58:49 +02:00
|
|
|
ERR_FAIL_COND_V(!E, Ref<NativeExtension>());
|
2022-05-13 15:04:37 +02:00
|
|
|
return E->value;
|
2021-06-19 17:58:49 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
void NativeExtensionManager::initialize_extensions(NativeExtension::InitializationLevel p_level) {
|
|
|
|
ERR_FAIL_COND(int32_t(p_level) - 1 != level);
|
2021-08-09 22:13:42 +02:00
|
|
|
for (KeyValue<String, Ref<NativeExtension>> &E : native_extension_map) {
|
|
|
|
E.value->initialize_library(p_level);
|
2021-06-19 17:58:49 +02:00
|
|
|
}
|
|
|
|
level = p_level;
|
|
|
|
}
|
|
|
|
|
|
|
|
void NativeExtensionManager::deinitialize_extensions(NativeExtension::InitializationLevel p_level) {
|
|
|
|
ERR_FAIL_COND(int32_t(p_level) != level);
|
2021-08-09 22:13:42 +02:00
|
|
|
for (KeyValue<String, Ref<NativeExtension>> &E : native_extension_map) {
|
|
|
|
E.value->deinitialize_library(p_level);
|
2021-06-19 17:58:49 +02:00
|
|
|
}
|
|
|
|
level = int32_t(p_level) - 1;
|
|
|
|
}
|
|
|
|
|
2021-08-20 20:32:56 +02:00
|
|
|
void NativeExtensionManager::load_extensions() {
|
2022-03-23 10:08:58 +01:00
|
|
|
Ref<FileAccess> f = FileAccess::open(NativeExtension::get_extension_list_config_file(), FileAccess::READ);
|
|
|
|
while (f.is_valid() && !f->eof_reached()) {
|
2021-08-20 20:32:56 +02:00
|
|
|
String s = f->get_line().strip_edges();
|
2021-12-09 10:42:46 +01:00
|
|
|
if (!s.is_empty()) {
|
2021-08-20 20:32:56 +02:00
|
|
|
LoadStatus err = load_extension(s);
|
|
|
|
ERR_CONTINUE_MSG(err == LOAD_STATUS_FAILED, "Error loading extension: " + s);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-06-19 17:58:49 +02:00
|
|
|
NativeExtensionManager *NativeExtensionManager::get_singleton() {
|
|
|
|
return singleton;
|
|
|
|
}
|
|
|
|
void NativeExtensionManager::_bind_methods() {
|
|
|
|
ClassDB::bind_method(D_METHOD("load_extension", "path"), &NativeExtensionManager::load_extension);
|
|
|
|
ClassDB::bind_method(D_METHOD("reload_extension", "path"), &NativeExtensionManager::reload_extension);
|
|
|
|
ClassDB::bind_method(D_METHOD("unload_extension", "path"), &NativeExtensionManager::unload_extension);
|
2021-08-20 20:32:56 +02:00
|
|
|
ClassDB::bind_method(D_METHOD("is_extension_loaded", "path"), &NativeExtensionManager::is_extension_loaded);
|
|
|
|
|
2021-06-19 17:58:49 +02:00
|
|
|
ClassDB::bind_method(D_METHOD("get_loaded_extensions"), &NativeExtensionManager::get_loaded_extensions);
|
|
|
|
ClassDB::bind_method(D_METHOD("get_extension", "path"), &NativeExtensionManager::get_extension);
|
|
|
|
|
|
|
|
BIND_ENUM_CONSTANT(LOAD_STATUS_OK);
|
|
|
|
BIND_ENUM_CONSTANT(LOAD_STATUS_FAILED);
|
|
|
|
BIND_ENUM_CONSTANT(LOAD_STATUS_ALREADY_LOADED);
|
|
|
|
BIND_ENUM_CONSTANT(LOAD_STATUS_NOT_LOADED);
|
|
|
|
BIND_ENUM_CONSTANT(LOAD_STATUS_NEEDS_RESTART);
|
|
|
|
}
|
|
|
|
|
|
|
|
NativeExtensionManager *NativeExtensionManager::singleton = nullptr;
|
|
|
|
|
|
|
|
NativeExtensionManager::NativeExtensionManager() {
|
|
|
|
ERR_FAIL_COND(singleton != nullptr);
|
|
|
|
singleton = this;
|
|
|
|
}
|