<использует-библиотеку>
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Примечание. Google Play использует элементы <uses-library> , объявленные в манифесте вашего приложения, для фильтрации вашего приложения от устройств, которые не соответствуют требованиям библиотеки. Дополнительную информацию о фильтрации см. в разделе Фильтры в Google Play .
- синтаксис:
<uses-library
android:name="string"
android:required=["true" | "false"] />
- содержится в:
-
<application> - описание:
Указывает общую библиотеку, с которой должно быть связано приложение. Этот элемент сообщает системе, что необходимо включить код библиотеки в загрузчик классов пакета.
Все пакеты android , такие как android.app , android.content , android.view и android.widget , находятся в библиотеке по умолчанию, с которой автоматически связываются все приложения. Однако некоторые пакеты, например maps , находятся в отдельных библиотеках, которые не подключаются автоматически. Обратитесь к документации пакетов, которые вы используете, чтобы определить, какая библиотека содержит код пакета.
Порядок тегов <uses-library> имеет значение. Это влияет на порядок поиска и разрешения классов при загрузке приложения. Некоторые библиотеки могут иметь повторяющиеся классы, и в этом случае приоритет имеет библиотека, которая появится первой.
Этот элемент также влияет на установку приложения на конкретное устройство и доступность приложения в Google Play. Если этот элемент присутствует и для его атрибута android:required установлено значение "true" , платформа PackageManager не позволит пользователю установить приложение, если библиотека не присутствует на устройстве пользователя.
Атрибут android:required подробно описан в следующем разделе.
- атрибуты:
-
android:name - Название библиотеки. Имя указано в документации к используемому вами пакету. Примером этого является
"android.test.runner" пакет, содержащий тестовые классы Android. -
android:required - Логическое значение, указывающее, требуется ли приложению библиотека, указанная в
android:name .-
"true" : приложение не работает без этой библиотеки. Система не позволяет установить приложение на устройство, на котором нет библиотеки. -
"false" : приложение использует библиотеку, если она есть, но при необходимости может работать без нее. Система позволяет установить приложение, даже если библиотеки нет. Если вы используете "false" , вы несете ответственность за проверку доступности библиотеки во время выполнения. Чтобы проверить наличие библиотеки, вы можете использовать отражение, чтобы определить, доступен ли конкретный класс.
По умолчанию установлено "true" .
Представлено в: уровень API 7.
- представлено в:
- API уровня 1
- см. также:
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-29 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-07-29 UTC."],[],[],null,["# <uses-library\u003e\n\n**Note:** Google Play uses the `\u003cuses-library\u003e` elements declared\nin your app manifest to filter your app from devices that don't meet its\nlibrary requirements. For more information about filtering, see\n[Filters on Google Play](/google/play/filters).\n\nsyntax:\n:\n\n ```xml\n \u003cuses-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 shared library that the application must be linked against.\n This element tells the system to include the library's code in the class\n loader for the package.\n\n\n All the `android` packages, such as [android.app](/reference/android/app/package-summary),\n [android.content](/reference/android/content/package-summary), [android.view](/reference/android/view/package-summary), and [android.widget](/reference/android/widget/package-summary),\n are in the default library that all applications are automatically linked\n against. However, some packages, such as `maps`, are\n in separate libraries that aren't automatically linked. Consult the\n documentation for the packages you're using to determine which library\n contains the package code.\n\n\n The order of `\u003cuses-library\u003e` tags is significant. It affects class lookup\n and resolution order when the application loads. Some of the libraries might have\n duplicate classes, and in that case the library that comes first takes priority.\n\n\n This element also affects the installation of the application on a particular device and\n the availability of the application on Google Play. If this element is present and its\n `android:required` attribute is set to `\"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. The name is provided by the\n documentation for the package you are using. An example of this is\n `\"android.test.runner\"`, a package that contains Android test\n classes.\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 checking at runtime that the library is available.\n\n\n To check for a library, you can use reflection to determine\n whether a particular class is available.\n\n\n The default is `\"true\"`.\n\n Introduced in: API level 7.\n\n\nintroduced in:\n: API Level 1\n\nsee also:\n:\n - [PackageManager](/reference/android/content/pm/PackageManager)"]]
