<manifest>

Синтаксис:
<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>