JAR 构建目标（jar 扩展了 build_tgt）

一个 Java JAR 构建目标

返回值

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

• jar()

继承的方法

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()

---