原生库的命名空间

Android 7.0 为原生库引入了命名空间,以限制内部 API 的可见性,并解决应用意外使用平台库(而非它们自己的库)的问题。请参阅通过 Android 7.0 中的私有 C/C++ 符号限制提升稳定性这篇 Android 开发者博文,了解针对应用的更改。

架构

在 Android 7.0 及更高版本中,系统库与应用库是分开的。

原生库的命名空间

图 1. 原生库的命名空间

原生库的命名空间可防止应用使用私有平台的原生 API(例如使用 OpenSSL)。该命名空间还可以避免应用意外使用平台库(而非它们自己的库)的问题(如使用 libpng 时)。应用库很难意外使用内部系统库(反之亦然)。

添加其他原生库

除了标准的公共原生库之外,芯片供应商(从 Android 7.0 起)和设备制造商(从 Android 9 起)还可以选择提供可供应用访问的其他原生库,方法是将它们放在相应的库文件夹中,并在 .txt 文件中显式列出它们。

库文件夹是:

  • /vendor/lib(对于芯片供应商的 32 位库)和 /vendor/lib64(对于芯片供应商的 64 位库)
  • /system/lib(对于设备制造商的 32 位库)和 /system/lib64(对于设备制造商的 64 位库)

.txt 文件是:

  • /vendor/etc/public.libraries.txt(对于芯片供应商的库)
  • /system/etc/public.libraries-COMPANYNAME.txt(对于设备制造商的库),其中 COMPANYNAME 指的是制造商的名称(例如 awesome.company)。COMPANYNAME 应符合 [A-Za-z0-9_.-]+ 格式(字母数字字符 , _, .(点)和 -。如果某些库来自外部解决方案提供商,则可以在设备中包含多个此类 .txt 文件。

设备制造商公开的 system 分区中的原生库必须命名为 lib*COMPANYNAME.so,例如 libFoo.awesome.company.so。 换句话说,没有公司名称后缀的 libFoo.so 不得公开。库文件名中的 COMPANYNAME 必须与列出库名称的 txt 文件名称中的 COMPANYNAME 匹配。

作为 AOSP 一部分的原生库不得公开(默认情况下公开的标准公共原生库除外)。只有芯片供应商或设备制造商添加的其他库可供应用访问。

从 Android 8.0 开始,供应商的公共库需要遵循以下额外限制,并且需要进行相应的设置:

  1. 供应商的原生库必须添加适当的标签,以供应用访问。如有任何应用(包括第三方应用)要求访问原生库,则该库必须在供应商专用的 file_contexts 文件中标记为 same_process_hal_file,具体如下所示:
    /vendor/lib(64)?/libnative.so u:object_r:same_process_hal_file:s0
    其中,libnative.so 是原生库的名称。
  2. 该库不得依赖(无论是直接依赖,还是通过其依赖关系间接依赖)VNDK-SP 库和 LLNDK 库之外的任何系统库。在 development/vndk/tools/definition/tool/datasets/eligible-list-<version>-release.csv 中找到 VNDK-SP 库和 LLNDK 库的列表。

从 Android 15(AOSP 实验版)开始,可以将供应商公共库放在供应商 APEX 中。在供应商 APEX 中打包时,请在 APEX 清单的 provideNativeLibs 属性中列出库。

将应用更新为不使用非公共原生库

仅针对 SDK 版本为 24 或更高版本的应用启用此功能;如需了解向后兼容性,请参阅表 1。 当应用关联到私有原生库时会发生什么情况。 CDD 第 3.1.1 节列出了可供应用访问的 Android 原生库(又称为公共原生库)。支持版本 24 或更高版本且使用任何非公共库的应用应进行更新。如需了解详情,请参阅链接到平台库的 NDK 应用

更新应用以获取其原生库依赖项

以 SDK 版本 31 (Android 12) 或更高版本为目标平台的应用必须在应用清单中使用 <uses-native-library> 标记显式指定其原生共享库依赖项。如果设备上不存在所请求库的任何部分,则未安装应用。应用安装时,系统仅向他们提供已请求的原生共享库。这意味着,应用无法访问应用清单中未显示的原生共享库。