Build Foundation の創設メンバーの登録が開始されました。メーリングリストに参加し、参加契約を読み、登録してください。

Objective-C ルール

Nightly · 9.1 · 9.0 · 8.6 · 8.5 · 8.4 · 8.3 · 8.2 · 8.1

ルール

objc_import
objc_library

objc_import

objc_import(name, deps, hdrs, alwayslink, archives, aspect_hints, compatible_with, deprecation, exec_compatible_with, exec_group_compatible_with, exec_properties, features, includes, package_metadata, restricted_to, sdk_dylibs, sdk_frameworks, sdk_includes, tags, target_compatible_with, testonly, textual_hdrs, toolchains, visibility, weak_sdk_frameworks)

このルールは、コンパイル済みの静的ライブラリを .a ファイルの形式でカプセル化します。また、objc_library でサポートされているのと同じ属性を使用して、ヘッダーとリソースをエクスポートすることもできます。

引数

属性
`name`	名前（必須）このターゲットの一意の名前。
`deps`	ラベルのリスト。デフォルトは`[]` このターゲットが依存するターゲットのリスト。
`hdrs`	ラベルのリスト。デフォルトは`[]` このライブラリによって公開され、依存ルール内のソースに含める C、C++、Objective-C、Objective-C++ ヘッダーファイルのリスト。これらのヘッダーはライブラリの公開インターフェースを記述し、このルールまたは依存ルール内のソースに含めることができます。このライブラリのクライアントに含める必要のないヘッダーは、srcs 属性に一覧表示する必要があります。モジュールが有効になっている場合、これらはソースとは別にコンパイルされます。
`alwayslink`	ブール値。デフォルトは `False` 1 の場合、このライブラリに（直接的または間接的に）依存するバンドルまたはバイナリは、 `srcs` と `non_arc_srcs` にリストされているファイルのすべてのオブジェクトファイルにリンクします。バイナリで参照されるシンボルが含まれていない場合でも同様です。これは、コードがバイナリ内のコードによって明示的に呼び出されない場合に便利です。たとえば、コードが登録して、サービスから提供されるコールバックを受信する場合などです。
`archives`	ラベルのリスト（必須）このターゲットに依存する Objective-C ターゲットに提供される `.a` ファイルのリスト。
`includes`	文字列のリスト。デフォルトは `[]` このターゲットとすべての依存ターゲットに追加する `#include/#import` 検索パスのリスト。これは、`#import/#include` ステートメントでワークスペースパス全体を指定しないサードパーティライブラリとオープンソースライブラリをサポートするためです。パスはパッケージディレクトリからの相対パスとして解釈され、実際のクライアントルートに加えて、genfiles ルートと bin ルート（`blaze-genfiles/pkg/includedir`、`blaze-out/pkg/includedir` など）が含まれます。 COPTS とは異なり、これらのフラグはこのルールと、このルールに依存するすべてのルールに追加されます（依存するルールではありません）。広範囲に影響する可能性があるため、十分注意してください。不明な場合は、代わりに COPTS に「-iquote」フラグを追加してください。
`sdk_dylibs`	文字列のリスト。デフォルトは `[]` リンクする SDK .dylib ライブラリの名前。たとえば、「libz」や「libarchive」などです。バイナリの依存関係ツリーに C++ または Objective-C++ ソースがある場合、「libc++」が自動的に含まれます。バイナリをリンクすると、そのバイナリの推移的依存関係グラフに名前が付けられたすべてのライブラリが使用されます。
`sdk_frameworks`	文字列のリスト。デフォルトは `[]` リンクする SDK フレームワークの名前（「AddressBook」、「QuartzCore」など）。最上位の Apple バイナリをリンクすると、そのバイナリの推移的依存関係グラフにリストされているすべての SDK フレームワークがリンクされます。
`sdk_includes`	文字列のリスト。デフォルトは `[]` このターゲットとすべての依存ターゲットに追加する `#include/#import` 検索パスのリスト。各パスは `$(SDKROOT)/usr/include` からの相対パスです。
`textual_hdrs`	ラベルのリスト。デフォルトは`[]` このルール内のソースファイルまたはこのライブラリのユーザーによってヘッダーとして含まれる C、C++、Objective-C、Objective-C++ ファイルのリスト。hdrs とは異なり、これらはソースとは別にコンパイルされません。
`weak_sdk_frameworks`	文字列のリスト。デフォルトは `[]` 弱くリンクする SDK フレームワークの名前。たとえば、「MediaAccessibility」などです。通常リンクされる SDK フレームワークとは異なり、弱くリンクされたフレームワークのシンボルは、実行時に存在しない場合でもエラーを引き起こしません。

objc_library

ルールのソースを表示

