基于 lua 的跨平台构建工具: xmake v2.0.2 发布!

更新内容

此版本主要修复一些 bug 和稳定性问题

改进

  • 修改安装和卸载的 action 处理
  • 更新工程模板
  • 增强函数检测

Bugs 修复

  • #7: 修复用模板创建工程后, target 名不对问题:'[targetname]’
  • #9: 修复 clang 不支持 c++11 的问题
  • 修复 api 作用域泄露问题
  • 修复在 windows 上的一些路径问题
  • 修复检测宏函数失败问题
  • 修复检测工具链失败问题
  • 修复 windows 上编译 android 版本失败

简介

XMake 是一个基于 Lua 的轻量级跨平台自动构建工具,支持在各种主流平台上构建项目

xmake 的目标是开发者更加关注于项目本身开发,简化项目的描述和构建,并且提供平台无关性,使得一次编写,随处构建

它跟 cmake 、 automake 、 premake 有点类似,但是机制不同,它默认不会去生成 IDE 相关的工程文件,采用直接编译,并且更加的方便易用 采用 lua 的工程描述语法更简洁直观,支持在大部分常用平台上进行构建,以及交叉编译

并且 xmake 提供了创建、配置、编译、打包、安装、卸载、运行等一些 actions ,使得开发和构建更加的方便和流程化。

不仅如此,它还提供了许多更加高级的特性,例如插件扩展、脚本宏记录、批量打包、自动文档生成等等。。

如果你想要了解更多,请参考:

支持特性

  • 支持 windows 、 mac 、 linux 、 ios 、 android 等平台,自动检测不同平台上的编译工具链(也可手动配置) 编译 windows 项目采用原生 vs 的工具链,不需要使用 cygwin 、 mingw (当然这些也支持)
  • 支持自定义平台编译配置,可以很方便的扩展第三方平台支持
  • 采用 lua 脚本语法描述项目,描述规则简单高效,逻辑规则可灵活修改,并且不会生成相关平台的工程文件,是工程更加简单明了
  • 支持创建模板工程、配置项目、编译项目、运行、打包、安装和卸载等常用功能(后续还会增加:自动生成文档、调试等模块)
  • 支持编译 c/c++/objc/swift 成静态库、动态库、命令行可执行程序
  • 提供丰富的工程描述 api ,使用简单灵活,例如添加编译文件只需(还支持过滤排除):add_files("src/*.c", "src/asm/**.S", "src/*.m")
  • 支持头文件、接口、链接库依赖、类型的自动检测,并可自动生成配置头文件 config.h
  • 支持自定义编译配置开关,例如如果在工程描述文件中增加了enable_xxx的开关,那么配置编译的时候就可以手动进行配置来启用它:xmake config --enable_xxx=y
  • 提供一键打包功能,不管在哪个平台上进行打包,都只需要执行一条相同的命令,非常的方便
  • 支持全局配置,一些常用的项目配置,例如工具链、规则描述等等,都可以进行全局配置,这样就不需要每次编译不同工程,都去配置一遍
  • 除了可以自动检测依赖模块,也支持手动强制配置模块,还有各种编译 flags 。
  • 支持插件扩展、平台扩展、模板扩展、选项自定义等高级功能
  • 提供一些内置的常用插件(例如:自动生成 doxygen 文档插件,宏脚本记录和运行插件)
  • 宏记录插件里面提供了一些内置的宏脚本(例如:批量打包一个平台的所有 archs 等),也可以在命令行中手动记录宏并回放执行
  • 提供强大的 task 任务机制
  • 不依赖 makefile 和 make ,实现直接编译,内置自动多任务加速编译, xmake 是一个真正的构架工具,而不仅仅是一个工程文件生成器
  • 自动检测 ccache ,进行自动缓存提升构建速度

####常用 Actions

  • config: 构建之前的编译参数配置
  • global: 配置一些全局参数
  • build: 构建项目
  • clean: 清理一些二进制文件、临时文件
  • create: 使用模板创建新工程
  • package: 打包指定目标
  • install: 安装编译后的目标文件
  • uninstall: 卸载安装的所有文件
  • run: 运行可执行的项目目标

####一些内置插件

  • doxygen 文档生成插件: 从指定源码目录生成 doxygen 文档
  • 宏记录脚本插件: 记录和回放宏脚本,简化重复的命令操作(例如:批量打包。。)
  • hello 插件: 插件开发 demo
  • 工程文件生成插件: 创建 IDE 的工程文件 (目前支持: makefile ,后续支持: vs, xcode 等等)

####支持编译语言

  • C/C++
  • Objc/Objc++
  • Swift
  • Assembly

####支持的构建平台

  • Windows (x86, x64, amd64, x86_amd64)
  • Macosx (i386, x86_64)
  • Linux (i386, x86_64, cross-toolchains …)
  • Android (armv5te, armv6, armv7-a, armv8-a, arm64-v8a)
  • iPhoneos (armv7, armv7s, arm64, i386, x86_64)
  • Watchos (armv7k, i386)
  • Mingw (i386, x86_64)

####后续计划

  • 自动包依赖管理和下载
  • 创建移植仓库,实现一人移植,多人共享
  • 更多的插件开发
  • 自动生成 vs,xcode 等工程文件

####简单例子

创建一个 c++ console 项目:

    xmake create -l c++ -t 1 console
 or xmake create --language=c++ --template=1 console

工程描述文件: xmake.lua

target("console")
    set_kind("binary")
    add_files("src/*.c") 

配置工程:

这个是可选的步骤,如果只想编译当前主机平台的项目,是可以不用配置的,默认编译 release 版本。

   xmake f -p iphoneos -m debug
or xmake f --plat=macosx --arch=x86_64
or xmake f -p windows
or xmake config --plat=iphoneos --mode=debug
or xmake config --plat=android --arch=armv7-a --ndk=xxxxx
or xmake config -p linux -a i386
or xmake config -p mingw --cross=i386-mingw32- --toolchains=/xxx/bin
or xmake config -p mingw --sdk=/mingwsdk
or xmake config --help

编译工程:

   xmake
or xmake -r
or xmake --rebuild

运行目标:

   xmake r console
or xmake run console

打包所有:

   xmake p
or xmake package
or xmake package console
or xmake package -o /tmp
or xmake package --output=/tmp

通过宏脚本打包所有架构:

   xmake m package 
or xmake m package -p iphoneos
or xmake m package -p macosx -f "-m debug" -o /tmp/
or xmake m package --help

安装目标:

   xmake i
or xmake install
or xmake install console
or xmake install -o /tmp
or xmake install --output=/tmp

详细使用方式和参数说明,请参考文档 或者运行:

   xmake -h
or xmake --help
or xmake config --help
or xmake package --help
or xmake macro --help
...

一些使用 xmake 的项目:

####简单例子

-- the debug mode
if is_mode("debug") then
    
    -- enable the debug symbols
    set_symbols("debug")

    -- disable optimization
    set_optimize("none")
end

-- the release mode
if is_mode("release") then

    -- set the symbols visibility: hidden
    set_symbols("hidden")

    -- enable fastest optimization
    set_optimize("fastest")

    -- strip all symbols
    set_strip("all")
end

-- add target
target("test")

    -- set kind
    set_kind("static")

    -- add files
    add_files("src/*.c")
投稿作者 作者网站

评论

 
 

发表评论

 
你的昵称*
电子邮件*
网址(选填)
我的评论*
  • 发表评论
  • 为您推荐


    请支持IMCN发展!

    谁在捐赠

    微信捐赠 支付宝捐赠
    微信捐赠 支付宝捐赠




    微信公众号二维码

    归档