Struct App 

pub struct App {
    pub world: World,
    /* private fields */
}

AnvilKit 应用框架

基于 Bevy ECS 构建的应用容器，提供系统调度、插件管理和生命周期控制。

特性

• 插件系统: 支持模块化的功能扩展
• 系统调度: 灵活的系统执行顺序和并行控制
• 资源管理: 全局资源的存储和访问
• 事件系统: 组件间的松耦合通信

示例

use anvilkit_ecs::prelude::*;
use anvilkit_ecs::schedule::AnvilKitSchedule;

let mut app = App::new();
app.add_plugins(AnvilKitEcsPlugin)
   .add_systems(AnvilKitSchedule::Update, movement_system)
   .run();

fn movement_system() {
    // 系统逻辑
}

Fields

world: World

ECS 世界，存储所有实体、组件和资源

Implementations

impl App

pub fn new() -> App

创建新的应用实例

示例

use anvilkit_ecs::app::App;
 
let app = App::new();

pub fn add_plugins<P>(&mut self, plugin: P) -> &mut App

where P: Plugin,

添加插件到应用

参数

• plugin: 要添加的插件

示例

use anvilkit_ecs::prelude::*;
 
let mut app = App::new();
app.add_plugins(AnvilKitEcsPlugin);

pub fn add_systems<M>( &mut self, schedule: impl ScheduleLabel, systems: impl IntoSystemConfigs<M>, ) -> &mut App

添加系统到指定调度

参数

• schedule: 调度标签
• systems: 要添加的系统

示例

use anvilkit_ecs::prelude::*;
use anvilkit_ecs::schedule::AnvilKitSchedule;

let mut app = App::new();
app.add_systems(AnvilKitSchedule::Update, my_system);

fn my_system() {
    println!("系统运行中");
}

pub fn insert_resource<R>(&mut self, resource: R) -> &mut App

where R: Resource,

插入资源到世界

参数

• resource: 要插入的资源

示例

use anvilkit_ecs::prelude::*;
 
#[derive(Resource)]
struct GameConfig {
    difficulty: u32,
}
 
let mut app = App::new();
app.insert_resource(GameConfig { difficulty: 1 });

pub fn init_resource<R>(&mut self) -> &mut App

where R: Resource + FromWorld,

初始化资源（如果不存在）

示例

use anvilkit_ecs::prelude::*;
 
#[derive(Resource, Default)]
struct Score(u32);
 
let mut app = App::new();
app.init_resource::<Score>();

pub fn run(&mut self)

运行应用的主循环

这将持续运行主调度器，直到应用被标记为退出。

示例

use anvilkit_ecs::prelude::*;
 
let mut app = App::new();
app.add_plugins(AnvilKitEcsPlugin)
   .run();

pub fn update(&mut self)

执行一次更新循环

运行主调度器一次，处理所有系统。

示例

use anvilkit_ecs::prelude::*;
 
let mut app = App::new();
app.add_plugins(AnvilKitEcsPlugin);
 
// 手动控制更新
for _ in 0..10 {
    app.update();
}

pub fn exit(&mut self)

标记应用应该退出

示例

use anvilkit_ecs::prelude::*;
 
fn exit_system(mut app_exit: ResMut<AppExit>) {
    app_exit.exit();
}

pub fn should_exit(&self) -> bool

检查应用是否应该退出

Trait Implementations

impl Default for App

fn default() -> App

Returns the “default value” for a type.