Файл манифеста андроид что это

Файл манифеста AndroidManifest.xml

Файл манифеста AndroidManifest.xml предоставляет основную информацию о программе системе. Каждое приложение должно иметь свой файл AndroidManifest.xml. Редактировать файл манифеста можно вручную, изменяя XML-код или через визуальный редактор Manifest Editor (Редактор файла манифеста), который позволяет осуществлять визуальное и текстовое редактирование файла манифеста приложения.

Назначение файла

  • объявляет имя Java-пакета приложения, который служит уникальным идентификатором;
  • описывает компоненты приложения — деятельности, службы, приемники широковещательных намерений и контент-провайдеры, что позволяет вызывать классы, которые реализуют каждый из компонентов, и объявляет их намерения;
  • содержит список необходимых разрешений для обращения к защищенным частям API и взаимодействия с другими приложениями;
  • объявляет разрешения, которые сторонние приложения обязаны иметь для взаимодействия с компонентами данного приложения;
  • объявляет минимальный уровень API Android, необходимый для работы приложения;
  • перечисляет связанные библиотеки;

Общая структура манифеста

Файл манифеста инкапсулирует всю архитектуру Android-приложения, его функциональные возможности и конфигурацию. В процессе разработки приложения вам придется постоянно редактировать данный файл, изменяя его структуру и дополняя новыми элементами и атрибутами.

Корневым элементом манифеста является . Помимо данного элемента обязательными элементами является теги и . Элемент является основным элементом манифеста и содержит множество дочерних элементов, определяющих структуру и работу приложения. Порядок расположения элементов, находящихся на одном уровне, произвольный. Все значения устанавливаются через атрибуты элементов. Кроме обязательных элементов, упомянутых выше, в манифесте по мере необходимости используются другие элементы.

Описание

Элемент является корневым элементом манифеста. По умолчанию Eclipse создает элемент с четырьмя атрибутами:

Атрибуты

объявляет разрешение, которое используется для ограничения доступа к определенным компонентам или функциональности данного приложения. В этой секции описываются права, которые должны запросить другие приложения для получения доступа к вашему приложению. Приложение может также защитить свои собственные компоненты (деятельности, службы, приемники широковещательных намерений и контент-провайдеры) разрешениями. Оно может использовать любое из системных разрешений, определенных Android или объявленных другими приложениями, а также может определить свои собственные разрешения.

android:name название разрешения android:label имя разрешения, отображаемое пользователю android:description описание разрешения android:icon значок разрешения android:permissionGroup определяет принадлежность к группе разрешений android:protectionLevel уровень защиты

Элемент запрашивает разрешение, которые приложению должны быть предоставлены системой для его нормального функционирования. Разрешения предоставляются во время установки приложения, а не во время его работы.

android:name имеет единственный атрибут с именем разрешения android:name. Это может быть разрешение, определенное в элементе

данного приложения, разрешение, определенное в другом приложении или одно из стандартных системных разрешений, например: android:name=»android.permission.CAMERA» или android:name=»»android.permission.READ_CONTACTS»

Наиболее распространенные разрешения

  • INTERNET — доступ к интернету
  • READ_CONTACTS — чтение (но не запись) данных из адресной книги пользователя
  • WRITE_CONTACTS — запись (но не чтение) данных из адресной книги пользователя
  • RECEIVE_SMS — обработка входящих SMS
  • ACCESS_COARSE_LOCATION — использование приблизительного определения местонахождения при помощи вышек сотовой связи или точек доступа Wi-Fi
  • ACCESS_FINE_LOCATION — точное определение местонахождения при помощи GPS

объявляет базовое имя для дерева разрешений. Этот элемент объявляет не само разрешение, а только пространство имен, в которое могут быть помещены дальнейшие разрешения.

определяет имя для набора логически связанных разрешений. Это могут быть как объявленные в этом же манифесте с элементом

