Skip to content

building.md

Latest commit

 

History

History
46 lines (31 loc) · 1.42 KB

building.md

File metadata and controls

46 lines (31 loc) · 1.42 KB

Building Dawn

System requirements

  • Linux

    • The pkg-config command: 
      # Install pkg-config on Ubuntu
sudo apt-get install pkg-config

  • Mac

    • Xcode 12.2+.
    • The macOS 11.0 SDK. Run xcode-select to check whether you have it. 
      ls `xcode-select -p`/Platforms/MacOSX.platform/Developer/SDKs

Install depot_tools

Dawn uses the Chromium build system and dependency management so you need to install depot_tools and add it to the PATH.

Get the code

# Clone the repo as "dawn"
git clone https://dawn.googlesource.com/dawn dawn && cd dawn

# Bootstrap the gclient configuration
cp scripts/standalone.gclient .gclient

# Fetch external dependencies and toolchains with gclient
gclient sync

Build Dawn

Then generate build files using gn args out/Debug or gn args out/Release. A text editor will appear asking build options, the most common option is is_debug=true/false; otherwise gn args out/Release --list shows all the possible options.

On macOS you'll want to add the use_system_xcode=true in most cases. (and if you're a googler please get XCode from go/xcode).

Then use ninja -C out/Release to build dawn and for example ./out/Release/dawn_end2end_tests to run the tests.