Bazel 튜토리얼: C++ 도구 모음 구성

<ph type="x-smartling-placeholder"></ph> 문제 신고 <ph type="x-smartling-placeholder"></ph> 소스 보기 1박 · 7.3 · 7.2 · 7.1 · 7.0 · 6.5

이 가이드에서는 예시 시나리오를 사용하여 C++를 구성하는 방법을 설명합니다. 도구 모음을 제공합니다

학습할 내용

이 튜토리얼에서는 다음 방법을 알아봅니다.

  • 빌드 환경 설정
  • --toolchain_resolution_debug를 사용하여 도구 모음 해상도 디버그
  • C++ 도구 모음 구성
  • 에 대한 추가 구성을 제공하는 Starlark 규칙을 만듭니다. Bazel이 clang로 애플리케이션을 빌드할 수 있도록 cc_toolchain
  • 다음에서 bazel build //main:hello-world를 실행하여 C++ 바이너리를 빌드합니다. Linux 머신
  • bazel build //main:hello-world --platforms=//:android_x86_64를 실행하여 Android용 바이너리를 크로스 컴파일합니다.

시작하기 전에

이 튜토리얼에서는 Linux를 사용하고 C++를 성공적으로 빌드했다고 가정합니다. 적절한 도구와 라이브러리를 설치했습니다. 튜토리얼 는 시스템에 설치할 수 있는 clang version 16를 사용합니다.

빌드 환경 설정

빌드 환경을 다음과 같이 설정합니다.

  1. 아직 Bazel을 설치하지 않았다면 다운로드하여 설치합니다. 7.0.2 이상

  2. 루트 폴더에 빈 MODULE.bazel 파일을 추가합니다.

  3. main/BUILD 파일에 다음 cc_binary 대상을 추가합니다.

    cc_binary(
        name = "hello-world",
        srcs = ["hello-world.cc"],
    )
    

    Bazel은 빌드 중에 C++로 작성된 많은 내부 도구를 사용하기 때문에 process-wrapper로 설정된 경우 기존 기본 C++ 도구 모음이 지정됩니다. 사용할 수 있습니다 이렇게 하면 이러한 내부 도구들이 이 튜토리얼에서 만든 도구 모음의 툴체인입니다. 따라서 cc_binary 타겟은 기본 도구 모음으로 빌드됩니다.

  4. 다음 명령어를 사용하여 빌드를 실행합니다.

    bazel build //main:hello-world
    

    MODULE.bazel에 도구 모음이 등록되지 않아도 빌드가 성공합니다.

    자세히 알아보려면 다음을 실행하세요.

    bazel build //main:hello-world --toolchain_resolution_debug='@bazel_tools//tools/cpp:toolchain_type'
    
    INFO: ToolchainResolution: Target platform @@platforms//host:host: Selected execution platform @@platforms//host:host, type @@bazel_tools//tools/cpp:toolchain_type -> toolchain @@bazel_tools+cc_configure_extension+local_config_cc//:cc-compiler-k8
    

    --platforms를 지정하지 않으면 Bazel이 @platforms//host 사용 @bazel_tools+cc_configure_extension+local_config_cc//:cc-compiler-k8입니다.

C++ 도구 모음 구성

C++ 도구 모음을 구성하려면 먼저 애플리케이션을 반복적으로 빌드하고 하나씩 살펴보겠습니다.

