추가 작업 규칙

규칙

action_listener

action_listener(name, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, extra_actions, features, licenses, mnemonics, restricted_to, tags, target_compatible_with, testonly, visibility)

경고: 추가 작업은 지원 중단되었습니다. 사용 측면에서 하세요.

action_listener 규칙은 자체적으로 출력을 생성하지 않습니다. 대신 도구 개발자가 extra_action를 빌드 시스템에 삽입합니다. 작업에서 extra_action에 매핑을 제공하여 에 대해 자세히 알아보세요.

이 규칙의 인수는 작업 니모닉을 extra_action 규칙

--experimental_action_listener=<label>, 빌드는 지정된 action_listener를 사용하여 extra_action를 빌드 그래프에 추가합니다.

action_listener(
    name = "index_all_languages",
    mnemonics = [
        "Javac",
        "CppCompile",
        "Python",
    ],
    extra_actions = [":indexer"],
)

action_listener(
    name = "index_java",
    mnemonics = ["Javac"],
    extra_actions = [":indexer"],
)

extra_action(
    name = "indexer",
    tools = ["//my/tools:indexer"],
    cmd = "$(location //my/tools:indexer)" +
          "--extra_action_file=$(EXTRA_ACTION_FILE)",
)

인수

속성
name

Name; required

이 대상의 고유한 이름입니다.

extra_actions

List of labels; required

extra_action 타겟 목록 이 action_listener가 빌드 그래프에 추가되어야 합니다. 예: [ "//my/tools:analyzer" ]
mnemonics

List of strings; required

action_listener가 수신해야 하는 작업 니모닉의 목록 대상(예: [ "Javac" ]

니모닉은 공개 인터페이스가 아닙니다. 니모닉과 관련 작업이 변경되지 않는다는 보장은 없습니다.

extra_action

extra_action(name, data, cmd, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, licenses, out_templates, requires_action_output, restricted_to, tags, target_compatible_with, testonly, toolchains, tools, visibility)

경고: 추가 작업은 지원 중단되었습니다. 사용 측면에서 하세요.

extra_action 규칙은 의미 있는 출력을 생성하지 않음 일반 빌드 대상으로 지정된 경우 대신 도구 개발자가 기존 작업을 섀도잉하는 추가 작업을 빌드 그래프에 삽입합니다.

자세한 내용은 action_listener를 참고하세요. extra_action 사용 설정 방법을 참고하세요.

extra_action는 명령줄로 실행됩니다. 명령줄 도구는 $(EXTRA_ACTION_FILE) 형식으로 프로토콜 버퍼가 포함된 파일에 대한 액세스 섀도잉 중인 원본 액션에 대한 자세한 정보를 제공합니다. 또한 원래 작업에서 액세스할 수 있는 모든 입력 파일에 액세스할 수 있습니다. extra_actions_base.proto를 참조하세요. 를 참조하세요. 각 proto 파일 ExtraActionInfo 메시지를 포함합니다.

다른 모든 작업과 마찬가지로 추가 작업은 샌드박스 처리되며 이를 처리하도록 설계해야 합니다.

인수

속성
name

Name; required

이 대상의 고유한 이름입니다.

extra_actions 인수에서 label로 이 규칙을 참조할 수 있습니다. 총 action_listener개의 규칙이 있습니다.
cmd

String; required

실행할 명령어입니다.

다음과 같은 genrule cmd 속성과 같음 차이점:

  1. 휴리스틱 라벨 확장이 없습니다. $(location ...)를 사용하는 라벨만 확장됩니다.

  2. 문자열에 추가 패스가 적용되어 out_templates에서 생성된 출력 어커런스 속성의 값을 제공합니다. 일치하는 모든 $(output out_template) label로 표시된 파일의 경로로 대체됩니다.

    예: out_template $(ACTION_ID).analysis $(output $(ACTION_ID).analysis)와 일치할 수 있습니다.

    실제로 $(location)와 동일한 대체 항목입니다. 범위가 다릅니다

out_templates

List of strings; optional

extra_action 명령어로 생성되는 파일의 템플릿 목록입니다.

템플릿은 다음 변수를 사용할 수 있습니다.

  • $(ACTION_ID): 이 extra_action를 고유하게 식별하는 ID입니다. 고유한 출력 파일을 생성하는 데 사용됩니다.

requires_action_output

Boolean; optional; default is False

extra_action에 다음 항목의 출력이 필요함을 나타냅니다. 원래 작업을 이 extra_action에 대한 입력으로 표시합니다.

true (기본값 false)인 경우 extra_action은 입력의 일부로 사용할 수 있습니다.

tools

List of labels; optional

이 규칙의 종속 항목 tool개 목록입니다.

자세한 내용은 종속 항목 정의를 참고하세요. 확인할 수 있습니다

빌드 시스템은 extra_action 명령어 컨테이너는 host 구성, 빌드 자체에서 도구로 실행되어야 하기 때문입니다. 개인의 경로 tools 타겟 //x:y는 다음을 사용하여 얻을 수 있습니다. $(location //x:y)입니다.

모든 도구와 데이터 종속 항목이 단일 트리로 통합됨 해당 명령어는 상대 경로를 사용할 수 있습니다. 작업 디렉터리는 해당 통합 트리의 루트가 됩니다.