在 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 一部分的原生库不得公开(默认情况下公开的标准公共原生库除外)。只有芯片供应商或设备制造商添加的其他库可供应用访问。
以 SDK 版本 31 (Android 12) 或更高版本为目标平台的应用必须在应用清单中使用 <uses-native-library>
标记显式指定其原生共享库依赖项。如果设备上不存在所请求库的任何部分,则未安装应用。应用安装时,系统仅向他们提供已请求的原生共享库。这意味着,应用无法访问应用清单中未显示的原生共享库。
如果应用以 Android 11(API 级别 30)或更低版本为目标平台,则无需使用 <uses-native-library>
标记。在这种情况下,任何原生共享库均可访问,而不管它是否为 NDK 库。
此元素还会影响应用在特定设备上的安装。如果此元素存在并且其 android:required
属性设置为 true
,则 PackageManager
框架将不允许用户安装应用,除非用户设备上存在相应的库。
下一部分详细介绍了 android:required
属性。
<uses-native-library
android:name="string"
android:required=["true" | "false"] />
android:name
库文件的名称。
布尔值,指示应用是否需要 android:name
指定的库。
"true"
:如果没有此库,则应用将无法正常运行。系统不允许将应用安装在没有此库的设备上。"false"
:如果此库存在,应用会使用此库,但必要时也可在没有此库的情况下运行。 系统允许安装应用,即使不存在此库也是如此。如果您使用"false"
,则需要自行负责妥善处理库不存在的情况。
默认值为 "true"
。
例如在Application 中:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools">
<--
权限添加
-->
<application
android:name=".CameraApplication"
android:allowBackup="true"
android:dataExtractionRules="@xml/data_extraction_rules"
android:extractNativeLibs="true"
android:fullBackupContent="@xml/backup_rules"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:largeHeap="true"
android:requestLegacyExternalStorage="true"
android:resizeableActivity="false"
android:roundIcon="@mipmap/ic_launcher"
android:supportsRtl="true"
android:theme="@style/Theme.AppCompat.NoActionBar"
tools:targetApi="31">
<activity
android:name=".MainActivity"
android:configChanges="orientation|keyboardHidden|screenSize"
android:exported="true"
android:theme="@style/Theme.AppCompat.NoActionBar.Fullscreen" />
<uses-native-library android:name="***.so" android:required="false" />
<uses-native-library android:name="***.so" android:required="false" />
<uses-native-library android:name="***.so" android:required="false" />
</application>
</manifest>