Apollo 10.0源码编译中添加第三方库的实践指南

在Apollo自动驾驶平台10.0版本的源码编译过程中，开发者经常需要引入自定义的第三方库。与9.0版本相比，10.0版本在构建系统上做了一些调整，这导致传统的添加第三方库的方法不再适用。本文将详细介绍在Apollo 10.0中正确添加第三方库的技术方案。

问题背景

在Apollo 9.0版本中，开发者可以通过修改tools/workspace.bzl文件来添加第三方库依赖。具体做法是在该文件中添加库的加载语句和初始化函数调用。由于WORKSPACE文件中加载了这个bzl文件，因此构建系统能够正确识别并下载这些第三方依赖。

然而，在升级到10.0版本后，这一机制发生了变化。开发者发现即使按照9.0的方式添加了依赖，构建系统仍然无法识别这些第三方库。深入分析后发现，问题出在WORKSPACE文件的生成机制上。

技术原理

Apollo 10.0采用了更智能的构建系统，WORKSPACE文件是由构建工具(buildtool)自动生成的。这个文件基于WORKSPACE.source模板文件生成，但生成过程中会覆盖某些区域的内容。

关键发现是WORKSPACE.source文件中包含特殊的#####APOLLO########分隔符。这个分隔符将文件分为两个区域：

1. 自动生成区域：分隔符上方的内容由构建系统自动管理，每次构建时可能被覆盖
2. 自定义区域：分隔符下方的内容可以安全添加自定义配置，不会被构建系统修改

解决方案

要在Apollo 10.0中正确添加第三方库，需要遵循以下步骤：

1. 准备第三方库定义文件： 在third_party目录下为你的库创建workspace.bzl文件，定义库的下载和构建规则

2. 修改WORKSPACE.source文件： 在#####APOLLO########分隔符下方添加加载语句：

   load("//third_party/your_library:workspace.bzl", "your_library_repo")
   your_library_repo()
   

3. 构建验证： 运行构建命令后，检查生成的WORKSPACE文件是否包含了你的自定义配置

注意事项

• 不要在WORKSPACE.source文件的末尾添加自定义内容，这些内容不会被复制到生成的WORKSPACE中
• 确保自定义的bzl文件路径和函数名与实际定义一致
• 对于复杂的第三方库，可能需要同时修改BUILD文件来定义构建规则
• 建议在修改前备份重要文件，以防构建失败需要回滚

最佳实践

1. 模块化管理：为每个第三方库创建独立的bzl文件，保持代码清晰
2. 版本控制：在bzl文件中明确指定库的版本号和校验和
3. 依赖隔离：使用http_archive或git_repository等规则隔离第三方依赖
4. 增量测试：每次添加一个库后进行构建测试，便于定位问题

通过遵循上述方法，开发者可以在Apollo 10.0中顺利添加各种第三方库依赖，满足项目开发的定制化需求。这种机制既保留了构建系统的自动化优势，又为开发者提供了足够的灵活性。