Repository files navigation

Servo is a prototype web browser engine written in theRust language. It is currently developed on64-bit macOS, 64-bit Linux, 64-bit Windows, 64-bit OpenHarmony, and Android.

Servo welcomes contribution from everyone. Check outThe Servo Book to get started, or go toservo.org for news and guides.

For more detailed build instructions, see the Servo book underSetting up your environment,Building Servo,Building for Android andBuilding for OpenHarmony.

• Download and installXcode andbrew.
• Installuv:curl -LsSf https://astral.sh/uv/install.sh | sh
• Installrustup:curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
• Restart your shell to make surecargo is available
• Install the other dependencies:./mach bootstrap
• Build servoshell:./mach build

• Installcurl:
  • Arch:sudo pacman -S --needed curl
  • Debian, Ubuntu:sudo apt install curl
  • Fedora:sudo dnf install curl
  • Gentoo:sudo emerge net-misc/curl
• Installuv:curl -LsSf https://astral.sh/uv/install.sh | sh
• Installrustup:curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
• Restart your shell to make surecargo is available
• Install the other dependencies:./mach bootstrap
• Build servoshell:./mach build

• Downloaduv,choco, andrustup
  • Be sure to selectQuick 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 surecargo is available
• Install the other dependencies:.\mach bootstrap
• Build servoshell:.\mach build

• Ensure that the following environment variables are set:
  • ANDROID_SDK_ROOT
  • ANDROID_NDK_ROOT:$ANDROID_SDK_ROOT/ndk/26.2.11394342/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 theAndroid command-linetools 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;34.0.0" \"emulator" \"ndk;26.2.11394342" \"platform-tools" \"platforms;android-33" \"system-images;android-33;google_apis;x86_64"

• Follow the instructions above for the platform you are building on

• Follow the instructions above for the platform you are building on to prepare the environment.
• Depending on the target distribution (e.g.HarmonyOS NEXT vs pureOpenHarmony) the build configuration will differ slightly.
• Ensure that the following environment variables are set
  • DEVECO_SDK_HOME (Required when targetingHarmonyOS NEXT)
  • OHOS_BASE_SDK_HOME (Required when targetingOpenHarmony)
  • OHOS_SDK_NATIVE (e.g.${DEVECO_SDK_HOME}/default/openharmony/native or${OHOS_BASE_SDK_HOME}/${API_VERSION}/native)
  • SERVO_OHOS_SIGNING_CONFIG: Path to json file containing a valid signing configuration for the demo app.
• Review the detailed instructions atBuilding for OpenHarmony.
• The target distribution can be modified by passing--flavor=<default|harmonyos> to `mach <build|package|install>.