本质上都是任务，只是分类不同而已。

定义插件或者任务

task域用于描述一个自定义的任务实现，与和option同级。

例如，这里定义一个最简单的任务：

这个任务只需要打印hello xmake!，那如何来运行呢？

由于这里没有使用设置菜单，因此这个任务只能再xmake.lua的自定义脚本或者其他任务内部调用，例如：

target("test")
    after_build(function (target)
        -- 导入task模块
        import("core.project.task")
        -- 运行hello任务
        task.run("hello")
    end)

在构建完test目标后运行hello任务。

结束定义插件或任务

这是一个可选api，显示离开选项作用域，用法和类似。

设置任务菜单

通过设置一个菜单，这个任务就可以开放给用户自己通过命令行手动调用，菜单的设置如下：

task("echo")
    -- 设置运行脚本
    on_run(function ()
        -- 导入参数选项模块
        import("core.base.option")
        -- 初始化颜色模式
        local modes = ""
        for _, mode in ipairs({"bright", "dim", "blink", "reverse"}) do
            if option.get(mode) then
                modes = modes .. " " .. mode 
            end
        end
        -- 获取参数内容并且显示信息
        cprint("${%s%s}%s", option.get("color"), modes, table.concat(option.get("contents") or {}, " "))
    end)
    -- 设置插件的命令行选项，这里没有任何参数选项，仅仅显示插件描述
    set_menu {
                -- 设置菜单用法
                -- 设置菜单描述
            ,   description = "Echo the given info!"
                -- 设置菜单选项，如果没有选项，可以设置为{}
            ,   options = 
                {
                    -- 设置k模式作为key-only型bool参数
                    {'b', "bright",     "k",  nil,       "Enable bright."               }      
                ,   {'d', "dim",        "k",  nil,       "Enable dim."                  }      
                ,   {'r', "reverse",    "k",  nil,       "Reverse color."               }      
                    -- 菜单显示时，空白一行
                ,   {}
                    -- 设置kv作为key-value型参数，并且设置默认值：black
                ,   {'c', "color",      "kv", "black",   "Set the output color."
                                                     ,   "    - red"   
                                                     ,   "    - blue"
                                                     ,   "    - yellow"
                                                     ,   "    - green"
                                                     ,   "    - magenta"
                                                     ,   "    - cyan" 
                                                     ,   "    - white"                  }
                    -- 设置`vs`作为values多值型参数，还有`v`单值类型
                    -- 一般放置在最后，用于获取可变参数列表
                ,   {}
                ,   {nil, "contents",   "vs", nil,       "The info contents."           }
                }
            }

定义完这个任务后，执行xmake --help，就会多出一个任务项来：

Tasks:
    ...
    echo                    Echo the given info!

如果通过设置分类为plugin，那么这个任务就是一个插件了：

Plugins:
    ...
    echo                    Echo the given info!

想要手动运行这个任务，可以执行：

其中菜单最开头的部分选项，是xmake内置的常用选项，基本上每个任务都会用到，不需要自己额外定义，简化菜单定义。

下面，我们来实际运行下这个任务，例如我要显示红色的hello xmake!，只需要：

$ xmake echo -c red hello xmake!

也可以使用选项全名，并且加上高亮：

$ xmake echo --color=red --bright hello xmake!

最后面的可变参数列表，在run脚本中通过option.get("contents")获取，返回的是一个table类型的数组。

设置任务类别

仅仅用于菜单的分组显示，当然插件默认会用plugin，内置任务默认会用：action，但也仅仅只是个约定。

你可以使用任何自己定义的名字，相同名字会分组归类到一起显示，如果设置为plugin，就会显示到xmake的Plugins分组中去。

例如：

Plugins: 
    l, lua               Run the lua script.
    m, macro             Run the given macro.
       doxygen           Generate the doxygen document.
       project           Generate the project file.
       hello             Hello xmake!
       echo              Echo the given info!

如果没有调用这个接口设置分类，默认使用Tasks分组显示，代表普通任务。

设置任务运行脚本

可以有两种设置方式，最简单的就是设置内嵌函数：

task("hello")
    on_run(function ()
        print("hello xmake!")
    end)

这种对于小任务很方便，也很简洁，但是对于大型任务就不太适用了，例如插件等，需要复杂的脚本支持。

这个时候就需要独立的模块文件来设置运行脚本，例如：

task("hello")
    on_run("main")

目录结构如下：

main.lua里面内容如下：

function main(...)
    print("hello xmake!")
end

就是一个简单的带main主函数的脚本文件，你可以通过import导入各种扩展模块，实现复杂功能，例如：

-- 导入参数选项模块
import("core.base.option")
-- 入口函数
function main(...)
    -- 获取参数内容
    print("color: %s", option.get("color"))
end

你也可以在当前目录下，创建多个自定义的模块文件，通过导入后使用，例如：

projectdir
    - xmake.lua
    - main.lua
    - module.lua

module.lua的内容如下：

-- 定义一个导出接口
function hello()
    print("hello xmake!")
end

私有接口，通过_hello带下滑线前缀命名，这样导入的模块就不会包含此接口，只在模块自身内部使用。

然后在main.lua进行调用：

import("module")
function main(...)
    module.hello()
end

更多模块介绍见：内置模块和

其中，main(...)中参数，是通过task.run指定的，例如：

里面的arg1, arg2这些就是传入hello任务main(...)入口的参数列表，而{color="red"}用来指定任务菜单中的参数选项。

更加详细的task.run描述，见：task.run