This is a mirror page, please see the original page:

https://xmake.io/#/zh-cn/manual/target_instance

此页面描述了 工程目标on_load()before_build()after_install() 等函数的 target 接口

target:name

target:get

任何在描述域的 set_xxxadd_xxx 配置值都可以通过这个接口获取到。

-- get the links
target:get("links")
-- get the defined macros
target:get("defines")

target:set

-- set the links
target:set("links", "sdl2")
-- set the defined macros
target:set("defines", "SDL_MAIN_HANDLED")

target:add

-- add links
target:add("links", "sdl2")
-- add defined macros
target:add("defines", "SDL_MAIN_HANDLED")

target:kind

对应 set_kind 描述域接口设置。目标类型主要有:binary, static, shared, phony, object, headeronly。

target:is_plat

尽管,我们也可以用 is_plat 全局接口直接判断平台,但是 xmake 支持使用 set_plat 针对特定 target 单独设置编译平台。

这个时候,使用全局接口,就不适用了,所以通常我们推荐使用 target 提供的接口,来直接对当前 target 判断编译平台,更加可靠。

-- Is the current platform android?
target:is_plat("android")
-- Is the current platform windows, linux or macosx?
target:is_plat("windows", "linux", "macosx")

target:is_arch

尽管,我们也可以用 is_arch 全局接口直接判断架构,但是 xmake 支持使用 set_arch 针对特定 target 单独设置编译架构。

这个时候,使用全局接口,就不适用了,所以通常我们推荐使用 target 提供的接口,来直接对当前 target 判断编译架构,更加可靠。

-- Is the current architecture x86
target:is_arch("x86")
-- Is the current architecture x64 or x86_64
target:is_arch("x64", "x86_64")

target:targetfile

主要用于获取 static, shared, binary 目标程序文件的输出路径。

os.cp(target:targetfile(), "/tmp/")

target:targetdir

也就是 target:targetfile() 对应的存储目录。

target:basename

也就是 libfoo.a,foo.dll, foo.exe 中的 foo

target:filename

目标文件的完整文件名,等价于 path.filename(target:targetfile())

target:installdir

通常用于 xmake install/uninstall 的 after_install 等脚本中获取对应的安装目录路径,可以用于用户自定义安装脚本。

target:autogendir

这个通常用于一些自定义规则脚本中,存放一些特定于 target 的自动生成文件,路径通常在 build/.gens/target 下面。

比如,我们在处理 lex/yacc 自动生成一些源码文件,就可以存放在这个目录下,方便之后去处理它。

target:objectfile

通常用于自定义脚本中,获取源文件对应的目标文件路径,例如

local objectfile = target:objectfile(sourcefile)

target:sourcebatches

它可以获取到 add_files 添加的所有源文件,并且根据不同源文件类型,分别存储。

大概结构如下:

{
  "c++.build" = {
    objectfiles = {
      "build/.objs/test/macosx/x86_64/release/src/main.cpp.o"
    },
    rulename = "c++.build",
    sourcekind = "cxx",
    sourcefiles = {
      "src/main.cpp"
    },
    dependfiles = {
      "build/.deps/test/macosx/x86_64/release/src/main.cpp.o.d"
    }
  },
  "asm.build" = {
    objectfiles = {
      "build/.objs/test/macosx/x86_64/release/src/test.S.o"
    },
    rulename = "asm.build",
    sourcekind = "as",
    sourcefiles = {
      "src/test.S"
    },
    dependfiles = {
      "build/.deps/test/macosx/x86_64/release/src/test.S.o.d"
    }
  }
}

我们可以通过遍历去获取处理每种类型的源文件。

for _, sourcebatch in pairs(target:sourcebatches()) do
    local sourcekind = sourcebatch.sourcekind
    if sourcekind == "cc" or sourcekind == "cxx" or sourcekind == "as" then
        for _, sourcefile in ipairs(sourcebatch.sourcefiles) do
            -- TODO
        end
    end
end

其中 sourcekind 是每种源文件的类型,cc 是 c 文件类型,cxx 是 c++ 源文件,as 是 asm 源文件。

sourcebatch 对应每种类型的源文件 batch,对应一批同类型源文件。

sourcebatch.sourcefiles 是源文件列表,sourcebatch.objectfiles 是对象文件列表,sourcebatch.rulename 是对应的规则名。

target:objectfiles

尽管 target:sourcebatches() 也可以获取所有对象文件,但是它们是根据源文件类型分类过的,且不直接参与最终链接。

如果我们想动态修改最终链接的对象文件列表,可以修改 target:objectfiles(),它是一个数组列表。

target:headerfiles

可以获取到 add_headerfiles() 接口设置的所有头文件列表。

for _, headerfile in ipairs(target:headerfiles()) do
    -- TODO
end

target:scriptdir

这通常在自定义规则中使用的比较多,想获取当前 target 实际被定义在哪个 xmake.lua 所在目录下,方便引用一些资源文件,可以用这个接口。

!> 此处文档还在进行中,请耐心等待,你也可以通过赞助或者提 pr 来加速文档的更新