diff options
| author |  Mike Klein <mtklein@chromium.org> | 2016-11-01 11:46:10 -0400 |
|---|---|---|
| committer |  Skia Commit-Bot <skia-commit-bot@chromium.org> | 2016-11-01 16:17:38 +0000 |
| commit | 10d665d000cfdce693b7ca088fb2c61ed54bcdfb (patch) | |
| tree | f8f6776f60c5636881bb52daeaf3b2b095ffd38f /site/user/quick | |
| parent | 5e25717ab6313b011ec54eac0109c414aa8ffc17 (diff) | |
Allow most third_party targets to use system libraries if asked.
This extends the pattern in freetype2 to expat, icu, libjpeg-turbo, libpng, libwebp, and zlib, and gives all these an arg to control which to use.
Homebrew doesn't have dng_sdk, piex, or sftnly, or I'd have done the same for them too.
BUG=skia:
GOLD_TRYBOT_URL= https://gold.skia.org/search?issue=4260
DOCS_PREVIEW= https://skia.org/?cl=4260
Change-Id: I82e780502bf2217336e791787f172a6fc8f55460
Reviewed-on: https://skia-review.googlesource.com/4260
Commit-Queue: Mike Klein <mtklein@chromium.org>
Reviewed-by: Hal Canary <halcanary@google.com>
Diffstat (limited to 'site/user/quick')
| -rw-r--r-- | site/user/quick/gn.md | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/site/user/quick/gn.md b/site/user/quick/gn.md index c35b519b7b..b9483323c1 100644 --- a/site/user/quick/gn.md +++ b/site/user/quick/gn.md @@ -123,3 +123,23 @@ project descriptions. This is not meant for any purpose beyond development. <!--?prettify lang=sh?--> gn gen out/config --ide=json --json-ide-script=../../gn/gn_to_cmake.py + +Third-party Dependencies +------------------------ + +Skia offers several features that make use of third-party libraries, like +libpng, libwebp, or libjpeg-turbo to decode images, or ICU and sftnly to subset +fonts. All these third-party dependencies are optional, and can be controlled +by a GN argument that looks something like `skia_use_foo` for appropriate +`foo`. + +Most of these third-party dependencies can also be satisfied by pre-built +system libraries. If `skia_use_foo` is enabled, turn on `skia_use_system_foo` +to build and link Skia against the headers and libaries found on the normal +system paths. Remember, you can use `extra_cflags` and `extra_ldflags` to add +include or library paths if needed. + +By default Skia will attempt to build and embed its own copies of these +third-party libraries. This configuration is for development and testing only. +We do not recommend shipping Skia this way. Note however, this is the only +configuration of Skia that receives significant testing. |