Bazel如何按需加载外部依赖？避免非Android开发者下载SDK

针对你的问题，这里提供三种实用方案，让非Android开发者无需强制下载SDK/NDK：

方案一：环境变量控制仓库初始化 #

通过自定义repository rule，仅在指定环境变量存在时才初始化Android相关依赖：

1. 在项目根目录创建tools/android_repo.bzl文件，内容如下：

def _android_sdk_repo_impl(ctx):
    # 检查环境变量BUILD_ANDROID是否存在
    if ctx.os.environ.get("BUILD_ANDROID"):
        # 写入Android依赖定义
        ctx.file("WORKSPACE", content="""
android_sdk_repository(
    name = "androidsdk",
    api_level = 33,
)
http_archive(
    name = "rules_android_ndk",
    url = "你的rules_android_ndk下载地址",
    sha256 = "对应的校验值",
)
load("@rules_android_ndk//:rules.bzl", "android_ndk_repository")
android_ndk_repository(
    name = "androidndk",
    api_level = 33,
)
register_toolchains("@androidndk//:all")
""")
    else:
        # 不初始化Android依赖
        ctx.file("WORKSPACE", content="")

android_sdk_repo = repository_rule(
    implementation = _android_sdk_repo_impl,
    environ = ["BUILD_ANDROID"],
)

2. 修改主WORSPACE文件，替换原Android依赖代码为：

# 加载自定义规则并执行
load("//tools:android_repo.bzl", "android_sdk_repo")
android_sdk_repo(name = "android_deps")
# 加载生成的Android依赖配置
load("@android_deps//:WORKSPACE", "")

使用方式：

• 构建Android目标时，先设置环境变量：export BUILD_ANDROID=1，再执行bazel命令。
• 非Android开发者直接构建目标，无需设置变量，不会触发Android依赖的初始化。

方案二：Bazel配置组配合条件加载 #

利用Bazel的配置组（config），仅在指定配置下初始化Android依赖：

1. 创建android_workspace.bzl文件，定义条件初始化逻辑：

def maybe_initialize_android_deps():
    # 检查是否已经初始化过Android仓库，避免重复定义
    if native.existing_rule("androidsdk") == None:
        # 读取build配置中的android参数值
        build_android = native.read_config("build", "android", "false")
        if build_android == "true":
            # 初始化Android依赖
            android_sdk_repository(
                name = "androidsdk",
                api_level = 33,
            )
            http_archive(
                name = "rules_android_ndk",
                url = "你的rules_android_ndk下载地址",
                sha256 = "对应的校验值",
            )
            load("@rules_android_ndk//:rules.bzl", "android_ndk_repository")
            android_ndk_repository(
                name = "androidndk",
                api_level = 33,
            )
            register_toolchains("@androidndk//:all")

2. 修改主WORSPACE文件，替换原Android依赖代码为：

load("//:android_workspace.bzl", "maybe_initialize_android_deps")
maybe_initialize_android_deps()

3. 在项目根目录的.bazelrc文件中添加配置组：

build:android --define android=true

使用方式：

• 构建Android目标时，使用bazel build --config=android //android/...。
• 普通构建直接执行bazel build //非Android目标路径即可。

方案三：拆分Android目标到独立子项目 #

将Android代码和依赖完全隔离到单独目录，通过指定WORKSPACE文件实现按需加载：

1. 主WORSPACE仅保留所有非Android依赖，删除原Android相关代码。
2. 在项目根目录创建android/子目录，其中创建WORKSPACE.android文件：

# 加载主WORKSPACE的基础依赖
load("//:WORKSPACE", "")

# 添加Android专属依赖
android_sdk_repository(
    name = "androidsdk",
    api_level = 33,
)
http_archive(
    name = "rules_android_ndk",
    url = "你的rules_android_ndk下载地址",
    sha256 = "对应的校验值",
)
load("@rules_android_ndk//:rules.bzl", "android_ndk_repository")
android_ndk_repository(
    name = "androidndk",
    api_level = 33,
)
register_toolchains("@androidndk//:all")

使用方式：

• 构建Android目标时，执行bazel build --workspace_file=android/WORKSPACE.android //android/...。
• 非Android开发者直接使用默认WORKSPACE构建，完全无需接触Android依赖。

内容的提问来源于stack exchange，提问作者AnDevi