Home | History | Annotate | Download | only in design
      1 sync-and-gyp
      2 ============
      3 
      4 [`sync-and-gyp`](https://skia.googlesource.com/skia.git/+/master/bin/sync-and-gyp)
      5 is a Python program that wraps `gclient sync` and `gyp_skia`.
      6 Motivations for using it:
      7 
      8 -  Fewer steps to configure and compile Skia and Skia's dependencies.
      9    This makes documentation cleaner, too.
     10 
     11 -  Written in Python, so it will work on all platforms.  Python is
     12    already necessary for gyp.
     13 
     14 -  Sets up gclient better than `gclient config`, which has been broken.
     15 
     16 -  Checks to see if the `DEPS` file has changed since it last ran
     17    `gclient sync`.  If not, it skips that step.
     18 
     19 -  Checks to see if gyp needs to be re-run (it checks environment
     20    variables and changed or added files); if not, it skips running
     21    `gyp_skia`.
     22 
     23 -  Since running `sync-and-gyp` is fast when it can do nothing, it is
     24    easy to do before every recompile of Skia.  This is a good habit.
     25