make工程描述编写之选择性编译
xmake 提供了一些内置的条件判断api,用于在选择性编译时,获取到一些工程状态的相关信息,来调整编译逻辑。。
例如:is_os, is_plat, is_arch, is_kind, is_mode, is_option
is_mode
我们先拿最常用的is_mode来讲讲如何使用,这个api主要用来判断当前的编译模式,例如平常编译配置的时候,会执行:
$ xmake f -m debug
$ xmake
来编译debug版本,那么模式就是debug,那么release版本,也就是release了
$ xmake f -m release
$ xmake
但是如果仅仅只是这么配置,xmake还是不知道如果为debug进行编译,如何编译release版本,因为这些模式的值不是内置的
我们可以随便设置,例如:profile, checking等等,用来编译性能模式,检测模式,这些就看咱们项目实际的需求了。。
一般情况下只需要debug和release就行了,那如何区分呢,这就需要在xmake.lua进行配置了,一般可参考如下配置:
-- 如果当前编译模式是debug
if is_mode("debug") then
-- 添加DEBUG编译宏add_defines("DEBUG")-- 启用调试符号set_symbols("debug")-- 禁用优化set_optimize("none")
-- 如果是release模式
elseif is_mode("release") then
-- 隐藏符号set_symbols("hidden")-- strip所有符号set_strip("all")-- 开启优化为:最快速度模式set_optimize("fastest")-- 忽略帧指针add_cxflags("-fomit-frame-pointer")add_mxflags("-fomit-frame-pointer")
end
通过判断是否在编译debug版本,来启用和禁用调试符号信息,并且判断是否禁用和启用优化。
当然,如果我们的项目还设置了其他模式,例如性能分析模式:profile,那么还可以通过这个来判断是否需要添加一些分析分析上的编译选项。
is_plat
接下来我们讲讲这个编译平台的判断,这个也非常实用哦,虽然我们的工具是为了跨平台开发,通常的配置肯定都是通用的
但是毕竟项目成千上万,需求各不相同,总归会有些项目需要针对不同的平台做些编译上的特殊处理
这个时候,我们就需要这个api了,例如:
-- 如果当前平台是android
if is_plat("android") then
add_files("src/xxx/*.c")
end
--如果当前平台是macosx或者iphoneos
if is_plat("macosx", "iphoneos") then
add_mxflags("-framework Foundation")
add_ldflags("-framework Foundation")
end
这里针对android平台,增加了一些特殊代码的编译,针对macosx和iphoneos平台,增加了Foundation框架的链接。
这里还有个比较实用的小技巧,is_xxx系列接口,都是可以同时传递多个参数的,逻辑上是or的关系
我们可以像上面那么写法:
if is_plat("macosx", "iphoneos", "android", "linux") then
end
否则如果用lua的原生语法的话,虽然也可以,但是会很臃肿,例如:
if is_plat("macosx") or is_plat("iphoneos") or is_plat("android") or is_plat("linux") then
end
除了is_xxx系列,像:add_xxxs 这种后缀有s的复数api,都是可以传递多个参数的哦,例如add_files:
add_files("src/*.c", "test.c", "hello.cpp")
等等,这里就不一一介绍了。。。
is_arch
这个跟is_plat类似,不过是用来判断当前编译的目标架构的,也就是:
xmake f --arch=x86_64
然后,我们在工程描述中,进行判断:
-- 如果当前架构是x86_64或者i386
if is_arch("x86_64", "i386") then
add_files("src/xxx/*.c")
end
--如果当前平台是armv7, arm64, armv7s, armv7-a
if is_arch("armv7", "arm64", "armv7s", "armv7-a") then
-- ...
end
如果像上面那样一个个去判断所有arm架构,也许会很繁琐,毕竟每个平台的架构类型很多,xmake提供了类似add_files中的通配符匹配模式,来更加简洁的进行判断:
--如果当前平台是arm平台
if is_arch("arm") then
-- ...
end
用就可以匹配所有了。。
is_os
这个很简单,用来判断当前编译目标,例如:
-- 如果当前操作系统是ios
if is_os("ios") then
add_files("src/xxx/*.m")
end
目前支持的操作系统有:windows、linux、android、macosx、ios
is_kind
用来判断当前是否编译的是动态库还是静态库
一般用于如下场景:
target("test")
-- 通过配置设置目标的kind
set_kind("$(kind)")
add_files("src/*c")
-- 如果当前编译的是静态库,那么添加指定文件if is_kind("static") then add_files("src/xxx.c")end
编译配置的时候,可手动切换,编译类型:
-- 编译静态库
xmake f -k static
xmake
-- 编译动态库
xmake f -k shared
xmake
is_option
如果某个自动检测选项、手动设置选项被启用,那么可以通过is_option接口来判断,例如:
-- 如果手动启用了xmake f --demo=y 选项
if is_option("demo") then
-- 编译demo目录下的代码add_subdirs("src/demo")
end
XMake项目主页
XMake项目详情
XMake项目源码
XMake项目文档
TBOOX项目主页
关键字:lua, 编译, 构建工具, makefile
版权声明
本文来自互联网用户投稿,文章观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处。如若内容有涉嫌抄袭侵权/违法违规/事实不符,请点击 举报 进行投诉反馈!