llvm-link报错：expected top-level entity，libpng合并Bitcode失败

问题根源 #

你当前用常规configure/make编译libpng生成的静态库libpng12.a里的.o文件是机器码目标文件，而llvm-link只能处理LLVM IR Bitcode格式的文件，这就是报错的原因。之前json项目成功是因为当时的编译流程生成了Bitcode文件，而本次libpng的编译没有生成符合要求的Bitcode。

修复步骤 #

1. 修改libpng编译流程，强制生成Bitcode #

修改build_lib函数，指定用Clang编译并添加-flto（生成Bitcode的核心参数）和-fPIC（静态库必要参数）：

build_lib() {
  rm -rf BUILD
  cp -rf libpng-1.2.56 BUILD
  (cd BUILD && CC=clang-10 CXX=clang++-10 ./configure --disable-shared CFLAGS="-flto -fPIC" CXXFLAGS="-flto -fPIC" && make -j $JOBS )
}

2. 验证生成的目标文件格式 #

编译完成后，执行以下命令检查静态库中的文件是否为Bitcode：

llvm-readobj-10 -file-headers BUILD/.libs/libpng12.a

输出中如果包含Format: LLVM IR，说明生成的是正确的Bitcode文件；如果是Format: ELF，则说明还是机器码，需要检查编译参数是否生效。

3. 处理依赖（若有） #

libpng依赖zlib，如果系统默认的zlib是机器码格式，链接时会报错。你需要用同样的Clang+-flto参数编译zlib的Bitcode版本，然后在libpng的configure时指定zlib的路径：

./configure --disable-shared --with-zlib=/path/to/your/zlib-bitcode-build CFLAGS="-flto -fPIC" CXXFLAGS="-flto -fPIC"

4. 重新执行完整编译流程 #

修改后重新运行你的脚本，此时ar x解压出来的.o都是Bitcode格式，llvm-link就能正常合并生成combined.bc了。

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