高级特性之自定义task任务

2016-06-09 ruki 更多博文 » 博客 » GitHub »

xmake task 自定义脚本 插件

原文链接 https://waruqi.github.io/2016/06/09/custom-task.cn/
注:以下为加速网络访问所做的原文缓存,经过重新格式化,可能存在格式方面的问题,或偶有遗漏信息,请以原文为准。


task是xmake 2.0开始新增的特性,也是插件开发的核心,在 插件开发之hello xmake 中我们简单介绍了下task的定义和使用

当然task不仅可以用来写插件,而且还可以写一些简单的自定义任务。。

我们先看下一个简单task实现:

    -- 定义一个名叫hello的task任务
    task("hello")

        -- task运行的入口
        on_run(function ()

            -- 显示hello xmake!
            print("hello xmake!")

        end)

这是一个最简单的task,相比插件task,它少了对 set_menu 的设置,当然你也可以加上,好、这样就个可以在命令行中调用它。。

而这个hello task没有设置set_menu,那么只能在自定义脚本里面调用了。。

    target("demo")

        -- 自定义clean action
        on_clean(function(target)

            -- 导入task模块
            import("core.project.task")

            -- 运行这个hello task
            task.run("hello")
        end)

如果想要增加参数传递,有两种方式:

  1. 通过set_menu添加一个命令行的选项菜单,通过option模块来访问参数(支持命令行、脚本传参)
  2. 直接通过脚本传参

我们先看下第二种比较简单,不需要定义命令行菜单,只需要task定义和调用处双方约定好参数规则就行:

    -- 直接传参,{} 这个是给第一种选项传参使用,这里置空
    -- 这里在最后面传入了两个参数:arg1, arg2
    task.run("hello", {}, "arg1", "arg2")

那如何获取这两个参数呢?

    -- 定义一个名叫hello的task任务
    task("hello")

        -- task运行的入口,定义为两个参数
        on_run(function (arg1, arg2)

            -- 显示hello xmake!
            print("hello xmake: %s %s!", arg1, arg2)

        end)

怎么样简单吧,当然这种传参方式没法通过命令行进行外部传参,所以一般用于一些内置的task间调用,像插件这种高级task,就需要第一种传参方式了

这个详情请参考:插件开发之参数配置