使用Bazel构建混合语言iOS动态框架时导出符号丢失问题

我来帮你搞定这个Bazel构建混合语言iOS动态框架的符号丢失问题——这种场景我之前踩过好几次坑，核心是得搞清楚Bazel对不同语言规则的符号处理逻辑，还有依赖传递的门道。

为什么拆分规则后会丢符号？ #

你一开始用单个objc_library打包所有源码失败，是因为objc_library对纯C/C代码的编译逻辑和cc_library不一致，容易引发规则冲突；但拆分后丢符号，本质是**纯C/C的符号没有被正确传递到最终的动态框架中**——objc_library默认不会主动链接cc_library的符号，而且如果依赖链没理清楚，Bazel会认为某些符号是“未使用”的，直接在链接阶段优化掉。

正确的规则拆分与配置方案 #

下面是经过验证的分步解决方案，完美适配你的混合语言场景：

1. 按语言类型拆分规则，用对应库类型打包

• 纯C代码：用cc_library打包（不要用objc_library），因为cc_library是专门为C/C++设计的，能正确处理符号导出和编译选项：

  cc_library(
      name = "c_core",
      srcs = glob(["src/**/*.c"]),
      hdrs = glob(["include/**/*.h"]),  # 对外暴露的头文件放这里
      visibility = ["//visibility:public"],
      copts = ["-Wall", "-Wextra"],  # 可选：添加C编译警告
  )
  

• 纯C++代码：同样用cc_library，如果依赖C代码，要在deps里引用C的库：

  cc_library(
      name = "cpp_core",
      srcs = glob(["src/**/*.cpp"]),
      hdrs = glob(["include/**/*.hpp"]),
      deps = [":c_core"],
      visibility = ["//visibility:public"],
      copts = ["-std=c++17", "-Wall"],  # 匹配你的C++标准版本
  )
  

• ObjC代码：用objc_library打包，依赖用到的C/C++库：

  objc_library(
      name = "objc_code",
      srcs = glob(["src/**/*.m"]),
      hdrs = glob(["include/**/*.h"]),
      deps = [":c_core"],  # 如果用到C代码就加
      visibility = ["//visibility:public"],
      copts = ["-ObjC"],  # 可选：确保ObjC类别被正确链接
  )
  

• ObjC++代码：用objc_library打包，依赖对应的C++和ObjC库：

  objc_library(
      name = "objcpp_code",
      srcs = glob(["src/**/*.mm"]),
      hdrs = glob(["include/**/*.h", "include/**/*.hpp"]),
      deps = [":cpp_core", ":objc_code"],
      visibility = ["//visibility:public"],
      copts = ["-std=c++17", "-ObjC++"],  # 匹配C++标准，启用ObjC++支持
  )
  

2. 配置最终的iOS动态框架

把所有拆分后的库都加入ios_framework的deps，同时处理符号导出问题——iOS动态框架默认不会导出所有符号，所以需要手动指定要对外暴露的符号：

ios_framework(
    name = "MyHybridFramework",
    deps = [
        ":c_core",
        ":cpp_core",
        ":objc_code",
        ":objcpp_code",
    ],
    framework_name = "MyHybrid",
    visibility = ["//visibility:public"],
    # 关键：指定要导出的符号列表
    linkopts = [
        "-exported_symbols_list", "$(location export_symbols.list)",
    ],
    data = ["export_symbols.list"],  # 符号列表文件
)

export_symbols.list文件示例（根据你的实际符号修改）：

# ObjC类
_OBJC_CLASS_$_MyObjCClass
_OBJC_METACLASS_$_MyObjCClass
# C函数
_MyCFunction
# C++函数（注意名字 mangling，你可以用nm命令查看编译后的符号）
_Z10MyCPPFunctionv

常见坑点避坑 #

• 别用objc_library打包纯C/C++：objc_library的编译链路会跳过一些C/C++的符号导出逻辑，导致符号丢失。
• 依赖链必须完整：上层库必须明确依赖下层库，比如ObjC库要依赖C库，不然Bazel不会把下层的符号链接到最终框架。
• 避免过度优化：如果不想手动维护符号列表，可以临时用-all_load链接选项，但会增大框架体积，只适合调试阶段。

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