- синтаксис:
<uses-native-library android:name="string" android:required=["true" | "false"] />
- содержится в:
-
<application>
- описание:
Указывает предоставленную поставщиком общую нативную библиотеку , с которой должно быть скомпоновано приложение. Этот элемент указывает системе, что нативная библиотека должна быть доступна для пакета.
Библиотеки NDK доступны по умолчанию и поэтому не требуют тега
<uses-native-library>
.Нативные общие библиотеки, не входящие в NDK и предоставляемые поставщиками микросхем или производителями устройств, по умолчанию недоступны, если приложение предназначено для Android 12 (уровень API 31) или выше. Библиотеки доступны только при явном запросе с помощью тега
<uses-native-library>
.Если приложение предназначено для Android 11 (API уровня 30) или ниже, тег
<uses-native-library>
не требуется. В этом случае доступна любая нативная общая библиотека, независимо от того, является ли она библиотекой NDK.Этот элемент также влияет на установку приложения на конкретное устройство. Если этот элемент присутствует и его атрибут
android:required
имеет значениеtrue
, фреймворкPackageManager
не позволит пользователю установить приложение, если библиотека отсутствует на устройстве пользователя.Атрибут
android:required
подробно описан в следующем разделе.- атрибуты:
-
android:name
- Имя файла библиотеки.
-
android:required
- Булевое значение, указывающее, требуется ли приложению библиотека, указанная
android:name
.-
"true"
: приложение не работает без этой библиотеки. Система не позволяет установить приложение на устройство, на котором эта библиотека не установлена. -
"false"
: приложение использует библиотеку, если она есть, но при необходимости может работать и без неё. Система позволяет установить приложение, даже если библиотека отсутствует. Если указано"false"
, вы несёте ответственность за корректную обработку отсутствия библиотеки.
Значение по умолчанию —
"true"
. -
-
- введено в:
- Уровень API 31
- см. также:
<использует собственную библиотеку>
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-27 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-08-27 UTC."],[],[],null,["# <uses-native-library\u003e\n\nsyntax:\n:\n\n ```xml\n \u003cuses-native-library\n android:name=\"string\"\n android:required=[\"true\" | \"false\"] /\u003e\n ```\n\ncontained in:\n:\n `\n `[\u003capplication\u003e](/guide/topics/manifest/application-element)`\n `\n\ndescription:\n\n:\n Specifies a [vendor-provided shared native library](https://source.android.com/devices/tech/config/namespaces_libraries#adding-additional-native-libraries)\n that the application must be linked against. This element tells the system to make the native\n library accessible for the package.\n\n\n NDK libraries are by default accessible and therefore don't require the\n `\u003cuses-native-library\u003e` tag.\n\n\n Non-NDK native shared libraries that are provided by silicon vendors or device manufacturers\n aren't accessible by default if the app targets Android 12 (API level 31) or higher. The\n libraries are accessible only when they are explicitly requested using the\n `\u003cuses-native-library\u003e` tag.\n\n\n If the app targets Android 11 (API level 30) or lower, the\n `\u003cuses-native-library\u003e` tag isn't required. In that case, any native shared\n library is accessible regardless of whether it is an NDK library.\n\n\n This element also affects the installation of the application on a particular device. If this\n element is present and its `android:required` attribute is set to\n `true`, the\n [PackageManager](/reference/android/content/pm/PackageManager)\n framework won't let a user install the application unless the library is present on the\n user's device.\n\n\n The `android:required` attribute is described in detail in the following section.\n\nattributes:\n:\n\n `android:name`\n :\n The name of the library file.\n\n `android:required`\n :\n Boolean value that indicates whether the application requires the\n library specified by `android:name`.\n\n - `\"true\"`: the application doesn't function without this library. The system doesn't let the application install on a device that doesn't have the library.\n - `\"false\"`: the application uses the library if present, but is designed to function without it if necessary. The system lets the application install, even if the library isn't present. If you use `\"false\"`, you are responsible for gracefully handling the absence of the library.\n\n\n The default is `\"true\"`.\n\n\nintroduced in:\n: API level 31\n\nsee also:\n:\n - [PackageManager](/reference/android/content/pm/PackageManager)\n - [\u003cuses-library\u003e](/guide/topics/manifest/uses-library-element)\n [](/guide/topics/manifest/uses-library-element)\n\n [](/guide/topics/manifest/uses-library-element)\n[](/guide/topics/manifest/uses-library-element)"]]