Objective-C ルール

問題を報告ソースを表示 Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

ルール

j2objc_library
objc_import
objc_library
available_xcodes
xcode_config
xcode_version

j2objc_library

j2objc_library(name, deps, compatible_with, deprecation, distribs, entry_classes, features, jre_deps, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)

このルールは、J2ObjC を使用して Java ソースファイルを Objective-C に変換します。Objective-C は、objc_library ルールと objc_binary ルールの依存関係として使用できます。J2ObjC 自体の詳細については、J2ObjC のサイトをご覧ください。

カスタム J2ObjC トランスパイルフラグは、コマンドラインでビルドフラグ --j2objc_translation_flags を使用して指定できます。

j2objc_library ターゲットに含まれる変換されたファイルは、デフォルトのコンパイル構成を使用してコンパイルされます。これは、属性にコンパイルオプションが指定されていない objc_library ルールのソースと同じ構成です。

また、生成されたコードはソースレベルではなくターゲットレベルで重複除去されます。同じ Java ソースファイルを含む 2 つの異なる Java ターゲットがある場合、リンク時に重複するシンボルエラーが表示されることがあります。この問題を解決するには、共有 Java ソースファイルを、依存できる別の共通ターゲットに移動します。

引数

属性
`name`	名前: 必須このターゲットの名前。
`deps`	ラベルのリスト。デフォルトは `[]` です。 Objective-C にトランスパイルされる Java ファイルを含む `j2objc_library`、`java_library`、`java_import`、`java_proto_library` ターゲットのリスト。 `exports`、`deps`、`runtime_deps` を介して到達可能なすべての `java_library` ターゲットと `java_import` ターゲット（Java アノテーション処理によって生成されたファイルを含む）が変換され、コンパイルされます。`srcjar` が指定されていない code>java_import ターゲットはサポートされていません。 J2ObjC 変換は、推移閉包に含まれるソース Java ソースファイルのタイプによって異なります。`java_library` の `srcs` に含まれる .java ソースファイルごとに、対応する .h および .m ソースファイルが生成されます。`java_library` の `srcs` または `java_import` の `srcjar` に含まれるソース JAR ごとに、その jar のすべてのコードを含む対応する .h および .m ソースファイルが生成されます。ユーザーは、J2ObjC で生成されたヘッダーファイルをコードにインポートできます。これらのファイルのインポートパスは、元の Java アーティファクトのルート相対パスです。たとえば、`//some/package/foo.java` のインポートパスは `some/package/foo.h` で、`//some/package/bar.srcjar` のインポートパスは `some/package/bar.h` です。 proto_library ルールがこのルールの推移的クロージャに含まれている場合、J2ObjC proto もバイナリレベルで生成、コンパイル、リンクされます。proto `//some/proto/foo.proto` の場合、ユーザーはインポートパス `some/proto/foo.j2objc.pb.h` を使用して、生成されたコードを参照できます。
`entry_classes`	文字列のリスト。デフォルトは `[]` です。変換された ObjC がユーザーの ObjC コードから直接参照される Java クラスのリスト。フラグ `--j2objc_dead_code_removal` がオンの場合、この属性は必須です。Java クラスは、Java 言語仕様で定義されている正規名で指定する必要があります。フラグ `--j2objc_dead_code_removal` が指定されている場合、エントリクラスのリストが伝播的に収集され、デッドコード分析を実行するためのエントリポイントとして使用されます。未使用のクラスは、最終的な ObjC App Bundle から削除されます。
`jre_deps`	ラベルのリスト。デフォルトは `[]` です。この `j2objc_library` ルールによって変換されるすべての Java コードに必要な追加の JRE エミュレーションライブラリのリスト。デフォルトでは、JRE のコア機能のみがリンクされています。

objc_import

ルールソースを表示

