Skia构建系统与编译脚本分析

分析下Skia的构建系统，详细编译过程參看Windows下从源代码编译Skia。这里以ninja为例来分析。运行以下三条命令就能够完毕编译：

SET "GYP_GENERATORS=ninja"
python bin/sync-and-gyp 
ninja -C outRelease

“python bin/sync-and-gyp”会生成ninja脚本。以下来分析脚本层级以及某个模块的脚本内容和结构。

关于ninja，參考https://ninja-build.org/manual.html或http://guiquanz.me/2014/07/28/a_intro_to_Ninja/。

ninja脚本层级及模块脚本说明

skiagyp以下的gyp脚本是模板。运行sync-and-gyp时会依据这些模板来动态生成实际的构建脚本。非常多模块依赖、条件等都能够在这个文件夹下的gyp或gypi中找到。

sync-and-gyp之后。outReleaseuild.ninja。是总的编译脚本。里面定义了all，还定义了默认编译目标为most。

most相应的ninja脚本是outReleaseobjgypmost.ninja。

假设想编译某个单独的模块，能够运行“ninja module_name”，比方“ninja images”，“ninja giflib”等。

详细到某个模块的编译脚本，都在outReleaseobjgyp文件夹下。某个模块的ninja脚本中，定义了详细的编译规则。以images.ninja（相应skia_images.lib）为例来说明下，它的内容例如以下：

arch = environment.x86
cc = $cl_x86
cxx = $cl_x86
cc_host = $cl_x86
cxx_host = $cl_x86
asm = $ml_x86
build objgypimages.actions_depends.stamp: stamp objgyplibjpeg-turbo.lib $
    objgyplibwebp.actions_depends.stamp

pdbname_c = images.pdb
pdbname_cc = images.pdb
pchprefix = images
defines = -DSK_INTERNAL -DSK_GAMMA_SRGB -DSK_GAMMA_APPLY_TO_A8 $
    -DSK_ALLOW_STATIC_GLOBAL_INITIALIZERS=1 -DSK_SUPPORT_GPU=0 $
    -DSK_FORCE_DISTANCE_FIELD_TEXT=0 -DSK_BUILD_FOR_WIN32 $
    -D_CRT_SECURE_NO_WARNINGS -DGR_GL_FUNCTION_TYPE=__stdcall $
    -D_HAS_EXCEPTIONS=0 -DNDEBUG -DNDEBUG
asmflags = 
rcflags = /I....gyp
includes = -I....includeimages -I....includeprivate -I....srclazy $
    -I....srccore -I....srcimage -I....includec $
    -I....includeconfig -I....includecore -I....includepathops $
    -I....gypconfigwin -I....	hird_partyexternalslibjpeg-turbo $
    -I....	hird_partyexternalslibpng -I....	hird_partylibpng $
    -I....	hird_partyexternalsgiflib -I....	hird_partygiflib $
    -I....	hird_partyetc1 -I....	hird_partyktx $
    -I....	hird_partyexternalslibwebpsrc -I....includeutils $
    -I....srcutils -I....includeutilswin
midl_includes = 
cflags = /wd4275 /wd4345 /wd4355 /Ox /Ot /fp:precise /W3 /WX /Zi /GR- /MD $
    /we4189 /arch:SSE2 /FS
cflags_c = -DSK_A32_SHIFT=24 -DSK_B32_SHIFT=16 -DSK_G32_SHIFT=8 $
    -DSK_R32_SHIFT=0 -DSK_A32_SHIFT=24 -DSK_B32_SHIFT=16 -DSK_G32_SHIFT=8 $
    -DSK_R32_SHIFT=0
cflags_cc = -DSK_A32_SHIFT=24 -DSK_B32_SHIFT=16 -DSK_G32_SHIFT=8 $
    -DSK_R32_SHIFT=0 -DSK_A32_SHIFT=24 -DSK_B32_SHIFT=16 -DSK_G32_SHIFT=8 $
    -DSK_R32_SHIFT=0 /TP
arflags = 

