从 Maven 迁移到 Bazel

报告问题查看来源每晚 · 7.2。 · 7.1敬上 · 7.0 · 6.5 条 · 6.4。

本页面介绍了如何从 Maven 迁移到 Bazel，包括前提条件和安装步骤它介绍了并提供了使用 Guava 项目。

从任何构建工具迁移到 Bazel 时，最好同时进行同时运行的多个工具，直到您完全迁移开发团队， CI 系统以及任何其他相关系统。您可以在 Cloud Build 和 Container Registry 中相同的代码库

准备工作

安装 Bazel（如果尚未安装）。
如果您刚开始接触 Bazel，请学习本教程 Bazel 简介：构建 Java 准备工作迁移。本教程介绍了 Bazel 的概念、结构和标签语法。

Maven 与 Bazel 之间的区别

Maven 使用顶级 pom.xml 文件。Bazel 支持多个构建每个 BUILD 文件有多个目标，从而允许构建比 Maven 更具增量性。
Maven 负责部署过程的步骤。Bazel 的用途无法自动执行部署。
Bazel 使您能够表达语言之间的依赖关系。
向项目添加新部分时，您可能需要使用 Bazel BUILD 文件。最佳实践是在每个新的 Java 软件包中添加一个 BUILD 文件。

从 Maven 迁移到 Bazel

以下步骤说明了如何将项目迁移到 Bazel：

创建 WORKSPACE 文件
创建一个 build 文件
创建更多 BUILD 文件
使用 Bazel 构建

以下示例来自于迁移 Guava 项目（从 Maven 迁移到 Bazel）。使用的 Guava 项目的版本为 v31.1。使用 Guava 的示例并未介绍但迁移过程中会显示是为迁移手动添加或添加的

$ git clone https://github.com/google/guava.git && cd guava
$ git checkout v31.1

1. 创建 WORKSPACE 文件

在项目的根目录下创建一个名为 WORKSPACE 的文件。如果您的项目无外部依赖项，则工作区文件可以为空。

如果您的项目依赖的文件或软件包不在上述任何一项之列，项目的目录中，请在工作区中指定这些外部依赖项文件。如需自动列出工作区文件的外部依赖项，请执行以下操作：请使用 rules_jvm_external。有关使用此规则集的说明，请参阅自述文件。

Guava 项目示例：外部依赖项

你可以列出 Guava 项目，其中包含 rules_jvm_external 规则集。

将以下代码段添加到 WORKSPACE 文件中：

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")

RULES_JVM_EXTERNAL_TAG = "4.3"
RULES_JVM_EXTERNAL_SHA = "6274687f6fc5783b589f56a2f1ed60de3ce1f99bc4e8f9edef3de43bdf7c6e74"

http_archive(
    name = "rules_jvm_external",
    sha256 = RULES_JVM_EXTERNAL_SHA,
    strip_prefix = "rules_jvm_external-%s" % RULES_JVM_EXTERNAL_TAG,
    url = "https://github.com/bazelbuild/rules_jvm_external/archive/%s.zip" % RULES_JVM_EXTERNAL_TAG,
)

load("@rules_jvm_external//:defs.bzl", "maven_install")

maven_install(
    artifacts = [
        "com.google.code.findbugs:jsr305:3.0.2",
        "com.google.errorprone:error_prone_annotations:2.11.0",
        "com.google.j2objc:j2objc-annotations:1.3",
        "org.codehaus.mojo:animal-sniffer-annotations:1.20",
        "org.checkerframework:checker-qual:3.12.0",
    ],
    repositories = [
        "https://repo1.maven.org/maven2",
    ],
)

2. 创建一个 BUILD 文件

现在，您已经定义了工作区和外部依赖项（如果适用）列出，您需要创建 BUILD 文件来描述您的项目。与具有一个 pom.xml 文件的 Maven 不同，Bazel 可以使用多个 BUILD 文件，用于构建项目。这些文件会指定多个构建目标可让 Bazel 生成增量构建

分阶段添加 BUILD 文件。首先添加一个 BUILD 文件进入项目根目录，然后通过 Bazel 进行初始构建。然后，您可以通过添加更多更精细的 BUILD 文件来优化 build 目标。

