Struct App 

pub struct App { /* private fields */ }

The central application object.

App owns the ECS world, resources, plugins, and systems. The typical lifecycle is:

1. Create with App::new.
2. Register plugins with add_plugin.
3. Call build to run all plugin registrations, execute validate required resources, and settle AssetSync/AssetSyncDeps as far as they can go synchronously.
4. Call run to hand control to the runner.

Implementations

impl App

pub fn new() -> Self

Create a new App with an empty world and a default infinite-loop runner.

pub fn add_plugin(&mut self, plugin: impl Plugin) -> &mut Self

Queue a plugin to be built during build.

pub fn add_resource(&mut self, res: impl Component) -> &mut Self

Insert a resource into the world immediately.

pub fn get_resource<'a, T: Component>(&'a self) -> Ref<'a, T>

Borrow resource T, panicking if it is absent.

pub fn get_resource_mut<'a, T: Component>(&'a self) -> RefMut<'a, T>

Mutably borrow resource T, panicking if it is absent.

pub fn try_insert_resource<T: Component>(&mut self, res: T) -> bool

Insert resource T only if it is not already present.

Returns true if the resource was inserted.

pub fn provides<T: 'static>(&mut self) -> &mut Self

Declare that resource type T is expected to be inserted later — possibly asynchronously (a background thread’s result, a hand-rolled lazy resource) rather than up front. A system elsewhere with a hard Res<T>/ResMut<T> requirement on T will then wait quietly for it instead of App treating the absence as a configuration mistake and panicking.

GraphicsPlugin and LazyResourcePlugin already call this for the backend and lazy resource types they manage — reach for this directly only for your own resource types that arrive outside of those.

pub fn add_system<Marker>( &mut self, stage: SystemStage, system: impl IntoSystem<Marker> + 'static, ) -> &mut Self

Register a single system to run at stage.

pub fn add_systems<Marker>( &mut self, stage: SystemStage, systems: impl IntoSystemSet<Marker>, ) -> &mut Self

Register multiple systems to run at stage.

Accepts a tuple of systems via IntoSystemSet.

pub fn build(&mut self) -> &mut Self

Build all plugins and validate required resources.

Plugins may register additional plugins during their build call; this repeats until no new plugins are added, up to a hard limit of 64 passes to catch accidental infinite registration cycles.

pub fn update(&mut self)

Run every stage once per tick, in [TICK_STAGES] order. Before every tick, and again after every stage, reconverge drains AssetSync/AssetSyncDeps — so newly-queued asset or resource work is handled immediately rather than waiting for the next tick’s front pass.

pub fn set_runner<F>(&mut self, runner: F) -> &mut Self

where F: FnOnce(App) + 'static,

Replace the default runner with a custom one.

The runner receives ownership of the App and is responsible for calling update at the appropriate cadence (e.g. driven by a window event loop).

pub fn run(&mut self)

Consume the app and hand it to the configured runner.

Panics if no runner has been set.

Trait Implementations

impl Default for App

fn default() -> Self

Returns the “default value” for a type.