build objsrcimagesimages.bmpdecoderhelper.obj: cxx $
    ....srcimagesmpdecoderhelper.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkDecodingImageGenerator.obj: cxx $
    ....srcimagesSkDecodingImageGenerator.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkForceLinking.obj: cxx $
    ....srcimagesSkForceLinking.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkImageDecoder.obj: cxx $
    ....srcimagesSkImageDecoder.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkImageDecoder_FactoryRegistrar.obj: cxx $
    ....srcimagesSkImageDecoder_FactoryRegistrar.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkImageDecoder_wbmp.obj: cxx $
    ....srcimagesSkImageDecoder_wbmp.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkImageDecoder_pkm.obj: cxx $
    ....srcimagesSkImageDecoder_pkm.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkImageDecoder_ktx.obj: cxx $
    ....srcimagesSkImageDecoder_ktx.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkImageDecoder_astc.obj: cxx $
    ....srcimagesSkImageDecoder_astc.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkImageDecoder_libbmp.obj: cxx $
    ....srcimagesSkImageDecoder_libbmp.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkImageDecoder_libico.obj: cxx $
    ....srcimagesSkImageDecoder_libico.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkImageDecoder_libwebp.obj: cxx $
    ....srcimagesSkImageDecoder_libwebp.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkImageDecoder_libjpeg.obj: cxx $
    ....srcimagesSkImageDecoder_libjpeg.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkImageDecoder_libpng.obj: cxx $
    ....srcimagesSkImageDecoder_libpng.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkImageDecoder_libgif.obj: cxx $
    ....srcimagesSkImageDecoder_libgif.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkImageEncoder.obj: cxx $
    ....srcimagesSkImageEncoder.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkImageEncoder_Factory.obj: cxx $
    ....srcimagesSkImageEncoder_Factory.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkImageEncoder_argb.obj: cxx $
    ....srcimagesSkImageEncoder_argb.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkJpegUtility.obj: cxx $
    ....srcimagesSkJpegUtility.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkMovie.obj: cxx ....srcimagesSkMovie.cpp $
    || objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkPageFlipper.obj: cxx $
    ....srcimagesSkPageFlipper.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcimagesimages.SkScaledBitmapSampler.obj: cxx $
    ....srcimagesSkScaledBitmapSampler.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcportsimages.SkImageGenerator_skia.obj: cxx $
    ....srcportsSkImageGenerator_skia.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp
build objsrcportsimages.SkImageDecoder_WIC.obj: cxx $
    ....srcportsSkImageDecoder_WIC.cpp || $
    objgyplibjpeg-turbo.actions_rules_copies.stamp

build skia_images.lib: alink objsrcimagesimages.bmpdecoderhelper.obj $
    objsrcimagesimages.SkDecodingImageGenerator.obj $
    objsrcimagesimages.SkForceLinking.obj $
    objsrcimagesimages.SkImageDecoder.obj $
    objsrcimagesimages.SkImageDecoder_FactoryRegistrar.obj $
    objsrcimagesimages.SkImageDecoder_wbmp.obj $
    objsrcimagesimages.SkImageDecoder_pkm.obj $
    objsrcimagesimages.SkImageDecoder_ktx.obj $
    objsrcimagesimages.SkImageDecoder_astc.obj $
    objsrcimagesimages.SkImageDecoder_libbmp.obj $
    objsrcimagesimages.SkImageDecoder_libico.obj $
    objsrcimagesimages.SkImageDecoder_libgif.obj $
    objsrcimagesimages.SkImageDecoder_libwebp.obj $
    objsrcimagesimages.SkImageDecoder_libjpeg.obj $
    objsrcimagesimages.SkImageDecoder_libpng.obj $
    objsrcimagesimages.SkImageEncoder.obj $
    objsrcimagesimages.SkImageEncoder_Factory.obj $
    objsrcimagesimages.SkImageEncoder_argb.obj $
    objsrcimagesimages.SkJpegUtility.obj $
    objsrcimagesimages.SkMovie.obj $
    objsrcimagesimages.SkPageFlipper.obj $
    objsrcimagesimages.SkScaledBitmapSampler.obj $
    objsrcportsimages.SkImageGenerator_skia.obj $
    objsrcportsimages.SkImageDecoder_WIC.obj || $
    objgypimages.actions_depends.stamp
  libflags = 

能够看到，ninja脚本分例如以下几部分：

• 编译平台和工具链
• 编译选项（defines、cflags、includes等）
• 编译规则（build obj開始的语句）
• 生成库的规则（build skia_images.lib那行）

假设我们要改动某个子模块，依据上面分析，就能够改动相应的ninja脚本，defines能够添加一些宏定义，includes能够设置包括路径。cflags、cflags_c、cflags_cc能够设置编译选项。

要添加一个文件，按以下做就可以：

1. 能够新增一条build obj语句，设置某个cpp文件的编译规则
2. build skia_images.lib语句中添加第1步里生成的obj文件

有了这些基础，就能够单独改动某个模块了。

要单独编译某个模块，能够參考以下的命令：

