mirror of
https://github.com/bevyengine/bevy
synced 2024-11-23 05:03:47 +00:00
6d6bc2a8b4
This is extracted out of eb8f973646476b4a4926ba644a77e2b3a5772159 and includes some additional changes to remove all references to AppBuilder and fix examples that still used App::build() instead of App::new(). In addition I didn't extract the sub app feature as it isn't ready yet. You can use `git diff --diff-filter=M eb8f973646476b4a4926ba644a77e2b3a5772159` to find all differences in this PR. The `--diff-filtered=M` filters all files added in the original commit but not in this commit away. Co-Authored-By: Carter Anderson <mcanders1@gmail.com>
34 lines
1.2 KiB
Rust
34 lines
1.2 KiB
Rust
use libloading::{Library, Symbol};
|
|
|
|
use bevy_app::{App, CreatePlugin, Plugin};
|
|
|
|
/// Dynamically links a plugin a the given path. The plugin must export a function with the
|
|
/// [`CreatePlugin`] signature named `_bevy_create_plugin`.
|
|
///
|
|
/// # Safety
|
|
///
|
|
/// The specified plugin must be linked against the exact same libbevy.so as this program.
|
|
/// In addition the `_bevy_create_plugin` symbol must not be manually created, but instead created
|
|
/// by deriving `DynamicPlugin` on a unit struct implementing [`Plugin`].
|
|
pub unsafe fn dynamically_load_plugin(path: &str) -> (Library, Box<dyn Plugin>) {
|
|
let lib = Library::new(path).unwrap();
|
|
let func: Symbol<CreatePlugin> = lib.get(b"_bevy_create_plugin").unwrap();
|
|
let plugin = Box::from_raw(func());
|
|
(lib, plugin)
|
|
}
|
|
|
|
pub trait DynamicPluginExt {
|
|
/// # Safety
|
|
///
|
|
/// Same as [`dynamically_load_plugin`].
|
|
unsafe fn load_plugin(&mut self, path: &str) -> &mut Self;
|
|
}
|
|
|
|
impl DynamicPluginExt for App {
|
|
unsafe fn load_plugin(&mut self, path: &str) -> &mut Self {
|
|
let (lib, plugin) = dynamically_load_plugin(path);
|
|
std::mem::forget(lib); // Ensure that the library is not automatically unloaded
|
|
plugin.build(self);
|
|
self
|
|
}
|
|
}
|