程式庫目標 (lib 繼承 build_tgt)

表示一個共享或靜態程式庫

由以下擴展

程式庫目標由以下子類型擴展

• both_libs

由以下回傳

程式庫目標物件由以下函式和方法回傳

• library()
• shared_library()
• static_library()
• both_libs.get_shared_lib()
• both_libs.get_static_lib()

繼承的方法

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 起) 預設值 = 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()

---