разрешения, так и объявленные в другом месте. Этот элемент не объявляет разрешение непосредственно, только категорию, в которую могут быть помещены разрешения. Разрешение можно поместить в группу, назначив имя группы в атрибуте permissionGroup элемента

Читайте также:  Приставка для телевизора андроид глючит

Источник

Структура AndroidManifest.xml

AndroidManifest.xml – это так называемый «паспорт» любого приложения для ОС Android. Данный файл полностью описывает структуру, составляющие приложения и его требования. «Манифест» нужен любому приложению и для создания любой программы под Android его нужно составить правильно.

Существует официальная документация с описанием структуры файла AndroidManifest.xml, однако она достаточно объемная и сложная для восприятия, кроме того – на английском языке, так что мы постараемся изложить всю необходимую информацию в удобоваримой форме.

Итак, AndroidManifest.xml находится в корневой директории приложения и всегда имеет именно такое имя. Всё содержимое данного файла в теге — это корневой тег «манифеста». Например:

Package – название данного программного пакета.

VersionCode – версия приложения (значение может быть использовано для внутренних нужд).

VersionName – значение версии, которое показывается пользователю.

Все остальные теги находятся внутри тега , и основные из них мы сейчас и рассмотрим.

Тег Uses-sdk содержим параметры, которые указывают на необходимую для работоспособности приложения версию SDK. Возможны такие параметры:

minSDKVersion — минимально допустимая версия SDK, чтобы запустить программу.

targetSDKVersion – «целевая» версия SDK, проще говоря – на данной версии проводилось тестирование приложения.

maxSDKVersion – верхняя допустимая версия SDK для работы приложение. Если нет стопроцентной уверенности в том, что на более новых версиях SDK приложение не будет работать, то данный параметр лучше не использовать вовсе.

Как видно, минимальная версия SDK – четвертая, а тестирование проводилось на пятой.

Тег Uses-Configeration определяет компбинацию допустимых методов ввода для приложения. Возможны следующие параметры:

reqFiveWayNav – приложение будет требовать от устройства возможность навигации в четырех направлениях плюс нажатие (это, к примеру, оптический или пятипозиционный джойстик). Возможные значения: true, false.

reqHardKeyboard – приложение будет требовать обязательное наличие аппаратной клавиатуры. Возможные значения: true, false.

reqKeyboardType — требование приложения к типу клавиатуры, которое распространяется как на программную (сенсорную), так и на аппаратную клавиатуру. Значения:

undefined – значение по умолчанию, означает, что приложение не требует клавиатуру.

nokeys – аналогично предыдущему, приложение не требует клавиатуру.

twelvekey – приложение требует 12-символьную стандартную «телефонную» клавиатуру.

qwerty – приложение требует полную клавиатуру с раскладкой qwerty.

reqNavigation – требования приложения к возможным способам навигации на девайсе (трекбол, джойстик, колесико). Допустимые значения:

undefined – значение по умолчанию. У приложения к способу навигации требований нет.

nonav – у приложения к способу навигации требований нет.

dpad – приложению требуется D-pad для работы.

trackball – приложению нужен трекбол.

wheel – приложению требуется колесо навигации.

reqTouchScreen – обязательно наличие сенсорного экрана. Допустимые значения:

undefined – значение по умолчанию, наличие сенсорного экрана не требуется.

notouch – наличие сенсорного экрана не требуется.

stylus – необходим сенсорный экран резистивного типа (управляемый стилусом).

finger – необходим сенсорный экран емкостного типа (управляемый пальцем).

Тег User-Feature определяет необходимые аппаратные и программные возможности устройства. Полный список всех допустимых требований приведен в официальной документации для AndroidManifest.xml — http://developer.android.com/guide/topics/manifest/uses-feature-element.html#features-reference.

Для примера, требование приложением обязательного наличия камеры в устройстве:

Данный тег определяет поддерживаемые приложением разрешения экрана. Можно указать несколько параметров в качестве допустимых разрешений экрана. Допустимые параметры:

