c6204279eb
# Objective - Contributes to #15460 - Supersedes #8520 - Fixes #4906 ## Solution - Added a new `web` feature to `bevy`, and several of its crates. - Enabled new `web` feature automatically within crates without `no_std` support. ## Testing - `cargo build --no-default-features --target wasm32v1-none` --- ## Migration Guide When using Bevy crates which _don't_ automatically enable the `web` feature, please enable it when building for the browser. ## Notes - I added [`cfg_if`](https://crates.io/crates/cfg-if) to help manage some of the feature gate gore that this extra feature introduces. It's still pretty ugly, but I think much easier to read. - Certain `wasm` targets (e.g., [wasm32-wasip1](https://doc.rust-lang.org/nightly/rustc/platform-support/wasm32-wasip1.html#wasm32-wasip1)) provide an incomplete implementation for `std`. I have not tested these platforms, but I suspect Bevy's liberal use of usually unsupported features (e.g., threading) will cause these targets to fail. As such, consider `wasm32-unknown-unknown` as the only `wasm` platform with support from Bevy for `std`. All others likely will need to be treated as `no_std` platforms.
97 lines
3.0 KiB
TOML
97 lines
3.0 KiB
TOML
[package]
|
|
name = "bevy_tasks"
|
|
version = "0.16.0-dev"
|
|
edition = "2024"
|
|
description = "A task executor for Bevy Engine"
|
|
homepage = "https://bevyengine.org"
|
|
repository = "https://github.com/bevyengine/bevy"
|
|
license = "MIT OR Apache-2.0"
|
|
keywords = ["bevy"]
|
|
|
|
[features]
|
|
default = ["std", "async_executor"]
|
|
|
|
# Functionality
|
|
|
|
## Enables multi-threading support.
|
|
## Without this feature, all tasks will be run on a single thread.
|
|
multi_threaded = ["std", "dep:async-channel", "dep:concurrent-queue"]
|
|
|
|
## Uses `async-executor` as a task execution backend.
|
|
## This backend is incompatible with `no_std` targets.
|
|
async_executor = ["std", "dep:async-executor"]
|
|
|
|
# Platform Compatibility
|
|
|
|
## Allows access to the `std` crate. Enabling this feature will prevent compilation
|
|
## on `no_std` targets, but provides access to certain additional features on
|
|
## supported platforms.
|
|
std = [
|
|
"futures-lite/std",
|
|
"async-task/std",
|
|
"bevy_platform_support/std",
|
|
"once_cell/std",
|
|
]
|
|
|
|
## `critical-section` provides the building blocks for synchronization primitives
|
|
## on all platforms, including `no_std`.
|
|
critical-section = ["bevy_platform_support/critical-section"]
|
|
|
|
## Enables use of browser APIs.
|
|
## Note this is currently only applicable on `wasm32` architectures.
|
|
web = [
|
|
"bevy_platform_support/web",
|
|
"dep:wasm-bindgen-futures",
|
|
"dep:pin-project",
|
|
"dep:futures-channel",
|
|
]
|
|
|
|
[dependencies]
|
|
bevy_platform_support = { path = "../bevy_platform_support", version = "0.16.0-dev", default-features = false, features = [
|
|
"alloc",
|
|
] }
|
|
|
|
futures-lite = { version = "2.0.1", default-features = false, features = [
|
|
"alloc",
|
|
] }
|
|
async-task = { version = "4.4.0", default-features = false }
|
|
derive_more = { version = "1", default-features = false, features = [
|
|
"deref",
|
|
"deref_mut",
|
|
] }
|
|
cfg-if = "1.0.0"
|
|
async-executor = { version = "1.11", optional = true }
|
|
async-channel = { version = "2.3.0", optional = true }
|
|
async-io = { version = "2.0.0", optional = true }
|
|
concurrent-queue = { version = "2.0.0", optional = true }
|
|
atomic-waker = { version = "1", default-features = false }
|
|
once_cell = { version = "1.18", default-features = false, features = [
|
|
"critical-section",
|
|
] }
|
|
crossbeam-queue = { version = "0.3", default-features = false, features = [
|
|
"alloc",
|
|
] }
|
|
|
|
[target.'cfg(target_arch = "wasm32")'.dependencies]
|
|
wasm-bindgen-futures = { version = "0.4", optional = true }
|
|
pin-project = { version = "1", optional = true }
|
|
futures-channel = { version = "0.3", optional = true }
|
|
|
|
[target.'cfg(not(all(target_has_atomic = "8", target_has_atomic = "16", target_has_atomic = "32", target_has_atomic = "64", target_has_atomic = "ptr")))'.dependencies]
|
|
async-task = { version = "4.4.0", default-features = false, features = [
|
|
"portable-atomic",
|
|
] }
|
|
heapless = { version = "0.8", default-features = false, features = [
|
|
"portable-atomic",
|
|
] }
|
|
atomic-waker = { version = "1", default-features = false, features = [
|
|
"portable-atomic",
|
|
] }
|
|
|
|
[lints]
|
|
workspace = true
|
|
|
|
[package.metadata.docs.rs]
|
|
rustdoc-args = ["-Zunstable-options", "--generate-link-to-definition"]
|
|
all-features = true
|