| Index: site/user/quick/macos.md
|
| diff --git a/site/user/quick/macos.md b/site/user/quick/macos.md
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..ed74551d8b123fe118e2eb67d3e19d883775667b
|
| --- /dev/null
|
| +++ b/site/user/quick/macos.md
|
| @@ -0,0 +1,69 @@
|
| +Mac OS X
|
| +========
|
| +
|
| +Prerequisites
|
| +-------------
|
| +
|
| +Make sure the following have been installed:
|
| +
|
| + * XCode (Apple's development environment): required
|
| + * publicly available at http://developer.apple.com/xcode/
|
| + * add the optional Unix Tools to the install so you get the make command line tool.
|
| + * Chromium depot_tools: required to download the source and dependencies
|
| + * http://www.chromium.org/developers/how-tos/depottools
|
| +
|
| +Check out the source code
|
| +-------------------------
|
| +
|
| +See the instructions [here](../download).
|
| +
|
| +Generate XCode projects
|
| +-----------------------
|
| +
|
| +We use the open-source gyp tool to generate XCode projects (and analogous
|
| +build scripts on other platforms) from our multiplatform "gyp" files.
|
| +
|
| +Before building, make sure that gyp knows to create an XCode project or ninja
|
| +build files. If you leave GYP_GENERATORS undefined it will assume the
|
| +following default:
|
| +
|
| + GYP_GENERATORS="ninja,xcode"
|
| +
|
| +Or you can set it to `ninja` or `xcode` alone, if you like.
|
| +
|
| +You can then generate the Xcode projects and ninja build files by running:
|
| +
|
| + ./gyp_skia
|
| +
|
| +Build and run tests from the command line
|
| +-----------------------------------------
|
| +
|
| + ninja -C out/Debug dm
|
| + out/Debug/dm
|
| +
|
| +The usual mode you want for testing is Debug mode (SK_DEBUG is defined, and
|
| +debug symbols are included in the binary). If you would like to build the
|
| +Release version instead:
|
| +
|
| + ninja -C out/Release dm
|
| + out/Release/dm
|
| +
|
| +Build and run nanobench (performance tests)
|
| +-------------------------------------------
|
| +
|
| +In this case, we will build with the "Release" configuration, since we are running performance tests.
|
| +
|
| + ninja -C out/Release nanobench
|
| + out/Release/nanobench [ --skps path/to/*.skp ]
|
| +
|
| +Build and run SampleApp in the XCode IDE
|
| +----------------------------------------
|
| +
|
| + * Run gyp_skia as described above.
|
| + * In the Finder, navigate to $SKIA_INSTALLDIR/trunk/out/gyp
|
| + * Double-click SampleApp.xcodeproj ; this will launch XCode and open the SampleApp project
|
| + * Click the “Build and Run” button in the top toolbar
|
| + * 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:
|
| + * right- and left-arrow keys: cycle through different test pages
|
| + * 'D' key: cycle through rendering methods for each test page
|
| + * other keys are defined in SampleApp.cpp’s SampleWindow::onHandleKey() and SampleWindow::onHandleChar() methods
|
|
|