Build-Ziel (build_tgt erweitert tgt)

Ein Build-Ziel ist entweder eine ausführbare Datei, eine gemeinsam genutzte Bibliothek, eine statische Bibliothek, sowohl eine gemeinsam genutzte als auch eine statische Bibliothek oder ein gemeinsam genutztes Modul.

Erweitert durch

Build-Ziel wird durch die folgenden Untertypen erweitert

• exe
• jar
• lib

Zurückgegeben von

Build-Zielobjekte werden von den folgenden Funktionen und Methoden zurückgegeben

• build_target()
• shared_module()

Build-Zielmethoden

build_tgt.extract_all_objects()

Verhält sich genauso wie extract_objects, gibt aber alle von diesem Ziel generierten Objektdateien zurück.

Standardmäßig werden nur für dieses Ziel erstellte Objekte zurückgegeben, um die Abwärtskompatibilität mit früheren Versionen zu gewährleisten. Der Standardwert für das Schlüsselwortargument recursive wird in einer zukünftigen Version schließlich auf true geändert.

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

Argumente

Die Methode build_tgt.extract_all_objects() akzeptiert die folgenden Schlüsselwortargumente

Name	Typ	Beschreibung	Schlagwörter
rekursiv	bool	Gibt auch Objekte zurück, die an das objects-Argument dieses Ziels übergeben wurden.	(seit 0.46.0) Standard = true

---

build_tgt.extract_objects()

Gibt einen undurchsichtigen Wert zurück, der die für diese Quelldateien generierten Objektdateien darstellt. Dies wird typischerweise verwendet, um einzelne Objektdateien zu nehmen und sie mit Unit-Tests zu verknüpfen oder einige Quelldateien mit benutzerdefinierten Flags zu kompilieren. Um die Objektdatei(en) in einem anderen Build-Ziel zu verwenden, verwenden Sie das Schlüsselwortargument objects: für ein build_target() oder declare_dependency() oder fügen Sie sie in die Befehlszeile eines custom_target() ein.

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

Argumente

Die Methode akzeptiert zwischen 1 und unendlich variable Argumente (source...) vom Typ str | file.

Namen von Quelldateien, für die die erstellten Objekte extrahiert werden sollen.

---

build_tgt.found()

Gibt immer true zurück. Diese Funktion soll ausführbare Objekte funktionskompatibel mit external_program-Objekten machen. Dies vereinfacht Anwendungsfälle, in denen eine ausführbare Datei anstelle eines external_program verwendet wird.

bool found()

---

build_tgt.full_path()

Gibt einen vollständigen Pfad zurück, der auf die Ergebniszielfdatei zeigt. HINWEIS: In den meisten Fällen erfüllt die Verwendung des Objekts selbst denselben Zweck und ermöglicht es Meson auch, Abhängigkeiten zwischen Zielen korrekt einzurichten. Bitte reichen Sie einen Fehler ein, wenn dies für Sie nicht funktioniert.

str full_path()

---

build_tgt.name()

Gibt den Namen des Ziels zurück.

str name()

---

build_tgt.path()

Macht exakt dasselbe wie build_tgt.full_path(). HINWEIS: Diese Funktion wird ausschließlich zur Kompatibilität mit external_program-Objekten beibehalten. Sie wird entfernt, sobald die ebenfalls veraltete entsprechende path()-Funktion im external_program-Objekt entfernt wird.

str path()

---

build_tgt.private_dir_include()

Gibt einen Wert zurück, der wie include_directories() funktioniert, aber auf das private Verzeichnis dieses Ziels verweist. Normalerweise nur benötigt, wenn ein anderes Ziel auf einige generierte interne Header dieses Ziels zugreifen muss.

inc private_dir_include()

---