또한 clang version 9.0.1로 가정되지만 세부정보는 변경될 수 있습니다. 서로 다른 버전의 clang에서 약간 다를 수 있습니다.

  1. 다음으로 toolchain/BUILD 추가:

    filegroup(name = "empty")
    
    cc_toolchain(
        name = "linux_x86_64_toolchain",
        toolchain_identifier = "linux_x86_64-toolchain",
        toolchain_config = ":linux_x86_64_toolchain_config",
        all_files = ":empty",
        compiler_files = ":empty",
        dwp_files = ":empty",
        linker_files = ":empty",
        objcopy_files = ":empty",
        strip_files = ":empty",
        supports_param_files = 0,
    )
    
    toolchain(
        name = "cc_toolchain_for_linux_x86_64",
        toolchain = ":linux_x86_64_toolchain",
        toolchain_type = "@bazel_tools//tools/cpp:toolchain_type",
        exec_compatible_with = [
            "@platforms//cpu:x86_64",
            "@platforms//os:linux",
        ],
        target_compatible_with = [
            "@platforms//cpu:x86_64",
            "@platforms//os:linux",
        ],
    )
    

    그런 다음 적절한 종속 항목을 추가하고 다음 명령어로 도구 모음을 등록합니다. MODULE.bazel,

    bazel_dep(name = "platforms", version = "0.0.10")
    register_toolchains(
        "//toolchain:cc_toolchain_for_linux_x86_64"
    )
    

    이 단계에서는 cc_toolchain를 정의하고 다음을 위한 toolchain 타겟에 바인딩합니다. 호스트 구성을 변경해야 합니다

  2. 빌드를 다시 실행합니다. toolchain 패키지는 아직 linux_x86_64_toolchain_config 타겟이면 Bazel에서 다음 오류가 발생합니다.

    ERROR: toolchain/BUILD:4:13: in toolchain_config attribute of cc_toolchain rule //toolchain:linux_x86_64_toolchain: rule '//toolchain:linux_x86_64_toolchain_config' does not exist.
    
  3. toolchain/BUILD 파일에서 다음과 같이 빈 파일 그룹을 정의합니다.

    package(default_visibility = ["//visibility:public"])
    
    filegroup(name = "linux_x86_64_toolchain_config")
    
  4. 빌드를 다시 실행합니다. Bazel에서 다음 오류가 발생합니다.

    '//toolchain:linux_x86_64_toolchain_config' does not have mandatory providers: 'CcToolchainConfigInfo'.
    

    CcToolchainConfigInfo는 C++를 구성하는 데 사용하는 제공자입니다. 있습니다. 이 오류를 수정하려면 다음 명령어로 Bazel에 CcToolchainConfigInfo toolchain/cc_toolchain_config.bzl 파일을 포함합니다.

    def _impl(ctx):
        return cc_common.create_cc_toolchain_config_info(
            ctx = ctx,
            toolchain_identifier = "k8-toolchain",
            host_system_name = "local",
            target_system_name = "local",
            target_cpu = "k8",
            target_libc = "unknown",
            compiler = "clang",
            abi_version = "unknown",
            abi_libc_version = "unknown",
        )
    
    cc_toolchain_config = rule(
        implementation = _impl,
        attrs = {},
        provides = [CcToolchainConfigInfo],
    )
    

    cc_common.create_cc_toolchain_config_info()는 필요한 제공자 생성 CcToolchainConfigInfo cc_toolchain_config 규칙을 사용하려면 로드를 추가하세요. 문을 패키지 문 바로 아래에 있는 toolchain/BUILD에 추가합니다.

    load(":cc_toolchain_config.bzl", "cc_toolchain_config")
    

    그런 다음 'linux_x86_64_tooltip_config'를 바꿉니다. 선언이 포함된 파일 그룹 cc_toolchain_config 규칙의 정의:

    cc_toolchain_config(name = "linux_x86_64_toolchain_config")
    
  5. 빌드를 다시 실행합니다. Bazel에서 다음 오류가 발생합니다.

    .../BUILD:1:1: C++ compilation of rule '//:hello-world' failed (Exit 1)
    src/main/tools/linux-sandbox-pid1.cc:421:
    "execvp(toolchain/DUMMY_GCC_TOOL, 0x11f20e0)": No such file or directory
    Target //:hello-world failed to build`
    

    이 시점에서 Bazel은 코드 빌드를 시도하기에 충분한 정보를 가지고 있지만 필요한 빌드를 완료하는 데 어떤 도구를 사용해야 하는지 아직 모릅니다. 있습니다. Starlark 규칙 구현을 수정하여 Bazel에게 무엇을 알리겠습니다. 사용할 수 있습니다. 이를 위해서는 tool_path() 생성자가 필요합니다. @bazel_tools//tools/cpp:cc_toolchain_config_lib.bzl:

    # toolchain/cc_toolchain_config.bzl:
    # NEW
    load("@bazel_tools//tools/cpp:cc_toolchain_config_lib.bzl", "tool_path")
    
    def _impl(ctx):
        tool_paths = [ # NEW
            tool_path(
                name = "gcc",
                path = "/usr/bin/clang",
            ),
            tool_path(
                name = "ld",
                path = "/usr/bin/ld",
            ),
            tool_path(
                name = "ar",
                path = "/usr/bin/ar",
            ),
            tool_path(
                name = "cpp",
                path = "/bin/false",
            ),
            tool_path(
                name = "gcov",
                path = "/bin/false",
            ),
            tool_path(
                name = "nm",
                path = "/bin/false",
            ),
            tool_path(
                name = "objdump",
                path = "/bin/false",
            ),
            tool_path(
                name = "strip",
                path = "/bin/false",
            ),
        ]
    
        return cc_common.create_cc_toolchain_config_info(
            ctx = ctx,
            toolchain_identifier = "local",
            host_system_name = "local",
            target_system_name = "local",
            target_cpu = "k8",
            target_libc = "unknown",
            compiler = "clang",
            abi_version = "unknown",
            abi_libc_version = "unknown",
            tool_paths = tool_paths, # NEW
        )
    

    /usr/bin/clang/usr/bin/ld이 다음에 대한 올바른 경로인지 확인합니다. 있습니다.

  6. 빌드를 다시 실행합니다. Bazel에서 다음 오류가 발생합니다.

    ERROR: main/BUILD:3:10: Compiling main/hello-world.cc failed: absolute path inclusion(s) found in rule '//main:hello-world':
    the source file 'main/hello-world.cc' includes the following non-builtin files with absolute paths (if these are builtin files, make sure these paths are in your toolchain):
      '/usr/include/c++/13/ctime'
      '/usr/include/x86_64-linux-gnu/c++/13/bits/c++config.h'
      '/usr/include/x86_64-linux-gnu/c++/13/bits/os_defines.h'
      ...
    

    Bazel은 포함된 헤더를 검색할 위치를 알아야 합니다. 이 디렉터리는 cc_binaryincludes 속성을 사용하는 등 이 문제를 해결하는 방법 여기서는 툴체인 수준에서 cxx_builtin_include_directories cc_common.create_cc_toolchain_config_info의 매개변수입니다. 주의할 점은 다른 버전의 clang를 사용하는 경우 포함 경로는 다릅니다. 이러한 경로는 분포에 따라 다를 수도 있습니다.

    toolchain/cc_toolchain_config.bzl의 반환 값을 다음과 같이 수정합니다. 다음과 같습니다.

    return cc_common.create_cc_toolchain_config_info(
        ctx = ctx,
        cxx_builtin_include_directories = [ # NEW
            "/usr/lib/llvm-16/lib/clang/16/include",
            "/usr/include",
        ],
        toolchain_identifier = "local",
        host_system_name = "local",
        target_system_name = "local",
        target_cpu = "k8",
        target_libc = "unknown",
        compiler = "clang",
        abi_version = "unknown",
        abi_libc_version = "unknown",
        tool_paths = tool_paths,
    )
    
  7. 빌드 명령어를 다시 실행하면 다음과 같은 오류가 표시됩니다.

    /usr/bin/ld: bazel-out/k8-fastbuild/bin/main/_objs/hello-world/hello-world.o: in function `print_localtime()':
    hello-world.cc:(.text+0x68): undefined reference to `std::cout'
    

    링커에 C++ 표준이 누락되었기 때문입니다. 기호를 찾을 수 없습니다. 이 문제를 해결하는 방법에는 여러 가지가 있지만 (예: cc_binarylinkopts 속성 사용) 여기서는 툴체인을 사용하는 모든 대상이 이 값을 지정할 필요가 플래그.

    다음 코드를 toolchain/cc_toolchain_config.bzl에 복사합니다.

    # NEW
    load("@bazel_tools//tools/build_defs/cc:action_names.bzl", "ACTION_NAMES")
    # NEW
    load(
        "@bazel_tools//tools/cpp:cc_toolchain_config_lib.bzl",
        "feature",    # NEW
        "flag_group", # NEW
        "flag_set",   # NEW
        "tool_path",
    )
    
    all_link_actions = [ # NEW
        ACTION_NAMES.cpp_link_executable,
        ACTION_NAMES.cpp_link_dynamic_library,
        ACTION_NAMES.cpp_link_nodeps_dynamic_library,
    ]
    
    def _impl(ctx):
        tool_paths = [
            tool_path(
                name = "gcc",
                path = "/usr/bin/clang",
            ),
            tool_path(
                name = "ld",
                path = "/usr/bin/ld",
            ),
            tool_path(
                name = "ar",
                path = "/bin/false",
            ),
            tool_path(
                name = "cpp",
                path = "/bin/false",
            ),
            tool_path(
                name = "gcov",
                path = "/bin/false",
            ),
            tool_path(
                name = "nm",
                path = "/bin/false",
            ),
            tool_path(
                name = "objdump",
                path = "/bin/false",
            ),
            tool_path(
                name = "strip",
                path = "/bin/false",
            ),
        ]
    
        features = [ # NEW
            feature(
                name = "default_linker_flags",
                enabled = True,
                flag_sets = [
                    flag_set(
                        actions = all_link_actions,
                        flag_groups = ([
                            flag_group(
                                flags = [
                                    "-lstdc++",
                                ],
                            ),
                        ]),
                    ),
                ],
            ),
        ]
    
        return cc_common.create_cc_toolchain_config_info(
            ctx = ctx,
            features = features, # NEW
            cxx_builtin_include_directories = [
                "/usr/lib/llvm-9/lib/clang/9.0.1/include",
                "/usr/include",
            ],
            toolchain_identifier = "local",
            host_system_name = "local",
            target_system_name = "local",
            target_cpu = "k8",
            target_libc = "unknown",
            compiler = "clang",
            abi_version = "unknown",
            abi_libc_version = "unknown",
            tool_paths = tool_paths,
        )
    
    cc_toolchain_config = rule(
        implementation = _impl,
        attrs = {},
        provides = [CcToolchainConfigInfo],
    )
    
  8. bazel build //main:hello-world를 실행하면 최종적으로 바이너리를 빌드해야 합니다. 성공적으로 배포되어야 합니다.

  9. toolchain/BUILD에서 cc_toolchain_config, cc_toolchain, 타겟 toolchain개 및 linux_x86_64android_x86_64로 대체 대상 이름이 포함됩니다

    MODULE.bazel에서 Android용 도구 모음을 등록합니다.

    register_toolchains(
        "//toolchain:cc_toolchain_for_linux_x86_64",
        "//toolchain:cc_toolchain_for_android_x86_64"
    )
    
  10. bazel build //main:hello-world --android_platforms=//toolchain:android_x86_64를 실행하여 다음 항목의 바이너리를 빌드합니다. Android

