构建目标（build_tgt 扩展 tgt）

构建目标可以是可执行文件、共享库、静态库、共享和静态库的组合，或者共享模块。

扩展

构建目标由以下子类型扩展

• exe
• jar
• lib

返回

构建目标对象由以下函数和方法返回

• build_target()
• shared_module()

构建目标方法

build_tgt.extract_all_objects()

与 extract_objects 行为相同，但返回此目标生成的所有目标文件。

默认情况下，仅返回为该目标构建的对象，以保持与先前版本的向后兼容性。recursive 关键字参数的默认值将在将来版本中最终更改为 true。

# Acts the same as `extract_objects`, but returns all object files generated
extracted_obj extract_all_objects(
  recursive : bool  # Also return objects passed to the `objects` argument of this target
)

参数

build_tgt.extract_all_objects() 方法接受以下关键字参数

名称	类型	描述	标签
recursive	bool	也返回传递给此目标的 objects 参数的对象。	(自 0.46.0 起) default = true

---

build_tgt.extract_objects()

返回一个不透明的值，表示为这些源文件生成的目标文件。这通常用于提取单个目标文件并将其链接到单元测试，或者使用自定义标志编译一些源文件。要在另一个构建目标中使用目标文件，请在 build_target() 或 declare_dependency() 的 objects: 关键字参数中使用它们，或者将它们包含在 custom_target() 的命令行中。

# Returns an opaque value representing the object files generated for those
extracted_obj extract_objects(
  str | file source...,  # Source filenames for which the built objects should be extracted
)

参数

该方法接受 1 到 infinity 个可变参数（source...），类型为 str | file。

应该提取构建对象的源文件名。

---

build_tgt.found()

始终返回 true。此函数旨在使可执行文件对象与 external_program 对象具有功能兼容性。这简化了使用可执行文件代替 external_program 的用例。

bool found()

---

build_tgt.full_path()

返回指向结果目标文件的完整路径。注意：在大多数情况下，使用对象本身将与使用此方法具有相同的效果，并且还将允许 Meson 正确设置目标间依赖关系。如果这对您不起作用，请提交错误报告。

str full_path()

---

build_tgt.name()

返回目标的名称。

str name()

---

build_tgt.path()

与 build_tgt.full_path() 做完全相同的事情。注意：此函数仅为了与 external_program 对象保持兼容性。一旦 external_program 对象中对应的已弃用 path() 函数被删除，该函数也将被删除。

str path()

---

build_tgt.private_dir_include()

返回一个类似于 include_directories() 的值，但指向此目标的私有目录。通常仅在另一个目标需要访问此目标的一些生成的内部头文件时才需要。

inc private_dir_include()

---