Bazel构建Scala项目实战指南：rules_scala

一、项目目录结构及介绍

rules_scala 是一个由 Bazel 支持的强大且功能丰富的Scala规则集，它使得在Bazel环境下构建Scala项目变得高效而灵活。下面是基于此项目的一般性目录结构示例及其组成部分说明：

基础目录结构

• WORKSPACE: 这是Bazel工作空间文件，定义了外部依赖和其他工作空间的引用。例如，引入rules_scala本身以及其他可能需要的Bazel扩展。

• BUILD: 在包含Scala源代码的目录中，你会找到这个文件。它包含了如scala_library或scala_binary等规则来编译和组织你的Scala代码。

• scala/: 通常包含项目中的Scala源代码文件，根据实际项目结构，可能会进一步细分成子包（如 src/main/scala）。

• .bazelrc: 配置Bazel构建行为的文件，可以在这里设置默认的构建选项和标签。

• docs/ 或 README.md: 包含项目介绍、快速入门指南和开发者的注意事项。

• examples/ (可选): 提供实例代码，帮助新手快速上手。

二、项目启动文件介绍

在rules_scala的上下文中，没有特定的“启动文件”像传统应用那样。但是，如果你想要运行一个Scala应用程序，你需要定义一个scala_binary规则，这将生成一个可以直接执行的jar文件。例如，在BUILD文件里，你可能会有以下内容：

load("@rules_scala_annex//rules:scala bzl", "scala_binary")

scala_binary(
    name = "app",
    srcs = ["Main.scala"],
)

这里，Main.scala应该包含你的应用入口点，比如包含object Main extends App {...}。

三、项目的配置文件介绍

主要的配置发生在几个地方：

WORKSPACE 文件

配置外部依赖和加载必要的Bazel规则，包括rules_scala本身。例如：

http_archive(
    name = "io_bazel_rules_scala",
    url = "https://github.com/bazelbuild/rules_scala/releases/download/<version>/rules_scala-<version>.tar.gz",
    sha256 = "<sha>",
)
load("@io_bazel_rules_scala//scala:scala.bzl", "scala_repositories")
scala_repositories()

.bazelrc 或 BUILD 文件内的规则属性

用于定制构建过程，比如优化编译器参数、指定Scala版本或者启用特殊构建模式。在BUILD文件中，通过scala_library或scala_binary规则的属性进行具体配置。例如，你可以添加特定的编译标志。

scala_config()

在某些情况下，你可能需要配置Scala的具体版本或者其他配置选项，这通常在某个初始脚本或WORKSPACE文件中调用，例如：

scala_config(scala_version = "2.13.9")

通过这种方式，开发者能够调整适用于他们项目的细节，从而实现更精细的控制。

---

以上就是对基于rules_scala项目的简单介绍，覆盖了其基本的目录布局、如何定义启动逻辑以及配置的关键点。深入了解每个部分需要参考具体的项目文档和Bazel的最佳实践。