smallScreens – приложение поддерживает нестандартные и малые разрешения дисплея (такие как HVGA, QVGA).

normalScreens – приложение поддерживает стандартные разрешения (такие как HVGA, WVGA, WQVGA).

largeScreens – приложение поддерживает устройства с высокой разрешающей способностью дисплея.

anyDensity – допустимо любое разрешение экрана.

Значения для всех параметров false или true.

Читайте также:  Android power on with volume button

Тег Application – один из основных. Здесь описываются такие параметры приложения, как его название, иконка, ссылка на пользовательский интерфейс и много чего еще. Кроме того, данный тег – это контейнер для других тегов, которые описывают те или иные компоненты программы, в том числе Service, Activity, Content Provider и Broadcast Receiver. О компонентах APK мы уже говорили в другом материале.

Источник

Файл манифеста приложения | Android

Каждый проект в Android содержит файл манифеста, который называется AndroidManifest.xml, который хранится в корневом каталоге иерархии проектов. Файл манифеста является важной частью нашего приложения, поскольку он определяет структуру и метаданные нашего приложения, его компонентов и его требований.

Этот файл включает в себя узлы для каждого из действий, сервисов, поставщиков контента и приемника вещания, которые создают приложение и, используя фильтры и разрешения намерений, определяют, как они координируют действия друг с другом и другими приложениями.

В файле манифеста также указываются метаданные приложения, которые включают его значок, номер версии, темы и т. Д., А дополнительные узлы верхнего уровня могут указывать любые необходимые разрешения, модульные тесты и определять требования к оборудованию, экрану или платформе.

Манифест содержит корневой тег манифеста с атрибутом пакета, установленным для пакета проекта. Он также должен включать атрибут xmls: android, который будет содержать несколько системных атрибутов, используемых в файле.
Мы используем атрибут versionCode, который используется для определения текущей версии приложения в виде целого числа, которое увеличивается с итерацией версии из-за обновления. Кроме того, атрибут versionName используется для указания публичной версии, которая будет отображаться пользователям.

Мы также можем указать, должно ли наше приложение устанавливаться на SD-карту внутренней памяти, используя атрибут installLocation.

Мы также можем указать, должно ли наше приложение устанавливаться на SD-карту внутренней памяти, используя атрибут installLocation.

Типичный узел манифеста выглядит так:

android:versionName = «0.9 Beta»

Файл манифеста включает в себя узлы, которые определяют компоненты приложения, параметры безопасности, классы тестирования и требования, которые составляют приложение. Вот некоторые из тегов подузлов манифеста, которые в основном используются:

    used -sdk — используется для определения минимальной и максимальной версии SDK, которая должна быть доступна на устройстве, чтобы наше приложение функционировало должным образом, и целевой SDK, для которого оно было разработано, с использованием комбинации атрибутов minSdkVersion, maxSdkVersion и targetSdkVersion, соответственно.

Использования конфигурации — узлы использования конфигурации используются для определения комбинации механизмов ввода, которые поддерживаются нашим приложением. Это полезно для игр, которые требуют определенных элементов управления вводом.

use-features — используется для указания того, какие аппаратные функции требуются вашему приложению. Это предотвратит установку нашего приложения на устройстве, которое не содержит требуемого аппаратного обеспечения, такого как оборудование NFC, следующим образом:

Support-Screens — используется для описания поддержки экрана для нашего приложения:

Разрешение — используется для создания разрешений для ограничения доступа к общим компонентам приложения. Мы также можем использовать существующие разрешения платформы для этой цели или определить ваши собственные разрешения в манифесте.

application — манифест может содержать только один узел приложения. Он использует атрибуты для указания метаданных для вашего приложения (включая его заголовок, значок и тему). Во время разработки мы должны включить атрибут debuggable, установленный в true, чтобы включить отладку, а затем обязательно отключить его для ваших сборок релиза.
Узел приложения также выступает в качестве контейнера для узлов Activity, Service, Content Provider и Broadcast Receiver, которые определяют компоненты приложения. Имя нашего пользовательского класса приложения можно указать с помощью атрибута android: name.

