如何用Gn和Ninja构建单文件PDFium.dll？（Win10+VS2019环境）

• 检查GN配置与构建目标指定

  • 确认Ninja构建命令是否明确指向pdfium目标：执行ninja -C out/Release pdfium而非仅ninja -C out/Release，默认构建可能只处理依赖组件，未触发主库编译。
  • 核对out/Release/args.gn配置，确认pdf_is_standalone = true未被其他冲突配置覆盖，部分旧版本PDFium可能需要额外添加pdf_enable_shared = true来显式开启动态库构建。

• 排查构建目录文件

  • 遍历out/Release的所有子目录（尤其是obj和lib目录），搜索pdfium.dll或pdfium.lib，可能主库文件被生成在子目录而非根目录。
  • 查看obj/pdfium目录下是否存在主库相关的目标文件（如pdfium_core.obj等），若存在说明编译完成但链接环节可能出了问题。

• 分析构建日志细节

  • 重新执行构建并保存日志：ninja -C out/Release pdfium > build.log 2>&1，搜索日志中pdfium关键词，确认是否有编译、链接步骤，或是否存在目标被静默跳过的提示。
  • 排查日志中的隐藏警告，部分依赖缺失或配置不兼容可能导致主库链接被跳过但未触发错误提示。

• 验证VS2019环境完整性

  • 确保使用VS2019开发者命令提示符启动构建环境，普通CMD可能缺少必要的编译/链接环境变量。
  • 检查VS2019是否安装了完整的C++桌面开发组件及对应版本的Windows SDK（推荐10.0.19041.0及以上），缺失组件可能导致链接失败但无明确报错。

• 调整配置进行测试

  • 临时将is_component_build = false改为静态库构建，若能生成pdfium.lib，说明问题出在动态库构建的配置逻辑上；若仍无法生成，则主库本身的编译配置存在问题。
  • 尝试开启pdf_enable_embedded_fonts = true（部分版本中该选项是主库构建的必要前提），重新生成构建文件并执行Ninja。

• 确认代码版本兼容性

  • 检查当前PDFium代码分支，优先使用稳定tag（如chromium/5154）而非开发trunk版本，部分新分支可能修改了动态库构建的默认配置。

内容的提问来源于stack exchange，提问作者Alex Müller