objc_import(name, deps, hdrs, alwayslink, archives, compatible_with, deprecation, distribs, features, includes, licenses, restricted_to, sdk_dylibs, sdk_frameworks, sdk_includes, tags, target_compatible_with, testonly, textual_hdrs, 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 とは異なり、これらのフラグはこのルールおよびそれに依存するすべてのルールに追加されます。（注: 依存するルールではありません）。広範囲の影響が及ぶ可能性があるため、細心の注意を払ってください。判断に迷う場合は、代わりに「-iquote」フラグを COPTS に追加してください。
`sdk_dylibs`	文字列のリスト。デフォルトは `[]` です。リンクする SDK .dylib ライブラリの名前。たとえば、「libz」、「libarchive」など。バイナリの依存関係ツリーに C++ ソースまたは Objective-C++ ソースが含まれている場合は、libc++ が自動的にインクルードされます。バイナリをリンクすると、そのバイナリの推移的依存関係グラフで指定されたすべてのライブラリが使用されます。
`sdk_frameworks`	文字列のリスト。デフォルトは `[]` です。リンクする SDK フレームワークの名前（「AddressBook」、「QuartzCore」など）。iOS、tvOS、visionOS、watchOS のプラットフォーム向けにビルドする場合は、常に「UIKit」と「Foundation」が含まれます。macOS の場合、常に「Foundation」のみが含まれます。最上位の 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, compatible_with, copts, defines, deprecation, distribs, enable_modules, exec_compatible_with, exec_properties, features, implementation_deps, includes, licenses, linkopts, module_map, module_name, non_arc_srcs, pch, restricted_to, sdk_dylibs, sdk_frameworks, sdk_includes, 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 ファイルを src として指定することもできます。シンボルリンカーの欠落エラーを回避するため、提供された .o ファイルのアーキテクチャとビルドのアーキテクチャの整合性に注意してください。
`hdrs`	ラベルのリスト。デフォルトは `[]` です。依存ルールのソースによってインクルードされるように、このライブラリによってパブリッシュされる、C、C++、Objective-C、Objective-C++ のヘッダーファイルのリスト。これらのヘッダーはライブラリの公開インターフェースを記述し、このルールまたは依存するルールのソースによって使用できるようになります。このライブラリのクライアントによってインクルードされることを意図していないヘッダーは、srcs 属性でリストする必要があります。モジュールが有効になっている場合、これらはソースとは別にコンパイルされます。
`alwayslink`	ブール値。デフォルトは `False` です。 1 の場合、このライブラリに（直接的または間接的に）依存するバンドルまたはバイナリは、`srcs` と `non_arc_srcs` にリストされているファイルのすべてのオブジェクトファイルにリンクします。これには、バイナリによって参照されるシンボルが含まれていないファイルも含まれます。これは、バイナリ内のコードによってコードが明示的に呼び出されていない場合（たとえば、なんらかのサービスから提供されるコールバックを受け取るようにコードが登録されている場合）に役立ちます。
`copts`	文字列のリスト。デフォルトは `[]` です。コンパイラに渡す追加のフラグ。「変数を作成」の置換と 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」など）。iOS、tvOS、visionOS、watchOS のプラットフォーム向けにビルドする場合は、常に「UIKit」と「Foundation」が含まれます。macOS の場合、常に「Foundation」のみが含まれます。最上位の Apple バイナリをリンクすると、そのバイナリの伝播依存関係グラフにリストされているすべての SDK フレームワークがリンクされます。
`sdk_includes`	文字列のリスト。デフォルトは `[]` です。このターゲットと依存するすべてのターゲットに追加する `#include/#import` 検索パスのリスト。各パスは `$(SDKROOT)/usr/include` からの相対パスです。
`textual_hdrs`	ラベルのリスト。デフォルトは `[]` です。このルールのソースファイルまたはこのライブラリのユーザーによってヘッダーとして含められる C、C++、Objective-C、Objective-C++ ファイルのリスト。hdr とは異なり、これらはソースとは別にコンパイルされません。
`weak_sdk_frameworks`	文字列のリスト。デフォルトは `[]` です。弱いリンクを設定する SDK フレームワークの名前。たとえば、「MediaAccessibility」などです。定期的にリンクされる SDK フレームワークとは異なり、弱くリンクされたフレームワークのシンボルは、実行時に存在していなくてもエラーの原因になりません。

available_xcodes

ルールのソースを表示

available_xcodes(name, default, deprecation, distribs, features, licenses, tags, testonly, versions, visibility)

リモートとローカルで利用可能な Xcode のバージョンを示すために、xcode_config ルールインスタンスによってこのルールの 2 つのターゲットを指定できます。これにより、まとめて利用可能な xcode から公式の xcode バージョンを選択できます。

引数

属性

name

名前: 必須

このターゲットの名前。

default

ラベル、設定不可、必須

このプラットフォームのデフォルトの Xcode バージョン。

versions

ラベルのリスト。構成不可。デフォルトは []。

このプラットフォームで利用可能な Xcode バージョン。

xcode_config

ルールのソースを表示

xcode_config(name, default, deprecation, distribs, features, licenses, local_versions, remote_versions, tags, testonly, versions, visibility)

このルールの単一ターゲットを --xcode_version_config ビルドフラグで参照して、--xcode_version フラグを承認済みの公式 xcode バージョンに変換できます。これにより、多数の登録済みエイリアスから公式の Xcode バージョンを選択できます。

引数

属性
`name`	名前（必須）このターゲットの一意の名前。
`default`	ラベル: 構成不可、デフォルトは `None` 使用する Xcode のデフォルトの公式バージョン。`xcode_version` ビルドフラグが指定されていない場合は、指定された `xcode_version` ターゲットで指定されたバージョンが使用されます。`versions` が設定されている場合は必須です。`remote_versions` または `local_versions` が設定されている場合、これは設定されないことがあります。
`local_versions`	ラベル。構成不可。デフォルトは `None` ローカルで利用可能な `xcode_version` ターゲット。これらは `local_versions` とともに使用され、相互に利用可能なバージョンを選択します。`versions` が設定されている場合、この値は設定されないことがあります。
`remote_versions`	ラベル: 構成不可、デフォルトは `None` リモートで使用可能な `xcode_version` ターゲット。これらは、相互に使用可能なバージョンを選択するために `remote_versions` とともに使用されます。`versions` が設定されている場合、この値は設定されないことがあります。
`versions`	ラベルのリスト。構成不可。デフォルトは `[]`。使用できる承認済みの `xcode_version` ターゲット。`xcode_version` ビルドフラグの値が、指定された `xcode_version` ターゲットのいずれかのエイリアスまたはバージョン番号と一致する場合、一致するターゲットが使用されます。`remote_versions` または `local_versions` が設定されている場合、これは設定されないことがあります。

xcode_version

ルールソースを表示

xcode_version(name, default_ios_sdk_version, default_macos_sdk_version, default_tvos_sdk_version, default_visionos_sdk_version, default_watchos_sdk_version, deprecation, distribs, features, licenses, tags, testonly, version, visibility)

1 つの公式 Xcode バージョンと、その Xcode バージョンで使用可能なエイリアスを表します。xcode_config ルールを確認します。

引数

属性
`name`	名前（必須）このターゲットの一意の名前。
`default_ios_sdk_version`	文字列、設定不可、デフォルトは `""` このバージョンの xcode が使用されているときにデフォルトで使用される iOS SDK バージョン。`ios_sdk_version` ビルドフラグは、ここで指定された値をオーバーライドします。
`default_macos_sdk_version`	文字列。構成不可。デフォルトは `""` です。このバージョンの Xcode が使用されている場合にデフォルトで使用される macosx SDK バージョン。`macos_sdk_version` ビルドフラグは、ここで指定された値をオーバーライドします。
`default_tvos_sdk_version`	文字列。構成不可。デフォルトは `""` です。このバージョンの Xcode が使用されている場合にデフォルトで使用される tvos sdk バージョン。ここで指定した値は、`tvos_sdk_version` ビルドフラグによってオーバーライドされます。
`default_visionos_sdk_version`	文字列、設定不可、デフォルトは `""` このバージョンの Xcode が使用されている場合にデフォルトで使用される visionos sdk バージョン。`visionos_sdk_version` ビルドフラグは、ここで指定された値をオーバーライドします。
`default_watchos_sdk_version`	文字列。構成不可。デフォルトは `""` です。このバージョンの xcode が使用されているときにデフォルトで使用される watchos SDK バージョン。`watchos_sdk_version` ビルドフラグは、ここで指定された値をオーバーライドします。
`version`	文字列。構成不可。必須 Xcode のバージョンの公式バージョン番号。