Skia Quickstart Guide

WARNING: Several steps in this guide are out of sync with our automatically- tested, officially-supported processes for checking out and building Skia. The officially supported processes are the ones documented in https://skia.org; see https://skia.org/user/quick.

The steps documented within this file are more experimental in nature.

This guide assumes you've got git, ninja, and python on your path.

1. First, checkout Skia:
   • git clone https://skia.googlesource.com/skia.git
   • cd skia
2. Then download the dependencies. You only need to rerun this when the dependencies change.
   • python tools/git-sync-deps
3. Create our Ninja build files from our Gyp meta-build files. You only need to rerun this when you sync or change a .gyp file.
   • GYP_GENERATORS=ninja ./gyp_skia
4. Now, let's build Skia. There are a few options:
   • ninja -C out/Debug: no optimization, asserts enabled
   • ninja -C out/Release: optimization, asserts disabled
   • ninja -C out/Coverage: no optimization, asserts enabled, code coverage generated
5. Run some tests:
   • out/Debug/dm: runs golden master tests from gm/, unit tests from tests/
6. Make some changes:
   • git checkout -b my-new-feature origin/master
   • vim src/...
   • git commit -am "Changes for my new feature."
   • vim tests/...
   • git commit --amend -a
   • ninja -C out/Debug && out/Debug/dm && echo ok
7. Rebase your change onto the latest Skia code:
   • git pull --rebase
   • ninja -C out/Debug && out/Debug/dm && echo ok
8. Upload your change and send it out for review:
   • git cl upload -r my-skia-reviewer@google.com -s
   • git cl web
9. Go through code review, get an LGTM, submit using the checkbox on the code review page.