Home | History | Annotate | Download | only in quick 
      1 Mac OS X
      2 ========
      3 
      4 Quickstart
      5 ----------
      6 
      7 First, install [XCode](https://developer.apple.com/xcode/). 
      8 
      9 <!--?prettify lang=sh?-->
     10 
     11     # Install depot tools.
     12     git clone 'https://chromium.googlesource.com/chromium/tools/depot_tools.git'
     13     export PATH="${PWD}/depot_tools:${PATH}"
     14 
     15     # Get Skia.
     16     git clone 'https://skia.googlesource.com/skia'
     17     cd skia
     18 
     19     # Build.
     20     bin/sync-and-gyp
     21     ninja -C out/Debug
     22 
     23     # Run DM (the Skia test app) and SampleApp.
     24     out/Debug/dm
     25     out/Debug/SampleApp
     26 
     27 Prerequisites
     28 -------------
     29 
     30 Make sure the following have been installed:
     31 
     32   * XCode (Apple's development environment): required
     33     * publicly available at http://developer.apple.com/xcode/
     34     * add the optional Unix Tools to the install so you get the make command line tool.
     35   * Chromium depot_tools: required to download the source and dependencies
     36     * http://www.chromium.org/developers/how-tos/depottools
     37 
     38 Check out the source code
     39 -------------------------
     40 
     41 Follow the instructions [here](../download) for downloading the Skia source.
     42 
     43 Generate XCode projects
     44 -----------------------
     45 
     46 We use the open-source gyp tool to generate XCode projects (and analogous
     47 build scripts on other platforms) from our multiplatform "gyp" files.
     48 
     49 Two Gyp generators are used on Mac OS:
     50 
     51 *   `ninja` - Run ninja yourself, without XCode project files,
     52 
     53 *   `xcode` - Generate a XCode project
     54 
     55 To choose which ones to use, set the `GYP_GENERATORS` environment
     56 variable to a comma-delimited list of generators before running
     57 sync-and-gyp. The default value for `GYP_GENERATORS` is
     58 `ninja,xcode`.  For example to enable
     59 
     60 
     61 
     62 Before building, make sure that gyp knows to create an XCode project or ninja
     63 build files. If you leave GYP_GENERATORS undefined it will assume the
     64 following default:
     65 
     66     GYP_GENERATORS="ninja,xcode"
     67 
     68 Or you can set it to `ninja` or `xcode` alone, if you like.
     69 
     70 You can then generate the Xcode projects and ninja build files by running:
     71 
     72     python bin/sync-and-gyp
     73 
     74 Build and run tests from the command line
     75 -----------------------------------------
     76 
     77     ninja -C out/Debug dm
     78     out/Debug/dm
     79 
     80 
     81 Build and run SampleApp in the XCode IDE
     82 ----------------------------------------
     83 
     84   * Run `sync-and-gyp` as described above.
     85   * In the Finder, navigate to `$SKIA_INSTALLDIR/trunk/out/gyp`
     86   * Double-click SampleApp.xcodeproj ; this will launch XCode and open the SampleApp project
     87   * Click the Build and Run button in the top toolbar
     88   * Once the build is complete, you should see a window with lots of shaded text examples. To move through the sample app, use the following keypresses:
     89     * right- and left-arrow keys: cycle through different test pages
     90     * 'D' key: cycle through rendering methods for each test page
     91     * other keys are defined in SampleApp.cpps SampleWindow::onHandleKey() and SampleWindow::onHandleChar() methods
     92