원주민/토착민

네이티브 규칙 및 기타 패키지 도우미 함수를 지원하는 기본 제공 모듈입니다. 모든 네이티브 규칙은 이 모듈에 함수(예: native.cc_library)로 표시됩니다. 네이티브 모듈은 로드 단계에서만 사용할 수 있습니다 (예: 규칙 구현이 아닌 매크로의 경우). 속성은 None 값을 무시하고 속성이 설정되지 않은 것처럼 취급합니다.
다음 함수도 사용할 수 있습니다.

회원

• existing_rule
• existing_rules
• exports_files
• glob
• module_name
• module_version
• package_group
• package_name
• package_relative_label
• repository_name
• subpackages

existing_rule

unknown native.existing_rule(name)

여기에서 변경 불가능한 dict 같은 객체는 dict와 같은 반복(len(x), name in x, x[name], x.get(name), x.items(), x.keys(), x.values())을 지원하는 완전히 변경할 수 없는 객체 x를 의미합니다.

--noincompatible_existing_rules_immutable_view 플래그가 설정된 경우 동일한 콘텐츠가 포함된 변경 가능한 새 사전을 반환합니다.

결과에는 비공개 속성(이름이 문자로 시작하지 않음)과 표현할 수 없는 일부 기존 속성 유형을 제외한 각 속성에 대한 항목이 포함됩니다. 또한 사전에는 규칙 인스턴스의 name 및 kind에 대한 항목이 포함됩니다 (예: 'cc_binary').

결과 값은 다음과 같이 속성 값을 나타냅니다.

• str, int, bool 유형의 속성은 있는 그대로 표시됩니다.
• 라벨은 동일한 패키지의 타겟의 경우 ':foo' 형식의 문자열로, 다른 패키지의 타겟의 경우 '//pkg:name' 형식의 문자열로 변환됩니다.
• 목록은 튜플로 표시되고 사전은 변경 가능한 새 사전으로 변환됩니다. 요소의 요소는 동일한 방식으로 재귀적으로 변환됩니다.
• select 값은 위에서 설명한 대로 변환된 콘텐츠와 함께 반환됩니다.
• 규칙을 인스턴스화하는 동안 지정된 값이 없고 기본값이 계산된 속성은 결과에서 제외됩니다. 계산된 기본값은 분석 단계까지 계산할 수 없습니다.

가능하면 이 함수를 사용하지 마세요. BUILD 파일이 불안정하고 순서에 의존하지 않게 됩니다. 또한 내부 형식에서 Starlark로의 규칙 속성 값 변환의 다른 두 가지 방법(계산된 기본값에서 사용되는 방법과 ctx.attr.foo에서 사용되는 방법)과는 미묘하게 다릅니다.

매개변수

existing_rules

unknown native.existing_rules()

여기에서 변경 불가능한 dict와 같은 객체는 dict와 같은 반복(len(x), name in x, x[name], x.get(name), x.items(), x.keys(), x.values())을 지원하는 완전히 변경할 수 없는 객체 x를 의미합니다.

--noincompatible_existing_rules_immutable_view 플래그가 설정된 경우에는 동일한 콘텐츠가 포함된 변경 가능한 새 dict를 대신 반환합니다.

참고: 가능하면 이 함수를 사용하지 마세요. BUILD 파일이 불안정하고 순서에 의존하지 않게 됩니다. 또한 --noincompatible_existing_rules_immutable_view 플래그가 설정된 경우 이 함수는 특히 루프 내에서 호출되는 경우 비용이 많이 들 수 있습니다.

exports_files

None native.exports_files(srcs, visibility=None, licenses=None)

매개변수

glob

sequence native.glob(include=[], exclude=[], exclude_directories=1, allow_empty=unbound)

• include의 패턴과 하나 이상 일치합니다.
• exclude(기본값 [])의 패턴과 일치하지 않습니다.

매개변수

module_name

string native.module_name()

module_version

string native.module_version()

package_group

None native.package_group(name, packages=[], includes=[])

매개변수

package_name

string native.package_name()

package_relative_label

Label native.package_relative_label(input)

이 함수는 BUILD 파일과 이 파일이 직접 또는 간접적으로 호출하는 매크로를 평가하는 동안에만 호출될 수 있습니다. 예를 들어 규칙 구현 함수에서는 호출되지 않을 수 있습니다.

이 함수의 결과는 BUILD 파일에서 선언된 대상의 라벨 값 속성에 지정된 문자열을 전달하여 생성되는 값과 동일합니다. Label

사용 메모: 이 함수와 Label()의 차이점은 Label()가 BUILD 파일의 패키지가 아닌 호출한 .bzl 파일의 패키지 컨텍스트를 사용한다는 점입니다. 컴파일러와 같이 매크로에 하드코딩된 고정된 타겟을 참조해야 하는 경우 Label()를 사용하세요. BUILD 파일에서 제공하는 라벨 문자열을 Label 객체로 정규화해야 하는 경우 package_relative_label()를 사용합니다. (BUILD 파일 또는 호출 .bzl 파일 외의 패키지 컨텍스트에서 문자열을 Label로 변환할 방법은 없습니다. 따라서 외부 매크로는 항상 라벨 문자열이 아닌 라벨 객체를 내부 매크로에 전달하는 것이 좋습니다.)

매개변수

repository_name

string native.repository_name()

하위 패키지

sequence native.subpackages(include, exclude=[], allow_empty=False)

매개변수