需要此项功能的情况
如果您处于以下情况，则需要了解链接器命名空间： 使用原生代码构建应用- 在Vega应用中使用C/C++库
- 集成第三方原生SDK（视频播放器、分析、DRM）
- 使用原生实现创建自定义Turbo模块
- 将现有的Android或Linux应用移植到Vega
- 构建失败，显示错误消息“library found in package”（在程序包中找到库）
- 应用崩溃，显示错误消息“cannot open shared object file”（无法打开共享目标文件）
- 符号在运行时解析不正确
- 应用在一台设备上正常运行，但在另一台设备上失败
- 您的应用在认证期间必须通过ABI验证
- 您需要确保您的应用在操作系统更新后都能正常运行
- 您希望避免因库冲突而被拒绝
链接命名空间可带来什么
- 稳定性： 应用只能访问版本控制良好且应用二进制接口 (ABI) 稳定的系统库
- 隔离： 捆绑库永远不会与系统库发生冲突
- 兼容性： 应用在操作系统更新后继续运行
您可以用链接器命名空间做什么
- 使用正确利用共享库的原生代码构建应用
- 在不引起冲突的情况下捆绑第三方库
- 安全高效地链接到部分系统库
- 对与库依赖项或ABI违规相关的构建故障进行故障排除
工作方式
动态链接器将库分隔成两个命名空间，以强制执行隔离并防止发生冲突。 您的应用的命名空间- 包含应用程序包中捆绑的所有库（运行时挂载到）
- 可以从Vega OS公共ABI列表中访问经批准的系统库
- 与内部操作系统库隔离
- 包含操作系统内部库
- 仅将公共ABI列表中的库公开给应用
- 防止访问不稳定或版本不兼容的系统库
运行时加载过程
在运行时，应用的原生入口点加载到应用命名空间中。然后，对于每个随后加载的库，动态链接器会执行以下操作：- 确定所请求的库属于哪个命名空间。
- 检查您的应用是否有权限访问该库。
- 仅在该库属于您应用的命名空间或在公共ABI列表上的情况下才加载该库。
- 阻止访问系统内部库，防止因不兼容版本而导致运行时故障。
访问系统库
公共ABI列表中的系统库最初加载到系统命名空间中，但您的应用仍可通过符号解析来访问它们。方法如下： 示例：您的应用使用libpthread.so.0中的pthread_create
- 您的应用的库请求
pthread_create。 - 动态链接器在公共ABI列表中找到
libpthread.so.0。 - 链接器通过标准符号解析让符号可供您的应用使用。
- 您的应用无需直接访问系统命名空间即可成功调用
pthread_create。
libpthread.so.0本身依赖的库）的传递依赖项将与系统命名空间隔离，除非它们也出现在公共ABI列表中。
库搜索顺序
Vega动态链接器会使用不同的搜索路径，具体取决于所请求的库是公共操作系统ABI的一部分还是与您的应用捆绑在一起。系统库（在公共操作系统ABI列表中）
当请求的库出现在公共操作系统ABI列表中时，链接器按以下顺序进行搜索：/lib/:/usr/lib/:/vendor/usr/lib/（系统首选搜索路径）DT_RPATH（如果不存在DT_RUNPATH）LD_LIBRARY_PATHDT_RUNPATH- 剩余的系统默认搜索路径
应用捆绑库（不在公共操作系统ABI列表中）
当请求的库不在公共操作系统ABI列表中时，链接器按以下顺序进行搜索：- （应用首选的搜索路径）
DT_RPATH（如果不存在DT_RUNPATH）LD_LIBRARY_PATHDT_RUNPATH- 剩余的系统默认搜索路径
强制执行策略
Vega通过两层方法强制执行ABI合规性：构建时验证（尽力验证）
Vega开发工具包含了构建时ABI尽力验证功能，可在开发过程中尽早发现问题，也可在CI管道中运行。这样可以避免以后在运行时出现问题。- 目的：在设备部署之前识别潜在的运行时故障
- 作用域：根据ABI要求验证程序包结构和依赖项建模
- 限制：无法捕捉所有可能的运行时场景，例如动态
dlopen路径和环境符号
运行时强制执行
当您的应用在Vega系统映像中的物理或虚拟设备上运行时，动态链接器会严格强制执行命名空间隔离。应用无法访问非公共系统库，只能访问ABI列表中的库，系统会通过代理机制公开这些库。验证您的程序包
从SDK版本0.22开始，ABI验证会在构建过程中自动运行。Vega打包工具 (vpt) 会检查您的程序包中是否：- 存在应动态链接的捆绑系统库
- 缺少第三方依赖项
- 库路径或加载模式不正确
构建因ABI违规而失败
如果您的构建未通过ABI验证：- 从您的程序包中移除显示在Vega OS公共ABI列表中的系统库。
- 更新您的构建配置（CMakeLists.txt、Makefiles）以动态链接系统库。
- 确认您已将所有非系统依赖项捆绑在程序包中。
- 重新构建您的VPKG并重新验证。
- 在实际设备上测试以确认运行时行为。
最佳实践
请遵循以下最佳实践来确保您的应用符合Vega的ABI要求并避免运行时冲突。切勿捆绑系统库，要进行动态链接
在捆绑库之前，请务必查看Vega OS公共ABI列表。如果某个库出现在此列表中，请动态链接到该库，而不是进行捆绑 在构建配置中使用DT_NEEDED条目（首选）或显式调用系统库的dlopen()：
捆绑所有第三方依赖项
将所有不在Vega OS公共ABI列表中的库直接包含在您的应用程序包中。 例如，将libcurl捆绑到应用中：
使用非限定的库名称
调用dlopen() 时，使用不带路径的库名称：
显式模型依赖项
不要依赖环境符号。务必通过DT_NEEDED条目或显式dlopen() 调用声明依赖项。
如果您遵循这些最佳实践，您的应用会受益于Vega的命名空间隔离模型，该模型提供了：
- 安全捆绑：应用可以捆绑任何不在操作系统公共ABI列表中的第三方库，而不会发生冲突
- 符号隔离：防止应用库和系统库之间发生符号冲突（包括不当绑定）
- ABI一致性：确保每个命名空间保持一致且符合预期的ABI语义
- 版本独立性：应用和系统可以不受干扰地使用同一个库的不同版本