실제로 Linux와 Android에는 서로 다른 C++ 도구 모음 구성이 있어야 합니다. 나 차이점의 기존 cc_toolchain_config를 수정하거나 별도의 규칙을 만들기 위해 (예: CcToolchainConfigInfo 제공업체) 지원합니다

작업 검토

이 튜토리얼에서는 기본 C++ 도구 모음을 구성하는 방법을 배웠지만 도구 모음이 이 예시보다 더 강력합니다.

핵심 내용은 다음과 같습니다.

  • 다음과 같이 명령줄에서 일치하는 platforms 플래그를 지정해야 합니다. Bazel이 동일한 제약 조건 값에 대해 도구 모음으로 있습니다. 문서에는 언어별 에 대한 자세한 정보가 포함되어 있으며 구성 플래그를 참조하세요.
  • 도구의 위치를 도구 모음에 알려야 합니다. 이 튜토리얼의 내용 시스템에서 도구에 액세스하는 단순화된 버전이 있습니다. 만약 독립 실행형 접근방식에 관심이 있다면 외부 종속 항목. 도구는 다양한 소스에서 다른 모듈에서 해당 파일을 사용할 수 있도록 해야 했습니다. 속성에 대한 타겟 종속 항목이 있는 cc_toolchain compiler_files tool_paths도 변경해야 합니다.
  • 특성을 만들어 어떤 플래그를 연결 또는 다른 유형의 액션일 수 있습니다.

추가 자료

자세한 내용은 C++ 도구 모음 구성