• 静态库的使用
    • 创建静态库
    • 使用静态库

    静态库的使用

    和任何大型项目一样，Cocos2d-x 引擎是由数千个源文件组成。通过这些源文件，你可以了解到引擎内部工作的原理，你可以根据需要修改这些文件。但是这种自由是有代价的！不是金钱，而是更有价值的东西，时间！编译时间！

    每当项目的源文件发生更改时，编译器都会重新编译所有文件，包含引擎的源码，这样编译一个项目，都将花费相当长的时间，每天都可能会编译多次，加起来总编译时间非常可怕！幸运的是有一个简单的解决方案，使用静态库。将引擎源码编译为静态库，在这个过程中引擎的所有源码会被编译成一个单独的静态库文件，然后你可以将这个库链接到项目中。这样在编译项目的时候，引擎源码不会被编译，编译时间就会大大缩短。

    创建静态库

    静态库可以在 iOS, macOS, Android 和 Win32 这些平台上使用。

    在项目中使用静态库之前，你需要先将静态库创建出来。假设你已经配置好 cocos 命令行工具 了，请这样操作：

    1. # remove the 'prebuilt' folder
    2. # without the -m flag, this builds for release mode
    3. # generates libraries for every platform (ios, mac, android, win32)
    4. cocos gen-libs -c
    6. # remove the 'prebuilt' folder
    7. # without the -m flag, this builds for release mode
    8. # generates libraries for just ios
    9. cocos gen-libs -c -p ios
    11. # remove the 'prebuilt' folder
    12. # without the -m flag, this builds for release mode
    13. # generates libraries for just ios and android
    14. cocos gen-libs -c -p ios -p android
    16. # remove the 'prebuilt' folder
    17. # with the -m flag, this builds for debug
    18. # generates libraries for just ios and android
    19. cocos gen-libs -c -p ios -m debug

    构建静态库的过程由于不同的硬件和软件配置，可能需要几分钟到几个小时。构建完成后，静态库会放在引擎根目录下 prebuilt 子目录。在 Cocos2d-x 的项目中，你可以配置静态库链接到这个位置，这样这个目录内的静态库就可以在多个项目中使用。你也可以将静态库文件复制到单个项目中，或其它你觉得合适的位置。

    运行 cocos gen-libs —help 来查看更多关于构建静态库的帮助信息。

    使用静态库

    在项目中使用构建的静态库是很简单的，只需要将库简单的添加到项目中，并设置头文件和包含文件的搜索路径。具体的绝对路径取决于你的环境，你需要添加的一系列路径是：

    头文件搜索路径:

    1. # Project level
    2. /path_to_cocos2d-x/cocos2d-x/
    3. /path_to_cocos2d-x/cocos2d-x/cocos
    4. /path_to_cocos2d-x/cocos2d-x/cocos/base /path_to_cocos2d-x/cocos2d-x/cocos/physics /path_to_cocos2d-x/cocos2d-x/cocos/math
    5. /path_to_cocos2d-x/cocos2d-x/cocos/2d
    6. /path_to_cocos2d-x/cocos2d-x/cocos/ui /path_to_cocos2d-x/cocos2d-x/cocos/network /path_to_cocos2d-x/cocos2d-x/cocos/audio/include /path_to_cocos2d-x/cocos2d-x/cocos/editor-support /path_to_cocos2d-x/cocos2d-x/extensions
    7. /path_to_cocos2d-x/cocos2d-x/external /path_to_cocos2d-x/cocos2d-x/external/chipmunk/include/chipmunk
    9. # Target level
    10. /path_to_cocos2d-x/cocos2d-x/cocos/platform/ios /path_to_cocos2d-x/cocos2d-x/cocos/platform/ios/Simulation

    包含文件搜索路径:

    1. /path_to_cocos2d-x/cocos2d-x/prebuilt/ios
    /path_to_cocos2d-x 指引擎根目录的路径

    原文: http://docs.cocos.com/cocos2d-x/manual/zh/editors_and_tools/prebuilt_libraries.html