Objective-C ルール

ルール

<ph type="x-smartling-placeholder"></ph> j2objc_library
<ph type="x-smartling-placeholder"></ph> objc_import
<ph type="x-smartling-placeholder"></ph> objc_library
<ph type="x-smartling-placeholder"></ph> available_xcodes
<ph type="x-smartling-placeholder"></ph> xcode_config
<ph type="x-smartling-placeholder"></ph> 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 にエクスポートすると、objc_library や objc_binary の依存関係として使用できます。できます。J2ObjC 自体について詳しくは、 J2ObjC サイト

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

j2objc_library ターゲットに含まれる翻訳ファイルは、デフォルトのコンパイル構成でコンパイルします。属性にコンパイルオプションが指定されていない objc_library ルール。

さらに、生成されたコードはソースレベルではなくターゲットレベルで重複排除されます。もし同じ Java ソースファイルを含む異なる Java ターゲットを使用すると、重複シンボルエラーが表示されることがあります。表示されます。この問題を解決するための正しい方法は、共有 Java ソースファイルを共通のターゲットが存在します。

引数

属性
`name`	`Name; required` このターゲットの一意の名前。
`deps`	`List of labels; optional` `j2objc_library`、`java_library`、次を含む `java_import` ターゲットと `java_proto_library` ターゲット Objective-C にトランスパイルされる Java ファイル。リーチできるすべての「`java_library`」および「`java_import`」目標 `exports`、`deps`、`runtime_deps` を通じて推移的変換とコンパイルが行われます。現時点では、Java で生成されたファイルは `srcjar` のないアノテーション処理または `java_import` ターゲットあります。 J2ObjC 変換の動作は、ソース Java ソースのタイプによって異なるされます。含まれる .java ソースファイルごとに、 `java_library` の `srcs`（対応する .h および .m ソースファイル）生成されます。`srcs` 個に含まれるソース JAR ごとに `java_library` または `srcjar`/`java_import`、対応する .h および .m ソースファイルが、その jar のすべてのコードとともに生成されます。ユーザーは、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`。ユーザーは import を使用して生成されたコードを参照できます。パス `some/proto/foo.j2objc.pb.h`。
`entry_classes`	`List of strings; optional` 変換された ObjC が直接参照される Java クラスのリスト読み取りますフラグ `--j2objc_dead_code_removal` がオンの場合、この属性は必須です。Java クラスは、 Java 言語仕様。フラグ `--j2objc_dead_code_removal` が指定されている場合、エントリクラスのリスト推移的に収集され、デッドコード分析を行うためのエントリポイントとして使用されます。未使用のクラスは、最終的な ObjC App Bundle から削除されます。
`jre_deps`	`List of labels; optional` この API によって変換されるすべての Java コードに必要な追加の JRE エミュレーションライブラリのリスト `j2objc_library` ルール。デフォルトでは、JRE のコア機能のみがリンクされています。

objc_import

objc_import(name, 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 ファイル。また、同じ Cloud Storage バケットを使用して、 objc_library でサポートされている属性。

引数

属性
`name`	`Name; required` このターゲットの一意の名前。
`hdrs`	`List of labels; optional` 公開されている C、C++、Objective-C、Objective-C++ のヘッダーファイルのリスト依存するルールのソースに含まれている必要があります。これらのヘッダーは、ライブラリの公開インターフェースを記述したものです。ルールに含まれているか、または独立しているできます。このライブラリのクライアントに含めることを想定していないヘッダー srcs 属性で指定する必要があります。モジュールが有効になっている場合、これらはソースとは別にコンパイルされます。
`alwayslink`	`Boolean; optional; default is False` 1 の場合、これに（直接的または間接的に）依存するバンドルまたはバイナリリストにあるファイルのすべてのオブジェクトファイルを `srcs` と `non_arc_srcs`（含まれていないものも含む）バイナリによって参照されるシンボル。これは、Python のコードでコードを明示的に呼び出していない場合にバイナリを受け取るコード（たとえば、コールバックを受け取るためにコードが登録されている場合）提供します。
`archives`	`List of labels; required` Objective-C ターゲットに指定された `.a` ファイルのリストこのターゲットに依存します。
`includes`	`List of strings; optional` このターゲットに追加する `#include/#import` 検索パスのリストそして、それに依存するすべての標的です。これは、サポートしていないサードパーティおよびオープンソースライブラリをワークスペース全体のパスを `#import/#include` ステートメント。パスはパッケージディレクトリからの相対パスとして解釈され、 genfiles と bin ルート（例: `blaze-genfiles/pkg/includedir` と `blaze-out/pkg/includedir` など）は、あります。 COPTS とは異なり、以下のフラグはこのルールに追加されます。依存するすべてのルールについて学習しました。（注: コンテナが依存するルールではありません）。行動広範囲に影響が及ぶ可能性があるため、細心の注意を払ってください。判断に迷う場合は、「-iquo」COPTS に渡します。
`sdk_dylibs`	`List of strings; optional` リンクする SDK .dylib ライブラリの名前。例: 「libz」または「libarchive」。 "libc++"バイナリに C++ コードまたは依存関係ツリー内の Objective-C++ ソース。バイナリをリンクするときは、そのバイナリの推移的依存関係グラフで指定されたすべてのライブラリが、分析できます
`sdk_frameworks`	`List of strings; optional` リンクする SDK フレームワークの名前（「AddressBook」、「QuartzCore」など）。「UIKit」および "基盤"iOS、tvOS、watchOS の各プラットフォーム向けにビルドする場合は、常に含まれます。 macOS の場合は、「Foundation」のみ常に含まれます。最上位の Apple バイナリをリンクすると、そのバイナリのリストにリストされているすべての SDK フレームワークが推移的依存関係グラフがリンクされています
`sdk_includes`	`List of strings; optional` このターゲットに追加する `#include/#import` 検索パスのリストすべての依存ターゲットに対して、各パスは `$(SDKROOT)/usr/include`。
`textual_hdrs`	`List of labels; optional` サポートされている C、C++、Objective-C、および Objective-C++ ファイルのリストこのルールのソースファイル、またはこのルールのライブラリです。hdrs とは異なり、これらは SDK とは別にコンパイルあります。
`weak_sdk_frameworks`	`List of strings; optional` 弱いリンクを設定する 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, runtime_deps, sdk_dylibs, sdk_frameworks, sdk_includes, tags, target_compatible_with, testonly, textual_hdrs, toolchains, visibility, weak_sdk_frameworks)

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