ninja images
ninja codec

要清理某个模块，能够參考以下的命令：

ninja -t clean images

模块间的依赖

skiagyp以下的gyp脚本是模板，运行sync-and-gyp时会依据这些模板来动态生成实际的构建脚本。这里的一些gyp脚本定义了模块间的依赖关系。比方images.gyp，有这些依赖：

  'dependencies': [
    'core.gyp:*',
    'giflib.gyp:giflib',
    'libjpeg-turbo-selector.gyp:libjpeg-turbo-selector',
    'etc1.gyp:libetc1',
    'ktx.gyp:libSkKTX',
    'libwebp.gyp:libwebp',
    'utils.gyp:utils',
  ]

然后后面又分平台又一次设置了依赖条件和源文件。我发如今Windows下，运行“python bin/sync-and-gyp”生成的skiaoutReleaseobjgypimages.ninja中，就没有SkImageDecoder_libpng.cpp哦。

编译选项

在运行“python bin/sync-and-gyp”之前。能够设置一些环境变量来控制Skia的编译。最常见的使用方法有两种：

1. 控制某个模块的编译开关
2. 改动编译选项

模块编译开关

https://skia.org/user/tips，这里说能够通过GYP_DEFINES来控制某个功能，举的样例例如以下：

GYP_DEFINES='skia_gpu=0 skia_pdf=0' python bin/sync-and-gyp
ninja -C out/Debug

在Windows下，这样设置GYP_DEFINES：

set "GYP_DEFINES=skia_gpu=0 skia_pdf=0"

注意，假设你真的设置了skia_gpu=0，默认编译过程会出错。这是由于bench工具要求定义skia_gpu。只是假设你不须要这个工具倒没关系，出错时各种lib已经正常生成了。

skiagypcommon_variables.gypi这个文件中有提到了能够使用的开关（应该有个文档说明吧，我没找到，Skia的资料还是太少），比方skia_gpu、skia_pdf、skia_egl、skia_angle等。以下的语句可供參考：

set "GYP_DEFINES=skia_gpu=0 skia_pdf=0 skia_egl=0 skia_angle=0"

改动编译选项

编译选项有两种改法：

1. 改动ninja中的conditions（skiagypcommon_conditions.gypi）
2. 通过环境变量传递

一个一个说吧。

• 1) conditions

打开skiagypcommon_conditions.gypi看看就知道有哪些条件了。比方Windows的Release版本号，编译器选项设置例如以下：

        'msvs_settings': {
          'VCCLCompilerTool': {
            'DebugInformationFormat': '3',      # programDatabase (/Zi)
            'Optimization': '<(skia_release_optimization_level)',
           # Changing the floating point model requires rebaseling gm images
           #'FloatingPointModel': '2',          # fast (/fp:fast)
            'FavorSizeOrSpeed': '1',            # speed (/Ot)
            'PreprocessorDefinitions': ['NDEBUG'],
            'RuntimeLibrary': '2',              # rtMultiThreadedDLL (/MD)
            'EnableEnhancedInstructionSet': '2',# /arch:SSE2
            'RuntimeTypeInfo': 'false',         # /GR-
          },
          'VCLinkerTool': {
            'GenerateDebugInformation': 'true', # /DEBUG
          },
        }

能够看到，设置了RuntimeLibrary为 /MD（多线程动态库）。假设要改动，直接改这个文件，整个编译时就都变了（我没试哈，仅仅是分析）。其他的选项相似。

• 2) 通过环境变量传递

https://skia.org/user/tips，这里说能够通过在命令行环境设置CC、CXX、CFLAGS、CPPFLAGS、CXXFLAGS来传递一些编译选项。

“python bin/sync-and-gyp”语句运行过程中会分析环境变量。整合到输出的构建脚本中。

https://skia.org/user/tips。这里给的示比例如以下：

CXXFLAGS='-Wunused-parameter' 
    CC='clang' CXX='clang++' python bin/sync-and-gyp
ninja -C out/Debug

在Windows下，应该这样设置：

set "CFLAGS=-DYOURMACRO=1 -DXXX=16"
set "CXXFLAGS=-DYOURMACRO=1 -DXXX=16"

我前面给出的images.ninja演示样例，我设置了CFLAGS、CXXFLAGS、CPPFLAGS。所以你会看到该ninja脚本中cflags_c、cflags_cc都添加了“-DSK_A32_SHIFT=24”之类的选项。

---

就这样吧。

其他參考文章详见我的专栏：【CEF与PPAPI开发】。