Читайте также:  Настройки супер настройки андроид

Источник

AndroidManifest.xml — что это и зачем он нужен?

Когда вы создаете новое приложение, в корне вашего проекта автоматически создается файл AndroidManifest.xml. AndroidManifest.xml — это необходимый файл в любом проекте. Он определяет глобальные значения для вашего пакета, в нем вы описываете, что находится внутри вашего приложения — деятельности, сервисы и тд. Вы так же определяете, как все эти элементы взаимодействуют с Андроид. Например, какие виды данных может перехватывать ваша программа. Должна ли она отображаться в главном меню вашего телефона и тд.

Одна из важных частей манифеста — это фильтры намерений (intent filters). Эти фильтры описывают где и когда ваша деятельность (activity) может быть запущена. Когда деятельность (activity) или операционная система хочет совершить некие действия, напрммер, отрыть веб страницу или окно выбора контакта, оно создает объект намерений. Этот объект может содержать несколько дескрипторов описывающих, что именно вы хотите сделать, какие данные вам нужны для этого и какого типа, а так же дополнительную информацию. Android сравнивает информацию в объекте намериний (Intent object) с фильтрами намерений которые были представлены всеми программами установленными у вас, и находит приложение наиболее для этого подходящее.

Кроме того, объявляя в вашем приложении деятельности, провайдеры содержимого, сервисы, нарения и фильтры намерений, вы так же можете указать огранияения и инструменты (управление безопасностью и тестирование).

Простой пример AndroidManifest.xml:

    Каждый файл AndroidManifest.xml (как и большинство дляругих xml файлов в Android) включает описание пространства имен

, в качестве своего первого элемента.

Большинство манифестов включает одиночный элемент

, который определяет уровень и свойства компонент приложения доступных из пакета.

  • Любой пакет может быть представлен пользователю как самостоятельная программа, доступной из главноего меню телефона. Для этого нужно что бы в прокете была хотя бы одна деятельность, которая поддерживает действие MAIN и категорию LAUNCHER показанную в примере выше.
  • Детальное описание структуры файла AndroidManifest.xml file.

    Корневой элемент, содержащий полное описание вашего пакета. В него могут включаться следующие элементы:

    Для поддержки позднего поиска вашей деятельности, вы можете включить один или более элементов для описания действий, которые деятельность поддерживает.

    Описывается определенный тип значений намерений, которые компоненты подерживают в качестве фильтров намерений. В дополнение, различные типы значений могут быть указаны под этим элементом. Аттрибутымогут быть указаны для получения уникального названия, иконки или другой информации для действия которое было описано. Действие намерений, которое компонент поддерживает. Категория намерений которое компонент поддерживает. Указываются поддерживаемые типы: Intent data MIME type, Intent data URI scheme, Intent data URI authority или Intent data URI path.

    Вы так же можете ассоциировать один или более компонентов со своей деятельностью, что бы другие клиенты могли получить для поиска дополнительной информации о ней:

    Добавляет описание мета информации к вашей деятельности, клиенты которой могут получить ее через ComponentInfo.metaData. Широковещательный приемник (BroadcastReceiver) позволяет приложению узнавать о изменениях с данными или действиями которые случились, даже если программа не запущена. Так же как и , вы можете указать один или более или значения , которые получатель поддерживает. Сервис это компонент который может быть запущен в фоне на произвольное количество времени. Так же как и в теге , опционально вы можете указать один или более или элементов, которые поддерживает сервис.

    Провайдер содержимого (ContentProvider) это компонент который управлет доступом к данным вашей программы, предоставляя его другим приложениям. Вы так же можете указать один или более элементов .

    Источник

    Оцените статью