在 WORKSPACE 文件所在的目录中，创建一个文本文件并请将其命名为 BUILD。
在此 BUILD 文件中，使用适当的规则创建一个目标，构建项目。请参考以下提示：
- 使用适当的规则：
  - 要使用单个 Maven 模块构建项目，请使用 java_library 规则，如下所示：
```
java_library(
    name = "everything",
    srcs = glob(["src/main/java/**/*.java"]),
    resources = glob(["src/main/resources/**"]),
    deps = ["//:all-external-targets"],
)
```
  - 要构建包含多个 Maven 模块的项目，请使用 java_library 规则，如下所示：
```
java_library(
    name = "everything",
    srcs = glob([
        "Module1/src/main/java/**/*.java",
        "Module2/src/main/java/**/*.java",
        ...
    ]),
    resources = glob([
        "Module1/src/main/resources/**",
        "Module2/src/main/resources/**",
        ...
    ]),
    deps = ["//:all-external-targets"],
)
```
  - 如需构建二进制文件，请使用 java_binary 规则：
```
java_binary(
    name = "everything",
    srcs = glob(["src/main/java/**/*.java"]),
    resources = glob(["src/main/resources/**"]),
    deps = ["//:all-external-targets"],
    main_class = "com.example.Main"
)
```
- 指定属性：
  - name：为目标指定一个含义明确的名称。在上面的示例中，那么这个目标就是“一切”
  - srcs：使用 globbing 列出项目中的所有 .java 文件。
  - resources：使用 globbing 列出项目中的所有资源。
  - deps：您需要确定项目需求。例如，如果您生成了一个外部清单使用 generate_workspace 工具指定依赖项，则依赖项是java_library generated_java_libraries 宏。
- 请参阅此顶级 BUILD 文件的以下示例： Guava 项目的迁移过程。
现在，项目的根目录下有了 BUILD 文件，请构建确保其有效在命令行上，从工作区目录中，请使用 bazel build //:everything 构建项目。

项目现已使用 Bazel 成功构建。您需要添加更多 BUILD 文件，以允许对项目进行增量构建。

Guava 项目示例：从一个 BUILD 文件开始

将 Guava 项目迁移到 Bazel 时，最初会使用一个 BUILD 文件来构建整个项目下面是这个初始 BUILD 的内容文件：

java_library(
    name = "everything",
    srcs = glob([
        "guava/src/**/*.java",
        "futures/failureaccess/src/**/*.java",
    ]),
    deps = [
        "@maven//:com_google_code_findbugs_jsr305",
        "@maven//:com_google_errorprone_error_prone_annotations",
        "@maven//:com_google_j2objc_j2objc_annotations",
        "@maven//:org_checkerframework_checker_qual",
        "@maven//:org_codehaus_mojo_animal_sniffer_annotations",
    ],
)

3. 创建更多 BUILD 文件（可选）

正如您在完成第一次请求后看到的那样，Bazel 只需要一个 BUILD file build。您仍应考虑将 build 拆分为多个较小的区块，方法是添加更多具有精细目标的 BUILD 文件。

包含多个目标的多个 BUILD 文件会使 build 增大支持：

增加了项目的增量构建，
可增加构建的并行执行
为未来用户提供更好的 build 可维护性，以及
可以控制软件包之间目标的可见性，例如包含实现详情泄露到公共 API。

有关添加更多 BUILD 文件的提示：

首先，将 BUILD 文件添加到每个 Java 软件包。起始内容依赖项最少的 Java 软件包，逐步扩展依赖项最多的软件包
在添加 BUILD 文件并指定目标时，将这些新目标添加到依赖于它们的目标的 deps 个部分。请注意，glob() 函数不会跨越软件包边界，因此的软件包使与 glob() 匹配的文件变小。
每次将 BUILD 文件添加到 main 目录时，请确保将将 BUILD 文件复制到相应的 test 目录。
请注意适当限制软件包之间的可见性。
为了简化对 BUILD 文件设置中的错误进行问题排查，请确保项目将在您添加每个 build 时继续使用 Bazel 进行构建文件。运行 bazel build //... 以确保所有目标仍会构建。

4. 使用 Bazel 构建

您一直在使用 Bazel 进行构建，同时添加了 BUILD 文件以验证设置。

获得所需的 BUILD 文件后，您可以使用 Bazel 生成所有 build