ワークスペース ルールは、外部依存関係（通常はメイン リポジトリの外部にあるソースコード）を pull するために使用されます。
注: Bazel には、ネイティブ ワークスペース ルールのほかに、さまざまな Starlark ワークスペース ルールも埋め込まれています。特に、ウェブでホストされている git リポジトリやアーカイブを処理するルールが埋め込まれています。
ルール
バインド
ルールソースを表示bind(name, actual, compatible_with, deprecation, distribs, features, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)
警告: bind() の使用はおすすめしません。問題と代替方法について詳しくは、bind の削除を検討するをご覧ください。特に、repo_mapping リポジトリ属性の使用を検討してください。
警告: select() は bind() では使用できません。詳しくは、構成可能な属性に関するよくある質問をご覧ください。
//external パッケージでターゲットにエイリアスを付与します。
//external パッケージは「通常の」パッケージではありません。external/ ディレクトリがないため、バインドされたすべてのターゲットを含む「仮想パッケージ」と見なすことができます。
例
ターゲットにエイリアスを設定するには、WORKSPACE ファイルで bind します。たとえば
java_library ターゲットが
//third_party/javacc-v2。これは、次の行を
WORKSPACE ファイル:
bind(
name = "javacc-latest",
actual = "//third_party/javacc-v2",
)
ターゲットが //third_party/javacc-v2 ではなく //external:javacc-latest に依存できるようになりました。javacc-v3 がリリースされている場合は、bind ルールを
//external:javacc-latest に依存するすべての BUILD ファイルが更新され、
javacc-v3 に依存するため編集する必要はありません。
Bind を使用して、外部リポジトリのターゲットをワークスペースで使用できるようにすることもできます。たとえば、WORKSPACE ファイルにインポートされた @my-ssl という名前のリモート リポジトリがあり、cc_library ターゲット //src:openssl-lib がある場合、bind を使用してこのターゲットのエイリアスを作成できます。
bind(
name = "openssl",
actual = "@my-ssl//src:openssl-lib",
)
次に、ワークスペースの BUILD ファイルで、バインドされたターゲットを次のように使用できます。
cc_library(
name = "sign-in",
srcs = ["sign_in.cc"],
hdrs = ["sign_in.h"],
deps = ["//external:openssl"],
)
sign_in.cc と sign_in.h 内で、//external:openssl によって公開されるヘッダー ファイルは、リポジトリのルートからの相対パスを使用して参照できます。たとえば、@my-ssl//src:openssl-lib のルール定義が次のようになるとします。
使用します。
cc_library(
name = "openssl-lib",
srcs = ["openssl.cc"],
hdrs = ["openssl.h"],
)
sign_in.cc のインクルードは次のようになります。
#include "sign_in.h" #include "src/openssl.h"
引数
| 属性 | |
|---|---|
name |
名前:必須 このターゲットの名前。 |
actual
|
ラベル（デフォルトは このターゲットは存在する必要がありますが、任意のタイプのルール（bind を含む）にできます。 この属性を省略すると、 |
local_repository
ルールのソースを表示local_repository(name, path, repo_mapping)
ローカル ディレクトリのターゲットをバインドできます。つまり、現在のリポジトリは、この他のディレクトリで定義されたターゲットを使用できます。バインドをご覧ください。 セクションをご覧ください。
例
現在のリポジトリがチャット クライアントで、ルート権限が ~/chat-app ディレクトリであるとします。これは、
別のリポジトリ（~/ssl）で定義されている SSL ライブラリを使用したい場合、SSL ライブラリにターゲット //src:openssl-lib があります。
ユーザーは、~/chat-app/WORKSPACE に次の行を追加することで、このターゲットへの依存関係を追加できます。
local_repository(
name = "my-ssl",
path = "/home/user/ssl",
)
ターゲットは、これに依存する依存関係として @my-ssl//src:openssl-lib を指定します。
ライブラリです。
引数
| 属性 | |
|---|---|
name |
名前:必須 このターゲットの一意の名前。 |
path
|
String;必須 ローカル リポジトリのディレクトリのパス。これは、リポジトリの WORKSPACE ファイルを含むディレクトリへのパスにする必要があります。パスは、メイン リポジトリの WORKSPACE ファイルに対する絶対パスまたは相対パスにできます。 |
repo_mapping
|
辞書: 文字列 ->String;デフォルトは たとえば、エントリ |
new_local_repository
ルールソースを表示new_local_repository(name, build_file, build_file_content, path, repo_mapping, workspace_file, workspace_file_content)
ローカル ディレクトリを Bazel リポジトリに変換できます。つまり、現在の ファイル システム上のどこからでもターゲットを定義して使用できます。
このルールでは、以下を含む WORKSPACE ファイルとサブディレクトリを作成し、Bazel リポジトリを作成します。
指定されたビルド ファイルとパスへのシンボリック リンク。ビルドファイルは、path を基準にしてターゲットを作成する必要があります。すでに WORKSPACE ファイルと BUILD ファイルが含まれているディレクトリの場合、
local_repository ルールを使用できます。
例
現在のリポジトリがチャット クライアントで、ルート権限が ~/chat-app ディレクトリであるとします。これは、 別のディレクトリ ~/ssl で定義されている SSL ライブラリを使用したい場合、
ユーザーは、SSL ライブラリの BUILD ファイルを作成することで、依存関係を追加できます。 （~/chat-app/BUILD.my-ssl）に以下を含む:
java_library(
name = "openssl",
srcs = glob(['*.java'])
visibility = ["//visibility:public"],
)
次に、~/chat-app/WORKSPACE に次の行を追加します。
new_local_repository(
name = "my-ssl",
path = "/home/user/ssl",
build_file = "BUILD.my-ssl",
)
これにより、/home/user/ssl にシンボリック リンクする @my-ssl リポジトリが作成されます。ターゲットは、ターゲットの依存関係に @my-ssl//:openssl を追加することで、このライブラリに依存できます。
new_local_repository を使用して、ディレクトリだけでなく単一のファイルを含めることもできます。たとえば、/home/username/Downloads/piano.jar に jar ファイルがあるとします。WORKSPACE ファイルに次のように追加すると、そのファイルのみをビルドに追加できます。
new_local_repository(
name = "piano",
path = "/home/username/Downloads/piano.jar",
build_file = "BUILD.piano",
)
次の BUILD.piano ファイルを作成します。
java_import(
name = "play-music",
jars = ["piano.jar"],
visibility = ["//visibility:public"],
)
ターゲットは @piano//:play-music に依存して piano.jar を使用できます。
引数
| 属性 | |
|---|---|
name |
名前:必須 このターゲットの名前。 |
build_file
|
名前。デフォルトは build_file または build_file_content を指定する必要があります。 この属性は、メイン ワークスペースに対する相対的なラベルです。このファイルは必ずしも BUILD という名前ですが、その名前にすることもできます。（リポジトリの実際の BUILD ファイルと区別するために、BUILD.new-repo-name などの名前を付けるとよいでしょう）。 |
build_file_content
|
文字列。デフォルトは build_file または build_file_content を指定する必要があります。 |
path
|
文字列（必須） ローカル ファイル システム上のパス。メイン リポジトリの WORKSPACE ファイルに対する絶対パスまたは相対パスにすることができます。 |
repo_mapping
|
辞書: 文字列 ->String;デフォルトは たとえば、エントリ |
workspace_file
|
名前:デフォルトは workspace_file または workspace_file_content のいずれかを指定できます。両方は指定できません。 この属性は、メイン ワークスペースに対する相対的なラベルです。このファイルは必ずしも WORKSPACE としていますが、その可能性もあります。（たとえば WORKSPACE.new-repo-name が、 リポジトリの実際の WORKSPACE ファイルと区別する必要があります）。 |
workspace_file_content
|
String;デフォルトは workspace_file または workspace_file_content のいずれかを指定できます。両方は指定できません。 |