Mirrors/servo
1
0
Fork 0
mirror of https://github.com/servo/servo.git synced 2025-07-22 23:03:42 +01:00
Code Issues Projects Releases Packages Wiki Activity
servo/components/bluetooth
History
Martin Robinson 0e616e0c5d
api: Flatten and simplify Servo preferences (#34966) 
Flatten and simplify Servo's preferences code. In addition, have both
preferences and options passed in as arguments to `Servo::new()` and
make sure not to use the globally set preferences in `servoshell` (as
much as possible now).

Instead of a complex procedural macro to generate preferences, just
expose a very simple derive macro that adds string based getters and
setters.

- All command-line parsing is moved to servoshell.
- There is no longer the concept of a missing preference.
- Preferences no longer have to be part of the resources bundle because
  they now have reasonable default values.
- servoshell specific preferences are no longer part of the preferences
  exposed by the Servo API.

Signed-off-by: Martin Robinson <mrobinson@igalia.com>
2025-01-14 13:54:06 +00:00
..
adapter.rs clippy: fix warnings in components/bluetooth (#31566) 2024-03-07 23:32:35 +00:00
bluetooth.rs clippy: fix warnings in components/bluetooth (#31566) 2024-03-07 23:32:35 +00:00
Cargo.toml Add rust-version to all Cargo.toml files (#33483) 2024-09-17 16:39:07 +00:00
empty.rs clippy: fix some warnings in desktop and some components (#32583) 2024-06-25 07:04:23 +00:00
lib.rs api: Flatten and simplify Servo preferences (#34966) 2025-01-14 13:54:06 +00:00
macros.rs fix conditional logic that enables native bluetooth (#31073) 2024-01-12 09:24:39 +00:00
README.md Integrate the devices respository (#30974) 2024-01-09 09:13:41 +00:00
test.rs clippy: fix warnings in components/bluetooth (#31566) 2024-03-07 23:32:35 +00:00

README.md

Bluetooth Rust lib using macOS CoreBluetooth

Build Status Crates.io

The main aim of BlurMac is to enable WebBluetooth in Servo on macOS. Thus, API and implementation decisions are affected by the encapsulating Devices, and the sibling BlurZ and BlurDroid crates.

Run Servo with WebBluetooth Enabled

Usually, you don't want to work with BlurMac on its own but use it within Servo. So, most probably you'll want to run Servo with WebBluetooth enabled:

RUST_LOG=blurmac \
./mach run \
    --dev \
    --pref=dom.bluetooth.enabled \
    --pref=dom.permissions.testing.allowed_in_nonsecure_contexts \
    URL

Notes:

  • The above command is actually not really BlurMac-specific (except for the RUST_LOG part). It runs Servo with WBT enabled on any platform where WBT is supported.
  • You don't need the RUST_LOG=blurmac part if you don't want to see BlurMac debug messages on the console.
  • You don't need the --dev part if you want to run a release build.
  • You don't need the --pref=dom.permissions.testing.allowed_in_nonsecure_contexts part if your URL is https (but you do need it if you test a local file).

Known Issues

  • Device RSSI can not be retrieved yet.
  • Support for included services is incomplete.
  • Descriptors are not supported yet.
  • Notifications on characteristics are not supported yet (the limitation comes from Devices).

Compatibility

Tested on:

  • macOS Sierra 10.12.

Copyright and Licensing

Licensed under the BSD 3-Clause License.