Xmake项目交叉编译中的PIC编译选项问题解析

在Xmake构建系统中进行交叉编译时，开发者可能会遇到一个常见问题：当尝试链接静态库到动态库时，出现与位置无关代码(PIC)相关的错误。这类错误通常表现为"relocation R_AARCH64_ADR_PREL_PG_HI21"等警告信息，提示需要重新编译带有-fPIC选项。

问题现象

在Ubuntu 24系统上使用Xmake进行aarch64架构的交叉编译时，链接阶段会出现类似以下的错误信息：

relocation R_AARCH64_ADR_PREL_PG_HI21 against symbol `_ZTVN4Json9ExceptionE' which may bind externally can not be used when making a shared object; recompile with -fPIC

这种错误表明，静态库在编译时没有启用位置无关代码选项(-fPIC)，但被尝试链接到一个动态库中。在Linux系统中，动态库要求所有包含的代码必须是位置无关的。

问题原因

Xmake默认情况下会为动态库目标启用-fPIC选项，但对于依赖的第三方静态库，如果没有显式指定PIC编译选项，这些静态库可能不包含位置无关代码。当这些非PIC静态库被链接到动态库时，就会产生上述错误。

解决方案

针对这个问题，开发者可以通过以下方式解决：

1. 显式指定PIC编译选项：在添加依赖时，强制要求使用PIC编译

add_requires("jsoncpp", {configs = {shared = false, cxflags="-fPIC"}})

2. 使用动态链接：如果条件允许，可以考虑直接使用动态链接版本

add_requires("jsoncpp", {configs = {shared = true}})

3. 全局PIC设置：对于整个项目，可以设置全局的PIC选项

set_policy("package.requires_strict_pic", true)

技术背景

位置无关代码(PIC, Position Independent Code)是一种特殊的编译方式，它生成的代码可以在内存中的任何位置执行，而不需要重定位。这对于动态库特别重要，因为动态库在加载时可能被映射到进程地址空间的不同位置。

在交叉编译环境下，PIC的要求更为严格，特别是对于ARM64(aarch64)架构，某些重定位类型(如ADR_PREL_PG_HI21)需要代码是位置无关的才能正常工作。

最佳实践

1. 当需要将静态库链接到动态库时，总是确保静态库是使用PIC选项编译的
2. 在交叉编译环境中，考虑启用更严格的编译检查
3. 对于复杂的项目，可以在xmake.lua中添加配置检查，自动处理PIC需求

通过理解这些原理和解决方案，开发者可以更好地处理Xmake项目中的交叉编译问题，确保构建过程顺利进行。