发布于 2016-01-15 06:13:39 | 231 次阅读 | 评论: 0 | 来源: PHPERZ
XMake 自动构建工具
XMake 是一个跨平台自动构建工具，支持在各种主流平台上构建项目，类似 cmake、automake、premake，但是更加的方便易用，工程描述语法更简洁直观，支持平台更多，并且集创建、配置、编译、打包、安装、卸载、运行于一体。
xmake将依赖库、依赖头文件、依赖类型、依赖接口统一用 option 选项机制进行了封装，更在上一层引入package包的机制，使得添加和检测依赖更加的模块化，简单化。。。
下面通过一个具体实例，来看下xmake的包机制怎么使用。。
假如你现在的工程已经有了两个包：zlib.pkg，polarssl.pkg（如何构建包，后续会详细说明，现在可以参考TBOX依赖包下已有包的例子），你的工程目录结构如下：
demo
- xmake.lua
- src
main.c
- pkg
zlib.pkg
polarssl.pkg
那么你可以修改xmake.lua来使用上述的两个依赖包：
-- 添加依赖包目录，之后添加需要的包，都会从这个目录里面查找
add_pkgdirs("pkg")
-- 添加目标
add_target("demo")
-- 设置程序类型为二进制可执行程序
set_kind("binary")
-- 添加源代码文件
add_files("src/*.c")
-- 通过option机制添加polarssl、zlib包，如果检测通过，会去自动链接它
-- 第一次执行xmake config或者xmake编译的时候会去自动检测它，然后缓存配置
-- 如果要重新检测，则可以执行 xmake config -c清除原有配置，重新配置所有。。。
add_options("polarssl", "zlib")
-- 设置自动生成的配置头文件，如果mysql检测通过，会生成CONFIG_PACKAGE_HAVE_MYSQL开关
set_config_h("$(buildir)/config.h")
-- 设置config.h宏开关的前缀: CONFIG_xxxx
set_config_h_prefix("CONFIG")
-- 添加头文件搜索目录，这里为了搜索到config.h
add_includedirs("$(buildir)")
接下来是代码里面怎么去使用它：
#include <stdio.h>
// 包含自动生成的config.h头文件
// 搜索路径设置在./build下面
#include "config.h"
// 如果当前平台存在zlib，那么使用它
#ifdef CONFIG_PACKAGE_HAVE_ZLIB
# include "zlib/zlib.h"
#endif
// 如果当前平台存在polarssl，那么使用它
#ifdef CONFIG_PACKAGE_HAVE_POLARSSL
# include "polarssl/polarssl.h"
#endif
int main(int argc, char** argv)
{
printf("hello world!\n");
return 0;
}
上面就是一个包使用的最简单的例子，下面我们来看下具体这个zlib.pkg是怎么生成的：
如果这个包是你自己的项目xxx开发的，那么你只需要执行xmake p进行打包，自动会在./build目录下生成一个xxx.pkg的包，你直接在其他项目中使用就行了。。。
如果是第三方的库，那么你需要自己去构建它，但是也很方便，实在不行你可以参考已有的TBOX依赖包中一些包，做修改就行了。。。
一个pkg包的目录结构：
zlib.pkg
- inc（头文件目录，可选）
- zlib/zlib.h
- lib（链接库目录，可选）
- linux/i386/libz.a
- windows/i386/zlib.lib
- xmake.lua（包描述文件）
其中 inc、lib是可选的，具体逻辑还是在xmake.lua进行描述，xmake默认生成的包逻辑，是会优先去检测zlib.pkg目录有没有当前可用的库和头文件，如果检测不通过，才会去检测系统平台的。。。
当然你也可以自己修改检测逻辑，不一定非得这么来，你只需要根据自己的需求描述xxx.pkg/xmake.lua文件就行了。。。
下面看下我这里提供的zlib.pkg/xmake.lua描述逻辑：
-- 添加一个zlib包自动配置选项
add_option("zlib")
-- 设置是否在xmake f -h配置菜单中显示
-- 如果你想让你的包在工程项目中，可以提示用户手动禁用，那么就启用他吧
set_option_showmenu(true)
-- 在xmake f -h中显示相关描述信息
set_option_description("The mysql package")
-- 如果检测通过，定义宏开关到config.h
add_option_defines_h_if_ok("$(prefix)_PACKAGE_HAVE_ZLIB")
-- 检测链接
add_option_links("z")
-- 添加检测的链接库目录，这里设置优先检测zlib.pkg/lib/下相关平台是否存在链接库，然后再去检测系统的
-- 如果这个不去设置，xmake只能检测一些系统目录下的链接库，例如：/usr/lib, /usr/local/lib
-- 如果常用系统目录下检测不到，但是你又装了这个库，你可以自己设定检测的搜索目录
add_option_linkdirs("lib/$(plat)/$(arch)")
-- 检测 #include "zlib/zlib.h" 是否能编译通过
add_option_cincludes("zlib/zlib.h")
-- 添加一些检测的头文件目录，默认会在zlib.pkg/inc进行搜索，当然你也可以指定其他目录
add_option_includedirs("inc/$(plat)", "inc")
只要描述好xxx.pkg/xmake.lua， 一个包就能被xmake使用，并进行自动检测，其中利用的就是xmake的option机制，当然在包里面不仅仅可以检测依赖库和头文件，你也可以检测是否存在某些需要的接口、类型定义等等。。
而且检测机制完全采用lua语法，支持if条件逻辑，你可以针对一些特定的平台，做一些特别处理，使得你的包更加的通用。
例如下面这个基础包base.pkg的描述：
-- 基础包base.pkg
add_option("base")
-- 如果当前为windows平台，检测ws2_32链接库依赖
if os("windows") then add_option_links("ws2_32")
-- 如果是其他平台，检测-lm，-ldl，-lpthread依赖（由于都是些系统库，这里就没有设置搜索目录）
else add_option_links("m", "dl", "pthread") end
如果你的包只是通过xmake.lua来描述，没有其他文件目录，那么你也可以把你的包xmake.lua的描述内容，直接嵌入到工程描述文件xmake.lua中， 这两者原本都是通用的，说白了 add_pkgdirs("pkg") 的机制，就是调用工程描述api：add_subdirs("pkg/*")进行添加子工程的过程。。而xxx.pkg说白了就是一个子工程描述文件而已。。。
如果你想在你的包检测中增加对接口的检测，那么只需要用:
就行了
所以利用包的机制，可以让你的不同项目最大化重用你的依赖环境。。是个非常有用的功能。。