引数

属性
`name`	`Name; required` このターゲットの一意の名前。
`deps`	`List of labels; optional` 最終的なバンドルを形成するためにリンクされるターゲットのリスト。
`srcs`	`List of labels; optional` C、C++、Objective-C、Objective-C++ のソースとヘッダーのリストファイル、および/または（`.s`、`.S`、`.asm`）アセンブリソースファイル。指定します。これらは、チェックインしたファイルと、生成されたすべてのファイルです。ソースファイルは Clang で .o ファイルにコンパイルされます。ヘッダーファイル srcs 属性の任意のソースまたはヘッダーによってインクルードまたはインポートできるアクセスできますが、hdrs のヘッダーや表示されます。また、プリコンパイル済みの .o ファイルは srcs として指定することができます。注意すべき点は、提供された .o ファイルのアーキテクチャと、ビルドすることで、シンボルリンカーの欠落エラーを回避できます。
`hdrs`	`List of labels; optional` 公開されている C、C++、Objective-C、Objective-C++ のヘッダーファイルのリスト依存するルールのソースに含まれている必要があります。これらのヘッダーは、ライブラリの公開インターフェースを記述したものです。ルールに含まれているか、または独立しているできます。このライブラリのクライアントに含めることを想定していないヘッダー srcs 属性で指定する必要があります。モジュールが有効になっている場合、これらはソースとは別にコンパイルされます。
`alwayslink`	`Boolean; optional; default is False` 1 の場合、これに（直接的または間接的に）依存するバンドルまたはバイナリリストにあるファイルのすべてのオブジェクトファイルを `srcs` と `non_arc_srcs`（含まれていないものも含む）バイナリによって参照されるシンボル。これは、Python のコードでコードを明示的に呼び出していない場合にバイナリを受け取るコード（たとえば、コールバックを受け取るためにコードが登録されている場合）提供します。
`copts`	`List of strings; optional` コンパイラに渡す追加のフラグ。「変数を作成」による置換を適用し、 Bourne シェルのトークン化。これらのフラグはこのターゲットにのみ適用されます。関係するようになります。生成された Xcode プロジェクトでは、ディレクトリパスは「-I」を使用して指定します。使用すると、 copt が解析され、先頭に「$(WORKSPACE_ROOT)/」が付加されます相対パスの場合は関連する Xcode ターゲットのヘッダー検索パスに追加されます。
`defines`	`List of strings; optional` コンパイラに渡す追加の `-D` フラグ。地域 `KEY=VALUE` の形式または単に `KEY` です。このターゲットのコンパイラだけでなく、`copts` として渡されます。ありますが、このターゲットのすべての `objc_` 依存関係も対象となります。「変数を作成」による置換を適用し、 Bourne シェルのトークン化。
`enable_modules`	`Boolean; optional; default is False` clang モジュールのサポートを有効にします（-fmodules を使用）。これを 1 に設定すると、システムヘッダーやその他のターゲットを @import できるようになります。 @import UIKit; @import path_to_package_target;
`implementation_deps`	`List of labels; optional` ライブラリターゲットが依存する他のライブラリのリスト。他社との違い `deps`: これらのライブラリのヘッダーとインクルードパス（および推移的依存関係）は、このライブラリのコンパイルにのみ使用され、依存します。`implementation_deps` で指定されたライブラリは引き続きリンクされていますバイナリターゲットに格納されます。
`includes`	`List of strings; optional` このターゲットに追加する `#include/#import` 検索パスのリストそして、それに依存するすべての標的です。これは、サポートしていないサードパーティおよびオープンソースライブラリをワークスペース全体のパスを `#import/#include` ステートメント。パスはパッケージディレクトリからの相対パスとして解釈され、 genfiles と bin ルート（例: `blaze-genfiles/pkg/includedir` と `blaze-out/pkg/includedir` など）は、あります。 COPTS とは異なり、以下のフラグはこのルールに追加されます。依存するすべてのルールについて学習しました。（注: コンテナが依存するルールではありません）。行動広範囲に影響が及ぶ可能性があるため、細心の注意を払ってください。判断に迷う場合は、「-iquo」COPTS に渡します。
`linkopts`	`List of strings; optional` リンカーに渡す追加のフラグ。
`module_map`	`Label; optional` このターゲットのカスタム Clang モジュールマップ。カスタムモジュールマップの使用はおすすめしません。ほとんど Bazel で生成されたモジュールマップを使用する必要があります。指定すると、Bazel はこのターゲットのモジュールマップを生成しませんが、渡されます。
`module_name`	`String; optional` このターゲットのモジュール名を設定します。デフォルトでは、モジュール名はすべての特殊記号を _ で置き換えたもの。例://foo/baz:bar は foo_baz_bar としてインポートできます。
`non_arc_srcs`	`List of labels; optional` 作成のために処理される Objective-C ファイルのリスト ARC を使用しないライブラリターゲット。この属性に含まれるファイルは、 srcs 属性ですが、ARC を有効にせずにコンパイルされます。
`pch`	`Label; optional` コンパイルされるすべてのソースファイルの先頭に付加するヘッダーファイル（両曲線ともアークなし）。 BUILD ファイルでは pch ファイルの使用は推奨されておらず、非推奨とみなされます。pch ファイルは実際にはプリコンパイルされないため、ビルド速度が向上しており、単なるグローバルな依存関係に過ぎません。ビルドから効率性の面では必要なものを直接含めた方がよいでしょうスキャンできます。
`runtime_deps`	`List of labels; optional` ランタイム時に遅れて読み込まれるフレームワークターゲットのリスト。記載されているビルド時にリンクされていないことを示します。
`sdk_dylibs`	`List of strings; optional` リンクする SDK .dylib ライブラリの名前。例: 「libz」または「libarchive」。 "libc++"バイナリに C++ コードまたは依存関係ツリー内の Objective-C++ ソース。バイナリをリンクするときは、そのバイナリの推移的依存関係グラフで指定されたすべてのライブラリが、分析できます
`sdk_frameworks`	`List of strings; optional` リンクする SDK フレームワークの名前（「AddressBook」、「QuartzCore」など）。「UIKit」および "基盤"iOS、tvOS、watchOS の各プラットフォーム向けにビルドする場合は、常に含まれます。 macOS の場合は、「Foundation」のみ常に含まれます。最上位の Apple バイナリをリンクすると、そのバイナリのリストにリストされているすべての SDK フレームワークが推移的依存関係グラフがリンクされています
`sdk_includes`	`List of strings; optional` このターゲットに追加する `#include/#import` 検索パスのリストすべての依存ターゲットに対して、各パスは `$(SDKROOT)/usr/include`。
`textual_hdrs`	`List of labels; optional` サポートされている C、C++、Objective-C、および Objective-C++ ファイルのリストこのルールのソースファイル、またはこのルールのライブラリです。hdrs とは異なり、これらは SDK とは別にコンパイルあります。
`weak_sdk_frameworks`	`List of strings; optional` 弱いリンクを設定する SDK フレームワークの名前。たとえば「MediaAccessibility」。定期的にリンクされている SDK フレームワークとの違いは、シンボルが依存関係が弱くリンクされている場合、そのフレームワークが実行時に存在しません。

