首页   注册   登录
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
宝塔
V2EX  ›  程序员

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

  •  
  •   waruqi · 2016-08-30 09:56:43 +08:00 · 1634 次点击
    这是一个创建于 1179 天前的主题,其中的信息可能已经有所发展或是发生改变。

    更新内容

    新特性

    • xmake.lua中添加原生 shell 支持,例如:add_ldflags("$(shell pkg-config --libs sqlite3)")
    • 编译 windows 目标程序,默认默认启用 pdb 符号文件
    • 在 windows 上添加调试器支持( vsjitdebugger, ollydbg, windbg ... )
    • 添加getenv接口到xmake.lua的全局作用域中
    • 添加生成 vstudio 工程插件(支持: vs2002 - vs2015)
    • 为 option 添加set_default接口

    改进

    • 增强内建变量的处理
    • 支持字符串类型的选项 option 设置

    Bugs 修复

    • 修复在 linux 下检测 ld 连接器失败,如果没装 g++的话
    • 修复*.cxx编译失败问题

    简介

    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 ,进行自动缓存提升构建速度

    • 自动检测头文件依赖,并且快速自动构建修改的文件

    • 调试器支持,实现直接加载运行调试

    • 提供产生 IDE 工程文件的插件(支持 vs2002 - vs2015 )

    常用 Actions

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

    一些内置插件

    • doxygen 文档生成插件: 从指定源码目录生成 doxygen 文档
    • 宏记录脚本插件: 记录和回放宏脚本,简化重复的命令操作(例如:批量打包。。)
    • hello 插件: 插件开发 demo
    • 工程文件生成插件: 创建 IDE 的工程文件 (目前支持: makefile, vs2002 - vs2008 ,后续支持: vs2010 以上版本, 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)

    后续任务

    • 自动包依赖管理和下载
    • 创建移植仓库,实现一人移植,多人共享
    • 更多的插件开发(例如:生成.deb, .rpm 的安装包)

    简单例子

    创建一个 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 r -d console
    or xmake run -d 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") 
    

    联系方式

    6 回复  |  直到 2016-08-31 16:39:51 +08:00
        1
    yuankui   2016-08-30 13:00:33 +08:00
    基于 lua 有啥优势吗。。
        2
    goreliu   2016-08-30 13:06:15 +08:00 via Android
    一个版本就开个新帖子不大好不,另外我想请教下 x64, amd64, x86_amd64 这三个有啥区别。
        3
    waruqi   2016-08-30 13:22:26 +08:00
    @yuankui 轻量,不需要安装依赖的解释器(例如 python ), xmake 内置 lua 解释器,装完直接能用。。
        4
    waruqi   2016-08-30 13:25:22 +08:00
    @goreliu 主要是 msvc 的平台工具链,区分了这么多 arch ,所以针对 windows 编译, xmake 也提供了这些 arch 支持, 不过一般只需要 x86, x64 就行了
        5
    fuxpro   2016-08-31 11:07:10 +08:00
    被你坚持的精神给打动了, 你能够分享一下是什么让你一直坚持做这个项目, 也包括那个 TBOX 的项目.
    我很难想象.
    像我经常加班, 工作已经让我很疲惫了,何况生活中还有很多其它的事情,家庭,家人, 总之好多的无奈. 我真心希望你能够分享项目背后的故事与生活.

    谢谢
        6
    waruqi   2016-08-31 16:39:51 +08:00
    @fuxpro 纯属个人业余兴趣哈,正好自己平常用的到,所以主要还是给我自己写的,顺便开源下。。

    时间嘛,是挤出来的,我家里事也一堆哈。。地铁上下班(有位子的时候敲敲代码),吃中饭的时候都可以啊。。

    不过最近时间也不是很多了。。:)
    关于   ·   FAQ   ·   API   ·   我们的愿景   ·   广告投放   ·   感谢   ·   实用小工具   ·   2497 人在线   最高记录 5043   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.3 · 22ms · UTC 11:37 · PVG 19:37 · LAX 03:37 · JFK 06:37
    ♥ Do have faith in what you're doing.