ビルドターゲット (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 以降) デフォルト値 = 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
)

引数

このメソッドは、型 str | file の 1 から 無限 の可変引数 (source...) を受け入れます。

ビルドされたオブジェクトを抽出する必要があるソースファイル名。

---

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

---