f18f28874a
# Objective - Better consistency with `add_systems`. - Deprecating `add_plugin` in favor of a more powerful `add_plugins`. - Allow passing `Plugin` to `add_plugins`. - Allow passing tuples to `add_plugins`. ## Solution - `App::add_plugins` now takes an `impl Plugins` parameter. - `App::add_plugin` is deprecated. - `Plugins` is a new sealed trait that is only implemented for `Plugin`, `PluginGroup` and tuples over `Plugins`. - All examples, benchmarks and tests are changed to use `add_plugins`, using tuples where appropriate. --- ## Changelog ### Changed - `App::add_plugins` now accepts all types that implement `Plugins`, which is implemented for: - Types that implement `Plugin`. - Types that implement `PluginGroup`. - Tuples (up to 16 elements) over types that implement `Plugins`. - Deprecated `App::add_plugin` in favor of `App::add_plugins`. ## Migration Guide - Replace `app.add_plugin(plugin)` calls with `app.add_plugins(plugin)`. --------- Co-authored-by: Carter Anderson <mcanders1@gmail.com>
60 lines
1.6 KiB
Rust
60 lines
1.6 KiB
Rust
//! Demonstrates the creation and registration of a custom plugin group.
|
|
//! [`PluginGroup`]s are a way to group sets of plugins that should be registered together.
|
|
|
|
use bevy::{app::PluginGroupBuilder, prelude::*};
|
|
|
|
fn main() {
|
|
App::new()
|
|
.add_plugins((
|
|
// Two PluginGroups that are included with bevy are DefaultPlugins and MinimalPlugins
|
|
DefaultPlugins,
|
|
// Adding a plugin group adds all plugins in the group by default
|
|
HelloWorldPlugins,
|
|
))
|
|
// You can also modify a PluginGroup (such as disabling plugins) like this:
|
|
// .add_plugins(
|
|
// HelloWorldPlugins
|
|
// .build()
|
|
// .disable::<PrintWorldPlugin>()
|
|
// .add_before::<PrintHelloPlugin, _>(
|
|
// bevy::diagnostic::LogDiagnosticsPlugin::default(),
|
|
// ),
|
|
// )
|
|
.run();
|
|
}
|
|
|
|
/// A group of plugins that produce the "hello world" behavior
|
|
pub struct HelloWorldPlugins;
|
|
|
|
impl PluginGroup for HelloWorldPlugins {
|
|
fn build(self) -> PluginGroupBuilder {
|
|
PluginGroupBuilder::start::<Self>()
|
|
.add(PrintHelloPlugin)
|
|
.add(PrintWorldPlugin)
|
|
}
|
|
}
|
|
|
|
pub struct PrintHelloPlugin;
|
|
|
|
impl Plugin for PrintHelloPlugin {
|
|
fn build(&self, app: &mut App) {
|
|
app.add_systems(Update, print_hello_system);
|
|
}
|
|
}
|
|
|
|
fn print_hello_system() {
|
|
info!("hello");
|
|
}
|
|
|
|
pub struct PrintWorldPlugin;
|
|
|
|
impl Plugin for PrintWorldPlugin {
|
|
fn build(&self, app: &mut App) {
|
|
app.add_systems(Update, print_world_system);
|
|
}
|
|
}
|
|
|
|
fn print_world_system() {
|
|
info!("world");
|
|
}
|