objc_library(name, deps, srcs, data, hdrs, alwayslink, aspect_hints, compatible_with, conlyopts, copts, cxxopts, defines, deprecation, enable_modules, exec_compatible_with, exec_group_compatible_with, exec_properties, features, implementation_deps, includes, linkopts, module_map, module_name, non_arc_srcs, package_metadata, pch, restricted_to, sdk_dylibs, sdk_frameworks, sdk_includes, stamp, tags, target_compatible_with, testonly, textual_hdrs, toolchains, visibility, weak_sdk_frameworks)

このルールは、指定された Objective-C ソースファイルから静的ライブラリを生成します。

引数

属性
`name`	名前（必須）このターゲットの一意の名前。
`deps`	ラベルのリスト。デフォルトは`[]` このターゲットが依存するターゲットのリスト。
`srcs`	ラベルのリスト。デフォルトは`[]` ライブラリターゲットの作成用に処理される C、C++、Objective-C、Objective-C++ のソースファイルとヘッダーファイル、または（`.s`、`.S`、`.asm`）アセンブリソースファイルのリスト。これらは、チェックインしたファイルと生成されたファイルです。ソースファイルは Clang を使用して .o ファイルにコンパイルされます。ヘッダーファイルは、このターゲットの srcs 属性のソースまたはヘッダーによってインクルードまたはインポートできますが、hdrs のヘッダーや、このルールに依存するターゲットではインクルードまたはインポートできません。また、プリコンパイル済みの .o ファイルを srcs として指定することもできます。シンボルリンカーエラーが発生しないように、提供される .o ファイルのアーキテクチャとビルドのアーキテクチャに整合性があることを確認してください。
`hdrs`	ラベルのリスト。デフォルトは`[]` このライブラリによって公開され、依存ルール内のソースに含める C、C++、Objective-C、Objective-C++ ヘッダーファイルのリスト。これらのヘッダーはライブラリの公開インターフェースを記述し、このルールまたは依存ルール内のソースに含めることができます。このライブラリのクライアントに含める必要のないヘッダーは、srcs 属性に一覧表示する必要があります。モジュールが有効になっている場合、これらはソースとは別にコンパイルされます。
`alwayslink`	ブール値。デフォルトは `False` 1 の場合、このライブラリに（直接的または間接的に）依存するバンドルまたはバイナリは、 `srcs` と `non_arc_srcs` にリストされているファイルのすべてのオブジェクトファイルにリンクします。バイナリで参照されるシンボルが含まれていない場合でも同様です。これは、コードがバイナリ内のコードによって明示的に呼び出されない場合に便利です。たとえば、コードが登録して、サービスから提供されるコールバックを受信する場合などです。
`conlyopts`	文字列のリスト。デフォルトは `[]` C ファイルのコンパイラに渡す追加のフラグ。「変数の作成」の置換と Bourne シェルのトークン化の対象となります。これらのフラグは、このターゲットにのみ適用され、依存するターゲットや、このターゲットに依存するターゲットには適用されません。生成された Xcode プロジェクトでは、copts の「-I」フラグを使用して指定されたディレクトリパスが解析され、相対パスの場合は「$(WORKSPACE_ROOT)/」が先頭に追加され、関連する Xcode ターゲットのヘッダー検索パスに追加されます。
`copts`	文字列のリスト。デフォルトは `[]` コンパイラに渡す追加のフラグ。「変数の作成」の置換と Bourne シェルのトークン化の対象となります。これらのフラグは、このターゲットにのみ適用され、依存するターゲットや、このターゲットに依存するターゲットには適用されません。生成された Xcode プロジェクトでは、copts の「-I」フラグを使用して指定されたディレクトリパスが解析され、相対パスの場合は「$(WORKSPACE_ROOT)/」が先頭に追加され、関連する Xcode ターゲットのヘッダー検索パスに追加されます。
`cxxopts`	文字列のリスト。デフォルトは `[]` Objective-C++ ファイルと C++ ファイルのコンパイラに渡す追加のフラグ。「変数の作成」の置換と Bourne シェルのトークン化の対象となります。これらのフラグは、このターゲットにのみ適用され、依存するターゲットや、このターゲットに依存するターゲットには適用されません。生成された Xcode プロジェクトでは、copts の「-I」フラグを使用して指定されたディレクトリパスが解析され、相対パスの場合は「$(WORKSPACE_ROOT)/」が先頭に追加され、関連する Xcode ターゲットのヘッダー検索パスに追加されます。
`defines`	文字列のリスト。デフォルトは `[]` コンパイラに渡す追加の `-D` フラグ。形式は`KEY=VALUE` または単に `KEY` で、このターゲットのコンパイラ（`copts`）だけでなく、このターゲットのすべての `objc_` 依存関係にも渡されます。「変数の作成」の置換と Bourne シェルのトークン化の対象となります。
`enable_modules`	ブール値。デフォルトは `False` clang モジュールサポート（-fmodules 経由）を有効にします。これを 1 に設定すると、システムヘッダーやその他のターゲットを @import できるようになります。@import UIKit; @import path_to_package_target;
`implementation_deps`	ラベルのリスト。デフォルトは`[]` ライブラリターゲットが依存する他のライブラリのリスト。`deps` とは異なり、これらのライブラリ（およびそのすべての推移的依存関係）のヘッダーとインクルードパスは、このライブラリのコンパイルにのみ使用され、このライブラリに依存するライブラリには使用されません。`implementation_deps` で指定されたライブラリは、このライブラリに依存するバイナリターゲットにリンクされます。
`includes`	文字列のリスト。デフォルトは `[]` このターゲットとすべての依存ターゲットに追加する `#include/#import` 検索パスのリスト。これは、`#import/#include` ステートメントでワークスペースパス全体を指定しないサードパーティライブラリとオープンソースライブラリをサポートするためです。パスはパッケージディレクトリからの相対パスとして解釈され、実際のクライアントルートに加えて、genfiles ルートと bin ルート（`blaze-genfiles/pkg/includedir`、`blaze-out/pkg/includedir` など）が含まれます。 COPTS とは異なり、これらのフラグはこのルールと、このルールに依存するすべてのルールに追加されます（依存するルールではありません）。広範囲に影響する可能性があるため、十分注意してください。不明な場合は、代わりに COPTS に「-iquote」フラグを追加してください。
`linkopts`	文字列のリスト。デフォルトは `[]` リンカーに渡す追加のフラグ。
`module_map`	ラベル。デフォルトは `None` このターゲットのカスタム Clang モジュールマップ。カスタムモジュールマップの使用はおすすめしません。ほとんどのユーザーは、Bazel によって生成されたモジュールマップを使用する必要があります。指定した場合、Bazel はこのターゲットのモジュールマップを生成せず、提供されたモジュールマップをコンパイラに渡します。
`module_name`	文字列。デフォルトは `""` このターゲットのモジュール名を設定します。デフォルトでは、モジュール名はターゲットパスで、すべての特殊記号が _ に置き換えられます。たとえば、//foo/baz:bar は foo_baz_bar としてインポートできます。
`non_arc_srcs`	ラベルのリスト。デフォルトは`[]` 自動参照カウント（ARC）を使用しないライブラリターゲットの作成用に処理される Objective-C ファイルのリスト。この属性のファイルは srcs 属性のファイルと非常によく似ていますが、ARC を有効にせずにコンパイルされます。
`pch`	ラベル。デフォルトは `None` コンパイルされるすべてのソースファイル（arc と非 arc の両方）の先頭に追加するヘッダーファイル。 BUILD ファイルでの pch ファイルの使用は積極的におすすめしません。これは非推奨と見なされます。pch ファイルは実際にはプリコンパイルされないため、ビルド速度の向上にはならず、グローバルな依存関係にすぎません。ビルド効率の観点から見ると、必要なものを必要な場所に直接ソースに含める方が優れています。
`sdk_dylibs`	文字列のリスト。デフォルトは `[]` リンクする SDK .dylib ライブラリの名前。たとえば、「libz」や「libarchive」などです。バイナリの依存関係ツリーに C++ または Objective-C++ ソースがある場合、「libc++」が自動的に含まれます。バイナリをリンクすると、そのバイナリの推移的依存関係グラフに名前が付けられたすべてのライブラリが使用されます。
`sdk_frameworks`	文字列のリスト。デフォルトは `[]` リンクする SDK フレームワークの名前（「AddressBook」、「QuartzCore」など）。最上位の Apple バイナリをリンクすると、そのバイナリの推移的依存関係グラフにリストされているすべての SDK フレームワークがリンクされます。
`sdk_includes`	文字列のリスト。デフォルトは `[]` このターゲットとすべての依存ターゲットに追加する `#include/#import` 検索パスのリスト。各パスは `$(SDKROOT)/usr/include` からの相対パスです。
`stamp`	ブール値。デフォルトは `False`
`textual_hdrs`	ラベルのリスト。デフォルトは`[]` このルール内のソースファイルまたはこのライブラリのユーザーによってヘッダーとして含まれる C、C++、Objective-C、Objective-C++ ファイルのリスト。hdrs とは異なり、これらはソースとは別にコンパイルされません。
`weak_sdk_frameworks`	文字列のリスト。デフォルトは `[]` 弱くリンクする SDK フレームワークの名前。たとえば、「MediaAccessibility」などです。通常リンクされる SDK フレームワークとは異なり、弱くリンクされたフレームワークのシンボルは、実行時に存在しない場合でもエラーを引き起こしません。

Objective-C ルール コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

ルール

objc_import

引数

objc_library

引数

Objective-C ルール