작업공간 규칙은 일반적으로 외부 종속 항목을 가져오는 데 사용됩니다. 기본 저장소 외부에 있습니다.
참고: Bazel은 기본 작업공간 규칙 외에도 다양한 Starlark 작업공간 규칙(특히 처리할 규칙) Git 저장소나 웹에 호스팅된 보관 파일을 사용하는 것이 좋습니다
규칙
바인드
규칙 소스 보기bind(name, actual, compatible_with, deprecation, distribs, features, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)
경고: bind() 사용은 권장하지 않습니다. '바인드 삭제 고려'를 참조하세요. 오랫동안
문제와 대안에 대해 논의합니다 특히
repo_mapping
저장소 속성
경고: select()는 bind()에서 사용할 수 없습니다. 구성 가능한 속성 FAQ에서
자세히 알아보세요.
//external 패키지의 타겟에 별칭을 제공합니다.
//external 패키지는 '일반' 패키지가 아닙니다. package: external/ 디렉터리가 없습니다.
'가상 패키지'라고 생각하면 됩니다. 모든 바인딩 대상을 포함하는 ViewModel입니다.
예
대상에 별칭을 지정하려면 WORKSPACE 파일에서 bind합니다. 예를 들어
라는 java_library 타겟이 있다고 가정하겠습니다.
//third_party/javacc-v2입니다. 다음을 추가하여 별칭을 지정할 수 있습니다.
WORKSPACE 파일:
bind(
name = "javacc-latest",
actual = "//third_party/javacc-v2",
)
이제 대상이 대신 //external:javacc-latest에 종속될 수 있습니다.
//third_party/javacc-v2입니다. javacc-v3이 릴리스되는 경우 bind 규칙은 다음과 같을 수 있습니다.
업데이트되고 //external:javacc-latest에 종속된 모든 BUILD 파일이 이제
javacc-v3에 종속된다는 것을 의미합니다.
Bind를 사용하면 외부 저장소의 대상을 작업공간에서 사용할 수 있습니다.
예를 들어 @my-ssl이라는 원격 저장소가
WORKSPACE 파일에 있고 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는 다음과 같을 수 있습니다.
#include "sign_in.h" #include "src/openssl.h"
인수
| 속성 | |
|---|---|
name |
이름 필수 이 대상의 고유한 이름입니다. |
actual
|
라벨 기본값은 이 대상은 반드시 있어야 하지만 바인드를 비롯한 모든 유형의 규칙일 수 있습니다. 이 속성이 생략되면 |
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 저장소를 만듭니다.
BUILD 파일 및 경로에 대한 심볼릭 링크를 생성합니다. 빌드 파일은 빌드 대상
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.new-repo-name이 적합할 수 있음) 저장소의 실제 BUILD 파일과 구별하기) |
build_file_content
|
String; 기본값은 build_file 또는 build_file_content를 지정해야 합니다. |
path
|
String; 필수 로컬 파일 시스템의 경로입니다.절대적 또는 기본 저장소의 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 중 하나를 지정할 수 있지만 둘 다 지정할 수는 없습니다. |