| OLD | NEW |
| (Empty) |
| 1 Skia Quickstart Guide | |
| 2 ===================== | |
| 3 | |
| 4 | |
| 5 WARNING: Several steps in this guide are out of sync with our automatically- | |
| 6 tested, officially-supported processes for checking out and building Skia. | |
| 7 The officially supported processes are the ones documented in https://skia.org; | |
| 8 see https://skia.org/user/quick. | |
| 9 | |
| 10 The steps documented within this file are more experimental in nature. | |
| 11 | |
| 12 | |
| 13 This guide assumes you've got `git`, `ninja`, and `python` on your path. | |
| 14 | |
| 15 1. First, checkout Skia: | |
| 16 * `git clone https://skia.googlesource.com/skia.git` | |
| 17 * `cd skia` | |
| 18 2. Then download the dependencies. You only need to rerun this when | |
| 19 the dependencies change. | |
| 20 * `python tools/git-sync-deps` | |
| 21 3. Create our Ninja build files from our Gyp meta-build files. You only need | |
| 22 to rerun this when you sync or change a `.gyp` file. | |
| 23 * `GYP_GENERATORS=ninja ./gyp_skia` | |
| 24 4. Now, let's build Skia. There are a few options: | |
| 25 * `ninja -C out/Debug`: no optimization, asserts enabled | |
| 26 * `ninja -C out/Release`: optimization, asserts disabled | |
| 27 * `ninja -C out/Coverage`: no optimization, asserts enabled, code coverage g
enerated | |
| 28 5. Run some tests: | |
| 29 * `out/Debug/dm`: runs golden master tests from gm/, unit tests from tests/ | |
| 30 6. Make some changes: | |
| 31 * `git checkout -b my-new-feature origin/master` | |
| 32 * `vim src/...` | |
| 33 * `git commit -am "Changes for my new feature."` | |
| 34 * `vim tests/...` | |
| 35 * `git commit --amend -a` | |
| 36 * `ninja -C out/Debug && out/Debug/dm && echo ok` | |
| 37 7. Rebase your change onto the latest Skia code: | |
| 38 * `git pull --rebase` | |
| 39 * `ninja -C out/Debug && out/Debug/dm && echo ok` | |
| 40 8. Upload your change and send it out for review: | |
| 41 * `git cl upload -r my-skia-reviewer@google.com -s` | |
| 42 * `git cl web` | |
| 43 9. Go through code review, get an LGTM, submit using the checkbox on the code re
view page. | |
| OLD | NEW |