- Синтаксис:
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="string" android:sharedUserId="string" android:sharedUserLabel="string resource" android:sharedUserMaxSdkVersion="integer" android:versionCode="integer" android:versionName="string" android:installLocation=["auto" | "internalOnly" | "preferExternal"] > ... </manifest>
- содержится в:
- none
- должен содержать:
<application>- может содержать:
<attribution><compatible-screens><instrumentation><permission><permission-group><permission-tree><queries><supports-gl-texture><supports-screens><uses-configuration><uses-feature><uses-permission><uses-permission-sdk-23><uses-sdk>- description:
- Корневой элемент файла
AndroidManifest.xml. Он должен содержать элемент<application>и атрибутыxmlns:androidиpackage. - атрибуты:
-
xmlns:android- Определяет пространство имен Android. Этот атрибут всегда имеет значение
"http://schemas.android.com/apk/res/android". package- Значение атрибута
packageв файле манифеста APK – это универсальный уникальный идентификатор приложения. Он имеет формат полного названия пакета приложения для Android в стиле языка Java. Название может содержать заглавные и строчные буквы, цифры и символы подчеркивания (_). Однако отдельные части названия пакета могут начинаться только с букв.Не изменяйте значение
package, так как это приведет к созданию нового приложения. Пользователи предыдущей версии не получат обновление и не смогут перенести свои данные в новую версию.В системе сборки на основе Gradle, начиная с AGP 7.3, не задавайте значение
packageнепосредственно в исходном файле манифеста. Подробнее о том, как задать идентификатор приложения… android:sharedUserId-
Эта константа устарела, начиная с уровня API 29.
Общие идентификаторы пользователей приводят к недетерминированному поведению в диспетчере пакетов. Поэтому мы настоятельно не рекомендуем использовать их. В будущих версиях Android они могут быть удалены. Вместо этого используйте подходящие механизмы взаимодействия, например сервисы и поставщиков контента, чтобы обеспечить совместимость общих компонентов. Удалить это значение из существующих приложений нельзя, поскольку переход с общего идентификатора пользователя не поддерживается. Добавьте в эти приложенияandroid:sharedUserMaxSdkVersion="32", чтобы не использовать общий идентификатор пользователя при новых установках.Название идентификатора пользователя Linux, который используется совместно с другими приложениями. По умолчанию Android назначает каждому приложению уникальный идентификатор пользователя. Однако если для двух или более приложений задано одинаковое значение этого атрибута, у них будет один и тот же идентификатор (при условии, что их наборы сертификатов идентичны). Приложения с одинаковым идентификатором пользователя могут получать доступ к данным друг друга и, при необходимости, выполняться в одном процессе.
android:targetSandboxVersion-
Целевая изолированная среда, которую будет использовать это приложение. Чем выше номер версии песочницы,
тем выше уровень безопасности.
Значение по умолчанию –
1. Также можно задать значение2. Если задать для этого атрибута значение2, приложение будет переключено на другую изолированную среду SELinux.Для песочницы второго уровня действуют следующие ограничения:
- Значение по умолчанию для
usesCleartextTrafficв конфигурации сетевой безопасности – false. - Общий доступ к UID запрещен.
Для приложений Android с мгновенным запуском, предназначенных для Android 8.0 (уровень API 26) или более поздней версии, этому атрибуту присваивается значение
2. Вы можете установить уровень песочницы в установленной версии приложения на менее строгий уровень1. Однако в этом случае данные из приложения с мгновенным запуском не будут перенесены в установленную версию. Чтобы это произошло, необходимо задать для установленного приложения значение песочницы2.После установки приложения вы можете только повысить значение целевой версии песочницы. Чтобы понизить значение target sandbox, удалите приложение и замените его версией, в манифесте которой указано меньшее значение этого атрибута.
- Значение по умолчанию для
android:sharedUserLabel-
Эта константа устарела, начиная с уровня API 29.
Общие идентификаторы пользователей приводят к недетерминированному поведению в диспетчере пакетов. Поэтому мы настоятельно не рекомендуем использовать их. В будущих версиях Android они могут быть удалены. Вместо этого используйте подходящие механизмы взаимодействия, например сервисы и поставщиков контента, чтобы обеспечить совместимость общих компонентов. Удалить это значение из существующих приложений нельзя, так как отказ от общего идентификатора пользователя не поддерживается.Понятный пользователю ярлык для общего идентификатора пользователя. Ярлык задается как ссылка на строковый ресурс. Это не может быть необработанная строка.
Этот атрибут был добавлен в API уровня 3. Он имеет смысл, только если также задан атрибут
sharedUserId. android:sharedUserMaxSdkVersion-
Общие идентификаторы пользователей вызывают недетерминированное поведение в диспетчере пакетов. Поэтому мы настоятельно не рекомендуем использовать их. В будущих версиях Android они могут быть удалены. Вместо этого используйте подходящие механизмы взаимодействия, например сервисы и поставщиков контента, чтобы обеспечить совместимость общих компонентов.
Максимальная версия SDK, в которой система по-прежнему использует
android:sharedUserId. Если приложение только что установлено на устройстве с версией SDK выше указанного значения, оно будет работать так, как будто вы не определялиandroid:sharedUserId.Этот атрибут был представлен в API уровня 33. Он имеет смысл, только если также задан атрибут
sharedUserId. android:versionCode- Внутренний номер версии. Это число используется только для того, чтобы определить, какая версия более новая. Чем больше число, тем новее версия. Это не номер версии, который видят пользователи. Он задается атрибутом
versionName.Значение должно быть положительным целым числом больше нуля. Вы можете задать его как угодно, главное, чтобы у каждой последующей версии номер был больше. Например, это может быть номер сборки или номер версии в формате x.y, преобразованный в целое число путем раздельного кодирования x и y в нижних и верхних 16 битах. или увеличивать его на единицу при каждом выпуске новой версии.
android:versionName- Номер версии, который видят пользователи. Этот атрибут задается как необработанная строка или как ссылка на строковый ресурс. Строка предназначена только для показа пользователям. Атрибут
versionCodeсодержит номер версии, используемый внутри компании. android:installLocation- Место установки приложения по умолчанию.
Допустимы следующие ключевые слова:
Значение Описание "internalOnly"Приложение устанавливается только во внутреннее хранилище устройства. Если задано это значение, приложение никогда не устанавливается на внешние накопители, например SD-карту. Если во внутренней памяти нет места, приложение не будет установлено. Это поведение по умолчанию, если вы не задали атрибут android:installLocation."auto"Приложение можно установить на внешний накопитель, но по умолчанию система устанавливает его во внутреннюю память. Если внутренняя память заполнена, система устанавливает приложение на внешний накопитель. После установки пользователь может переместить приложение во внутреннее или внешнее хранилище через системные настройки. "preferExternal"Приложение предпочитает установку на внешний накопитель. Однако нет гарантии, что система выполнит этот запрос. Если внешний накопитель недоступен или заполнен, приложение может быть установлено во внутреннюю память. После установки пользователь может переместить приложение во внутреннюю или внешнюю память через системные настройки. Примечание. По умолчанию приложение устанавливается во внутреннюю память и не может быть установлено на внешний накопитель, если вы не зададите для этого атрибута значение
"auto"или"preferExternal".Если приложение устанавливается на внешний накопитель:
- Файл APK сохраняется на внешнем накопителе, но все данные приложения, например базы данных, по-прежнему сохраняются во внутренней памяти устройства.
- Контейнер, в котором хранится APK-файл, зашифрован с помощью ключа, позволяющего приложению работать только на том устройстве, на котором оно было установлено. Пользователь не сможет перенести SD-карту на другое устройство и использовать установленные на ней приложения. С одним устройством можно использовать несколько SD-карт.
- По запросу пользователя приложение можно перенести во внутреннее хранилище.
Пользователь также может запросить перенос приложения из внутренней памяти во внешнюю. Однако система не позволит пользователю переместить приложение на внешний накопитель, если для этого атрибута задано значение
"internalOnly"(по умолчанию).Подробнее о том, как использовать этот атрибут и обеспечить обратную совместимость…
Появился в API уровня 8.
- введено в:
- Уровень API 1 для всех атрибутов, если в описании атрибута не указано иное.
- См. также:
-
<application>
<manifest>
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2026-11-19 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"]],["Последнее обновление: 2026-11-19 UTC."],[],[]]