available_xcodes

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

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

引数

属性

name

Name; required

このターゲットの一意の名前。

default

Label; required; nonconfigurable

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

versions

List of labels; optional; nonconfigurable

このプラットフォームで利用可能な 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`	`Name; required` このターゲットの一意の名前。
`default`	`Label; optional; nonconfigurable` 使用する xcode のデフォルトの公式バージョン。指定された `xcode_version` ターゲットで指定されたバージョンは、次の場合に使用されます。 `xcode_version` ビルドフラグは指定されていません。このフィールドは必須です `versions` が設定されました。`remote_versions` または `local_versions` が設定されました。
`local_versions`	`Label; optional; nonconfigurable` `xcode_version targets that are available locally. These are used along with local_versions to select a mutually available version. This may not be set if versions is set.`
`remote_versions`	`Label; optional; nonconfigurable` `xcode_version targets that are available remotely. These are used along with remote_versions to select a mutually available version. This may not be set if versions is set.`
`versions`	`List of labels; optional; nonconfigurable` 承認済み: `xcode_version targets that may be used. If the value of the xcode_version build flag matches one of the aliases or version number of any of the given xcode_version targets, the matching target will be used. This may not be set if remote_versions or local_versions is set.`

xcode_version

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

その xcode バージョンの有効なエイリアスを持つ単一の公式 xcode バージョンを表します。 xcode_config ルールをご覧ください。

引数

属性
`name`	`Name; required` このターゲットの一意の名前。
`default_ios_sdk_version`	`String; optional; nonconfigurable` このバージョンの xcode が使用されているときにデフォルトで使用される iOS SDK バージョン。 `ios_sdk_version` ビルドフラグは、ここで指定された値をオーバーライドします。
`default_macos_sdk_version`	`String; optional; nonconfigurable` このバージョンの xcode が使用されているときにデフォルトで使用される macOS SDK のバージョン。 `macos_sdk_version` ビルドフラグは、ここで指定された値をオーバーライドします。
`default_tvos_sdk_version`	`String; optional; nonconfigurable` このバージョンの xcode が使用されているときにデフォルトで使用される tvos SDK のバージョン。 `tvos_sdk_version` ビルドフラグは、ここで指定された値をオーバーライドします。
`default_watchos_sdk_version`	`String; optional; nonconfigurable` このバージョンの xcode が使用されているときにデフォルトで使用される watchos SDK バージョン。 `watchos_sdk_version` ビルドフラグは、ここで指定された値をオーバーライドします。
`version`	`String; required; nonconfigurable` Xcode バージョンの正式なバージョン番号。