bevy/crates/bevy_ui/src
Trashtalk217 d1bd46d45e
Deprecate get_or_spawn (#15652)
# Objective

After merging retained rendering world #15320, we now have a good way of
creating a link between worlds (*HIYAA intensifies*). This means that
`get_or_spawn` is no longer necessary for that function. Entity should
be opaque as the warning above `get_or_spawn` says. This is also part of
#15459.

I'm deprecating `get_or_spawn_batch` in a different PR in order to keep
the PR small in size.

## Solution

Deprecate `get_or_spawn` and replace it with `get_entity` in most
contexts. If it's possible to query `&RenderEntity`, then the entity is
synced and `render_entity.id()` is initialized in the render world.

## Migration Guide

If you are given an `Entity` and you want to do something with it, use
`Commands.entity(...)` or `World.entity(...)`. If instead you want to
spawn something use `Commands.spawn(...)` or `World.spawn(...)`. If you
are not sure if an entity exists, you can always use `get_entity` and
match on the `Option<...>` that is returned.

---------

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
2024-10-07 16:08:22 +00:00
..
layout Migrate cameras to required components (#15641) 2024-10-05 01:59:52 +00:00
render Deprecate get_or_spawn (#15652) 2024-10-07 16:08:22 +00:00
widget Rename BreakLineOn to LineBreak (#15583) 2024-10-01 22:30:50 +00:00
accessibility.rs Add UI GhostNode (#15341) 2024-10-02 00:24:28 +00:00
focus.rs use precomputed border values (#15163) 2024-09-26 23:10:35 +00:00
geometry.rs Add core and alloc over std Lints (#15281) 2024-09-27 00:59:59 +00:00
ghost_hierarchy.rs Add UI GhostNode (#15341) 2024-10-02 00:24:28 +00:00
lib.rs Invert the dependency between bevy_animation and bevy_ui (#15634) 2024-10-04 01:27:20 +00:00
measurement.rs Add core and alloc over std Lints (#15281) 2024-09-27 00:59:59 +00:00
node_bundles.rs Rename BreakLineOn to LineBreak (#15583) 2024-10-01 22:30:50 +00:00
picking_backend.rs Get rid of unnecessary mutable access in ui picking backend (#15630) 2024-10-03 21:30:52 +00:00
stack.rs Add UI GhostNode (#15341) 2024-10-02 00:24:28 +00:00
ui_material.rs Add core and alloc over std Lints (#15281) 2024-09-27 00:59:59 +00:00
ui_node.rs Migrate cameras to required components (#15641) 2024-10-05 01:59:52 +00:00
update.rs Add UI GhostNode (#15341) 2024-10-02 00:24:28 +00:00