Mirrors/servo
1
0
Fork 0
mirror of https://github.com/servo/servo.git synced 2025-06-04 07:35:36 +00:00
Code Issues Projects Releases Packages Wiki Activity
The Servo Browser Engine
48662 commits 147 branches 5 tags 1.7 GiB
Find a file
Delan Azabani 34d9be70f9
Update in-tree docs to point to the new book (#32743) 
* Update in-tree docs to point to the new book

* Revive build setup section in README as quickstart guide

* Apply feedback about titles
2024-07-09 15:42:00 +00:00
.cargo Make crown optional (#32494) 2024-06-24 11:46:43 +00:00
.github ci: fix security issue in try job workflow (#32724) 2024-07-08 10:08:23 +00:00
.vscode Format toml files (#30112) 2023-08-17 15:07:43 +00:00
components Remove media element state changes triggered by network responses (#32643) 2024-07-09 06:48:44 +00:00
docs Update in-tree docs to point to the new book (#32743) 2024-07-09 15:42:00 +00:00
etc Update in-tree docs to point to the new book (#32743) 2024-07-09 15:42:00 +00:00
ports/servoshell build(deps): bump gilrs from 0.10.7 to 0.10.8 (#32734) 2024-07-08 17:21:42 +00:00
python android: fix application name used in ./mach run (#32652) 2024-07-01 08:10:00 +00:00
resources layout: Add support for table captions (#32657) 2024-07-03 18:24:19 +00:00
support android: sign release APK with a custom key. (#32721) 2024-07-08 08:36:00 +00:00
tests Update in-tree docs to point to the new book (#32743) 2024-07-09 15:42:00 +00:00
third_party Update WebIDL.py (#32495) 2024-06-15 04:22:42 +00:00
.clang-format Run test-tidy on Windows 2019-11-21 09:56:39 +01:00
.flake8 Improve formatting of Python files (#30919) 2023-12-24 23:58:37 +00:00
.gitattributes mark test/wpt as vendored in .gitattributes (#32663) 2024-07-02 11:23:18 +00:00
.gitignore Android: load url from Intent, plus fixed some warnings (#32160) 2024-04-29 13:14:10 +00:00
.mailmap Update Tetsuharu OHZEKI's entry in mailmap 2019-11-15 00:46:45 +09:00
Cargo.lock build(deps): bump target-lexicon from 0.12.14 to 0.12.15 (#32737) 2024-07-09 03:57:54 +00:00
Cargo.toml build(deps): bump serde from 1.0.203 to 1.0.204 (#32735) 2024-07-08 17:25:57 +00:00
CLOBBER
CODE_OF_CONDUCT.md Add CoC and Security Policy (#31622) 2024-03-12 11:24:01 +00:00
CONTRIBUTING.md Update in-tree docs to point to the new book (#32743) 2024-07-09 15:42:00 +00:00
deny.toml Add cargo-deny to mach-tidy to check license compliance. (#32465) 2024-06-12 09:54:45 +00:00
Info.plist remove bhtml 2018-02-11 08:02:39 +01:00
LICENSE Update MPL license to https (part 1) 2018-11-19 14:46:43 +01:00
mach Make Android build optional on Nix (#31231) 2024-02-02 02:13:24 +00:00
mach.bat Make mach.bat request Python 3 2021-05-22 18:27:10 +09:00
PULL_REQUEST_TEMPLATE.md Minor pull request template cleanup 2018-12-08 13:11:37 -08:00
README.md Update in-tree docs to point to the new book (#32743) 2024-07-09 15:42:00 +00:00
rust-toolchain.toml Update to Rust 1.78 (#32217) 2024-06-01 06:49:28 +00:00
rustfmt.toml mach: Do not use unstable rust for rustfmt (#31441) 2024-02-28 13:53:04 +00:00
SECURITY.md Update new issue URL in SECURITY.md (#31698) 2024-03-15 15:03:49 +00:00
servo-tidy.toml build(deps): bump mime_guess from 2.0.4 to 2.0.5 (#32660) 2024-07-01 18:29:06 +00:00
servobuild.example Add OpenHarmony support to mach and CI (#32507) 2024-06-17 11:27:23 +00:00
shell.nix Nix: allow nix-shell without explicit path to shell.nix (#32035) 2024-04-17 07:02:31 +00:00
taplo.toml Format toml files (#30112) 2023-08-17 15:07:43 +00:00

README.md

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. Check out The Servo Book to get started, or go to servo.org for news and guides.

Getting started

For more detailed build instructions, see the Servo book under Setting up your environment, Building Servo, and Building for Android.

macOS

  • Download and install python, Xcode, and brew
  • Install rustup: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • Restart your shell to make sure cargo is available
  • Install the other dependencies: ./mach bootstrap
  • Build servoshell: ./mach build

Linux

  • Install curl and python:
    • Arch: sudo pacman -S --needed curl python python-pip
    • Debian, Ubuntu: sudo apt install curl python3-pip python3-venv
    • Fedora: sudo dnf install curl python3 python3-pip python3-devel
    • Gentoo: sudo emerge net-misc/curl dev-python/pip
  • Install rustup: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • Restart your shell to make sure cargo is available
  • Install the other dependencies: ./mach bootstrap
  • Build servoshell: ./mach build

Windows

  • Download and install python, choco, and rustup
    • Be sure to select Quick install via the Visual Studio Community installer
  • In the Visual Studio Installer, ensure the following components are installed:
    • 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)
  • Restart your shell to make sure cargo is available
  • Install the other dependencies: .\mach bootstrap
  • Build servoshell: .\mach build

Android

  • Ensure that the following environment variables are set:
    • ANDROID_SDK_ROOT
    • ANDROID_NDK_ROOT: $ANDROID_SDK_ROOT/ndk/25.2.9519653/ ANDROID_SDK_ROOT can be any directory (such as ~/android-sdk). All of the Android build dependencies will be installed there.
  • Install the latest version of the Android command-line tools to $ANDROID_SDK_ROOT/cmdline-tools/latest.
  • Run the following command to install the necessary components: 
    sudo $ANDROID_SDK_ROOT/cmdline-tools/latest/bin/sdkmanager --install
 "build-tools;33.0.2" \
 "emulator" \
 "ndk;25.2.9519653" \
 "platform-tools" \
 "platforms;android-33" \
 "system-images;android-33;google_apis;x86_64"
  • Follow the instructions above for the platform you are building on