Skip to content

Commit 81f0a5d

Browse files
authored
Add release notes for #17216. (#2011)
1 parent 9c94dfc commit 81f0a5d

File tree

1 file changed

+28
-1
lines changed

1 file changed

+28
-1
lines changed
Lines changed: 28 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,31 @@
11
<!-- Stop automatically generating meta files for assets while using asset processing. -->
22
<!-- https://github.com/bevyengine/bevy/pull/17216 -->
33

4-
<!-- TODO -->
4+
In Bevy 0.12, we introduced "Assets V2". This was a complete rewrite of our asset system and
5+
included all sorts of cool features. One of those was "asset preprocessing". This allows defining
6+
a `Process` to apply to assets before they are loaded for use in the engine. This however
7+
necessitated "meta files" for every asset in your project - meaning when you started using asset
8+
preprocessing *at all*, your entire `assets` folder would be filled with these meta files
9+
automatically (even for assets that don't need any preprocessing).
10+
11+
To alleviate this pain, enabling asset preprocessing no longer automatically writes meta files! This
12+
makes it easier to enable asset preprocessing and adopt it gradually.
13+
14+
In addition, we've added `AssetServer::write_default_loader_meta_file_for_path` and
15+
`AssetProcessor::write_default_meta_file_for_path` to allow users to explicitly generate the default
16+
meta files for assets when necessary.
17+
18+
Consider enabling asset processing with:
19+
20+
```rust
21+
app.add_plugins(DefaultPlugins.set(
22+
AssetPlugin {
23+
mode: AssetMode::Processed,
24+
..default()
25+
}
26+
));
27+
```
28+
29+
Enabling the `bevy/asset_processor` feature will then process files automatically for you. See
30+
[the asset processing example](https://github.com/bevyengine/bevy/blob/main/examples/asset/processing/asset_processing.rs)
31+
for more details!

0 commit comments

Comments
 (0)