使用Bazel构建Swift动态.framework分发库及相关问题咨询

嘿，我来帮你捋清楚用Bazel构建Swift .framework的完整流程，顺便解决你遇到的modulemap、.swiftmodule和桥接文件缺失的问题——这些都是Swift框架构建里的常见坑，我帮你一步步搞定。

一、先搞定基础配置：WORKSPACE和BUILD文件 #

首先得确保你的Bazel环境能正确识别Swift规则，先从WORKSPACE文件入手：

WORKSPACE配置（加载Swift规则） #

把这段代码放到你的WORKSPACE里，注意替换成最新版本的rules_swift（可以去GitHub看最新release）：

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

http_archive(
    name = "build_bazel_rules_swift",
    sha256 = "a1b2c3d4e5f6...", # 替换成对应版本的sha256值
    url = "https://github.com/bazelbuild/rules_swift/releases/download/1.12.0/rules_swift.1.12.0.tar.gz",
)

load("@build_bazel_rules_swift//swift:repositories.bzl", "swift_rules_dependencies")
swift_rules_dependencies()

load("@build_bazel_rules_swift//swift:setup.bzl", "swift_rules_setup")
swift_rules_setup()

BUILD文件核心配置（构建.framework） #

用swift_library定义你的Swift代码库，再用apple_framework打包成.framework。重点要开启生成swiftmodule的特性：

load("@build_bazel_rules_swift//swift:swift.bzl", "swift_library")
load("@build_bazel_rules_apple//apple:apple.bzl", "apple_framework")

# 1. 定义核心Swift/OC代码库
swift_library(
    name = "MyFrameworkCore",
    srcs = glob(["Sources/**/*.swift"]), # 你的Swift源码文件
    # 如果混合了Objective-C，需要添加下面两行
    # hdrs = glob(["Headers/**/*.h"]),     # OC头文件
    # module_map = "module.modulemap",     # 手动指定modulemap（可选，自动生成也行）
)

# 2. 打包成.framework
apple_framework(
    name = "MyFramework",
    library = ":MyFrameworkCore",
    bundle_id = "com.yourteam.MyFramework", # 替换成你的bundle ID
    minimum_os_version = "13.0", # 适配的最低系统版本
    # 关键！开启这个特性才会自动生成.swiftswiftmodule和modulemap
    features = ["swift.generate_swiftmodule"],
)

二、解决缺失的modulemap、.swiftmodule和桥接文件 #

1. 自动生成modulemap & .swiftmodule #

只要你在apple_framework里加了swift.generate_swiftmodule特性，Bazel会自动在构建后的.framework/Modules目录下生成这两个文件。如果是纯Swift项目，基本不用手动配置。

但如果是Swift+Objective-C混合项目，可能需要手动写modulemap来控制OC代码的暴露：
创建module.modulemap文件放在项目根目录：

framework module MyFramework {
    umbrella header "MyFramework.h" # 你的 umbrella 头文件
    export *
    module * { export * }
}

然后在swift_library里指定module_map = "module.modulemap"，同时确保hdrs包含所有需要暴露的OC头文件。

2. 桥接文件（Swift调用OC必备） #

如果需要在Swift里调用Objective-C代码，桥接文件是绕不开的。配置方法如下：

• 先创建桥接文件，比如Headers/MyFramework-Bridging-Header.h，里面放需要暴露给Swift的OC头：

#import "SomeOCClass.h"
#import "AnotherOCUtility.h"

• 然后在swift_library里通过copts指定桥接文件路径：

swift_library(
    name = "MyFrameworkCore",
    srcs = glob(["Sources/**/*.swift"]),
    hdrs = glob(["Headers/**/*.h"]),
    module_map = "module.modulemap",
    # 指定桥接文件
    copts = [
        "-import-objc-header", "$(location Headers/MyFramework-Bridging-Header.h)",
    ],
    # 告诉Bazel这个文件是构建依赖
    data = ["Headers/MyFramework-Bridging-Header.h"],
)

三、示例项目结构参考 #

给你一个标准的项目结构，方便对照：

MyFramework/
├── WORKSPACE
├── BUILD
├── Sources/
│   └── MyFramework/
│       ├── UserManager.swift
│       └── NetworkHandler.swift
├── Headers/
│   ├── MyFramework.h          # Umbrella头文件
│   ├── SomeOCClass.h          # OC类头文件
│   └── MyFramework-Bridging-Header.h # 桥接文件
└── module.modulemap           # 手动modulemap（混合项目用）

四、构建验证 #

运行构建命令：

bazel build //:MyFramework

构建完成后，去bazel-bin/MyFramework.framework目录下检查：

• Modules/MyFramework.swiftmodule：包含各个架构的.swiftmodule文件
• Modules/module.modulemap：自动或手动配置的modulemap
• 桥接文件相关的头会被打包到.framework的Headers目录里

如果还是找不到这些文件，排查这几点：

• 确认swift.generate_swiftmodule特性已经加到apple_framework里
• 检查swift_library的srcs/hdrs是否正确包含了所有文件
• 升级rules_swift到最新版本，旧版本可能不支持自动生成这些文件

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