mirror of
https://github.com/servo/servo.git
synced 2025-09-29 16:19:14 +01:00
The Servo Browser Engine
3fba332316
Bumps [bytemuck](https://github.com/Lokathor/bytemuck) from 1.14.0 to 1.14.1. <details> <summary>Changelog</summary> <p><em>Sourced from <a href="https://github.com/Lokathor/bytemuck/blob/main/changelog.md">bytemuck's changelog</a>.</em></p> <blockquote> <h2>1.14.1</h2> <ul> <li>docs clarifications.</li> </ul> <h2>1.14</h2> <ul> <li><code>write_zeroes</code> and <code>fill_zeroes</code> functions: Writes (to one) or fills (a slice) zero bytes to all bytes covered by the provided reference. If your type has padding, this will even zero out the padding bytes.</li> <li><code>align_offset</code> feature: causes pointer alignment checks to use the <code>align_offset</code> pointer method rather than as-casting the pointer to <code>usize</code>. This <em>may</em> improve codegen, if the compiler would have otherwise thought that the pointer address escaped. No formal benchmarks have been done either way.</li> <li><code>must_cast</code> feature: Adds <code>must_*</code> family of functions. These functions will fail to compile if the cast requested can't be statically known to succeed. The error messages can be kinda bad when this happens, but eliminating the possibility of a runtime error might be worth it to you.</li> </ul> <h2>1.13.1</h2> <ul> <li>Remove the requirement for the <em>source</em> data type to be <code>AnyBitPattern</code> on <code>pod_collect_to_vec</code>, allowing you to pod collect vecs of <code>char</code> into vecs of <code>u32</code>, or whatever.</li> </ul> <h2>1.13</h2> <ul> <li>Now depends on <code>bytemuck_derive-1.4.0</code></li> <li>Various small enhancements that would have been patch version updates, but which have been rolled into this minor version update.</li> </ul> <h2>1.12.4</h2> <ul> <li>This has additional impls for existing traits and cleans up some internal code, but there's no new functions so I guess it counts as just a patch release.</li> </ul> <h2>1.12.3</h2> <ul> <li>This bugfix makes the crate do stuff with <code>Arc</code> or not based on the <code>target_has_atomic</code> config. Previously, some targets that have allocation but not atomics were getting errors. This raises the MSRV of the <code>extern_crate_alloc</code> feature to 1.60, but opt-in features are <em>not</em> considered to be hard locked to 1.34 like the basic build of the crate is.</li> </ul> <h2>1.12.2</h2> <ul> <li>Fixes <code>try_pod_read_unaligned</code> bug that made it always fail unless the target type was exactly pointer sized in which case UB <em>could</em> happen. The <code>CheckedBitPattern::is_valid_bit_pattern</code> was being asked to check that a <em>reference</em> to the <code>pod</code> value was a valid bit pattern, rather than the actual bit pattern itself, and so the check could in some cases be illegally</li> </ul> <!-- raw HTML omitted --> </blockquote> <p>... (truncated)</p> </details> <details> <summary>Commits</summary> <ul> <li><a href=" |
||
|---|---|---|
| .cargo | ||
| .github | ||
| .vscode | ||
| components | ||
| docs | ||
| etc | ||
| ports | ||
| python | ||
| resources | ||
| support | ||
| tests | ||
| third_party | ||
| .clang-format | ||
| .flake8 | ||
| .gitattributes | ||
| .gitignore | ||
| .mailmap | ||
| Cargo.lock | ||
| Cargo.toml | ||
| CLOBBER | ||
| CONTRIBUTING.md | ||
| dependencyci.yml | ||
| Info.plist | ||
| LICENSE | ||
| mach | ||
| mach.bat | ||
| PULL_REQUEST_TEMPLATE.md | ||
| README.md | ||
| rust-toolchain.toml | ||
| rustfmt.toml | ||
| servo-tidy.toml | ||
| servobuild.example | ||
| taplo.toml | ||
The Servo Parallel Browser Engine Project
Servo is a prototype web browser engine written in the Rust language. It is currently developed on 64-bit macOS, 64-bit Linux, 64-bit Windows, and Android.
Servo welcomes contribution from everyone. See
CONTRIBUTING.md and HACKING_QUICKSTART.md
for help getting started.
Visit the Servo Project page for news and guides.
Build Setup
If these instructions fail or you would like to install dependencies manually, try the manual build setup.
macOS
- Ensure that the version showed by
python --versionis >= 3.10: - Install Xcode
- Install Homebrew
- Run
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh - Run
./mach bootstrap
Note: This will install the recommended version of GStreamer globally on your system.
Linux
- Run
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh - Install Python (version >= 3.10):
- Debian-like: Run
sudo apt install python3-pip python3-venv - Fedora: Run
sudo dnf install python3 python3-pip python3-devel - Arch: Run
sudo pacman -S --needed python python-pip - Gentoo: Run
sudo emerge dev-python/pip
- Debian-like: Run
- Run
./mach bootstrap
Windows
- Download and run
rustup-init.exe - Make sure to select Quick install via the Visual Studio Community installer or otherwise install Visual Studio 2022.
- In the Visual Studio Installer ensure the following components are installed for Visual Studio 2022:
- Windows 10 SDK (10.0.19041.0) (
Microsoft.VisualStudio.Component.Windows10SDK.19041) - MSVC v143 - VS 2022 C++ x64/x86 build tools (Latest) (
Microsoft.VisualStudio.Component.VC.Tools.x86.x64) - C++ ATL for latest v143 build tools (x86 & x64) (
Microsoft.VisualStudio.Component.VC.ATL) - C++ MFC for latest v143 build tools (x86 & x64) (
Microsoft.VisualStudio.Component.VC.ATLMFC)
- Windows 10 SDK (10.0.19041.0) (
- Install chocolatey
- Install Python 3.11
- Run
mach bootstrap- *This will install CMake, Git, Ninja, via choco in an
- This will install CMake, Git, and Ninja via choco in an Administrator console. Allow the scripts to run and once the operation finishes, close the new console.
- Run
refreshenv
See also Windows Troubleshooting Tips.
Cloning the Repo
Your CARGO_HOME needs to point to (or be in) the same drive as your Servo repository (See #28530).
git clone https://github.com/servo/servo
cd servo
Building
Servo is built with Cargo, the Rust package manager. We also use Mozilla's Mach tools to orchestrate the build and other tasks. You can call Mach like this:
On Unix systems:
./mach [command] [arguments]
On Windows Commandline:
mach.bat [command] [arguments]
The examples below will use Unix, but the same applies to Windows.
The Rust compiler
Servo's build system uses rustup.rs to automatically download a Rust compiler.
This is a specific version of Rust Nightly determined by the
rust-toolchain.toml file.
Normal build
To build Servo in development mode. This is useful for development, but the resulting binary is very slow:
./mach build --dev
./mach run tests/html/about-mozilla.html
Release build
For benchmarking, performance testing, or real-world use.
Add the --release flag to create an optimized build:
./mach build --release
./mach run --release tests/html/about-mozilla.html
Checking for build errors, without building
If you’re making changes to one crate that cause build errors in another crate, consider this instead of a full build:
./mach check
It will run cargo check, which runs the analysis phase of the compiler
(and so shows build errors if any) but skips the code generation phase.
This can be a lot faster than a full build,
though of course it doesn’t produce a binary you can run.
Building for Android target
Prerequisites:
Servo's build system assumes that both the Android SDK & NDK are
already installed and expects the paths to be specified via the
environment variables ANDROID_SDK_ROOT and ANDROID_NDK_ROOT.
Servo also expects the following components are installed via sdkmanager:
For building:
sdkmanager install platform-tools platforms;android-33
To run in emulator, also install the related components:
sdkmanager install emulator system-images;android-33;google_apis;x86
Build commands:
For ARM (armv7-linux-androideabi, most phones):
./mach build --release --android
./mach package --release --android
For x86 (typically for the emulator):
./mach build --release --target i686-linux-android
./mach package --release --target i686-linux-android
Install the APK to the device or emulator:
./mach install --release --android
Running
Run Servo with the command:
./servo [url] [arguments] # if you run with nightly build
./mach run [url] [arguments] # if you run with mach
# For example
./mach run https://www.google.com
Commandline Arguments
-p INTERVALturns on the profiler and dumps info to the console everyINTERVALseconds-s SIZEsets the tile size for painting; defaults to 512-zdisables all graphical output; useful for running JS / layout tests-Z helpdisplays useful output to debug servo
Keyboard Shortcuts
Ctrl+Lopens URL prompt (Cmd+Lon Mac)Ctrl+Rreloads current page (Cmd+Ron Mac)Ctrl+-zooms out (Cmd+-on Mac)Ctrl+=zooms in (Cmd+=on Mac)Alt+left arrowgoes backwards in the history (Cmd+left arrowon Mac)Alt+right arrowgoes forwards in the history (Cmd+right arrowon Mac)EscorCtrl+Qexits Servo (Cmd+Qon Mac)
Runtime dependencies
Linux
GStreamer>=1.16gst-plugins-bad>=1.16libXcursorlibXrandrlibXilibxkbcommonvulkan-loader
Developing
There are lots of mach commands you can use. You can list them with ./mach --help.
The generated documentation can be found on https://doc.servo.org/servo/index.html