Файл манифеста AndroidManifest.xml
Файл манифеста AndroidManifest.xml предоставляет основную информацию о программе системе. Каждое приложение должно иметь свой файл AndroidManifest.xml. Редактировать файл манифеста можно вручную, изменяя XML-код или через визуальный редактор Manifest Editor (Редактор файла манифеста), который позволяет осуществлять визуальное и текстовое редактирование файла манифеста приложения.
Назначение файла
Общая структура манифеста
Файл манифеста инкапсулирует всю архитектуру 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»
Наиболее распространенные разрешения
объявляет базовое имя для дерева разрешений. Этот элемент объявляет не само разрешение, а только пространство имен, в которое могут быть помещены дальнейшие разрешения.
определяет имя для набора логически связанных разрешений. Это могут быть как объявленные в этом же манифесте с элементом
разрешения, так и объявленные в другом месте. Этот элемент не объявляет разрешение непосредственно, только категорию, в которую могут быть помещены разрешения. Разрешение можно поместить в группу, назначив имя группы в атрибуте permissionGroup элемента
Понимание файла манифеста JAR
Узнайте о файле манифеста JAR, его возможностях и многом другом.
1. введение
Архив Java (JAR) описывается файлом манифеста. В этой статье рассматриваются его многочисленные возможности, включая добавление атрибуции, создание исполняемого файла JAR и встраивание информации об управлении версиями.
Однако давайте начнем с краткого обзора того, что такое файл манифеста.
2. Файл Манифеста
Файл манифеста называется MANIFEST.MF и находится в каталоге META-INF в JAR. Это просто список пар ключей и значений, называемых заголовками или атрибутами , сгруппированных в разделы.
Эти заголовки предоставляют метаданные, которые помогают нам описать аспекты нашей JAR, такие как версии пакетов, класс приложения для выполнения, путь к классу, материал подписи и многое другое.
3. Добавление файла манифеста
3.1. Манифест по Умолчанию
Например, если мы создадим JAR в OpenJDK 11:
Он создает очень простой файл манифеста:
3.2. Пользовательский Манифест
Или мы можем указать ваш собственный файл манифеста.
Например, предположим, что у нас есть пользовательский файл манифеста с именем manifest.txt :
Мы можем включить этот файл и jar объединит его с файлом манифеста по умолчанию при использовании опции m :
Затем результирующий файл манифеста:
3.3. Maven
Теперь содержимое файла манифеста по умолчанию изменяется в зависимости от того, какие инструменты мы используем.
Например, Maven добавляет некоторые дополнительные заголовки:
Мы действительно можем настроить эти заголовки в нашем pom.
Скажем, например, что мы хотим указать, кем была создана банка и пакет:
При этом создается файл манифеста с пользовательскими заголовками package и created-by :
4. Заголовки
Заголовок должен соответствовать определенному формату и разделяться новой строкой:
Давайте рассмотрим некоторые стандартные заголовки из спецификации | и некоторые общие пользовательские заголовки.
4.1. Основные заголовки
Основные заголовки обычно содержат общую информацию:
4.2. Точка входа и Путь к классу
Например, если ваша точка входа в приложение находится в Application.class и он использует библиотеки и ресурсы, тогда мы можем добавить необходимые заголовки:
4.3. Версия упаковки и герметизация
Эти стандартные заголовки описывают пакеты в банке.
4.4. Подписанная банка
4.5. OSGI
Обычно также можно увидеть пользовательские заголовки для пакетов OSGI:
См.нашу статью Введение в OSGI, чтобы узнать больше о пакетах OSGI.
5. Разделы
Кроме того, заголовок, появляющийся в разделе для каждой записи, переопределяет тот же заголовок в основном разделе. Обычно разделы для каждой записи содержат информацию о версиях пакетов и печати, а также цифровую подпись.
Давайте рассмотрим простой пример раздела для каждой записи:
Основная секция в верхней части запечатала все пакеты в нашей БАНКЕ. Тем не менее, пакет com.baeldung.utils не запечатан разделом для каждой записи.
6. Заключение
В этой статье представлен обзор того, как добавить файл манифеста в JAR, как использовать разделы и некоторые общие заголовки. Структура файла манифеста позволяет нам предоставлять стандартную информацию, такую как информация о версии.
Однако его гибкость позволяет нам определять любую информацию, которую мы считаем уместной для описания содержимого наших банок.
Файл манифеста
В предыдущей статье мы рассмотрели создание простого файла манифеста, давайте теперь рассмотрим как его использовать в автономных приложениях.
Использование манифеста
Самого факта создания манифеста недостаточно, чтобы браузер обращал на него внимание. Чтобы манифест имел какой-либо эффект, на него должны существовать ссылки в веб-страницах. Для этого нужно вставить в корневой элемент атрибут manifest и присвоить ему в качестве значения имя файла манифеста:
Это нужно проделать для каждой страницы, входящей в автономное приложение.
Веб-сайт может иметь неограниченное количество автономных приложений при условии, что каждое из них имеет собственный манифест. Автономные приложения также могут совместно использовать некоторые ресурсы (например, таблицы стилей), но каждое приложение должно иметь свой отдельный набор веб-страниц.
Помещение манифеста на веб-» target=»_blank»>сервер
Тестирование файла манифеста может оказаться сложным процессом. Небольшие ошибки могут вызывать скрытые сбои и нарушать весь процесс кэширования. Но, тем не менее, на определенном этапе файл манифеста нужно протестировать, чтобы удостовериться в том, что разработанное автономное приложение работает так, как вы ожидаете.
Не должно быть неожиданностью то обстоятельство, что автономное приложение нельзя тестировать, запуская файлы на исполнение с локального жесткого диска. Вместо этого автономное приложение нужно разместить на веб-» target=»_blank»>сервере, будь то веб-» target=»_blank»>сервер поставщика услуг интернета или тестовый веб-» target=»_blank»>сервер разработчика, например веб-» target=»_blank»>сервер IIS, встроенный в Windows.
Тестирование автономного приложения выполняется в такой последовательности:
Первым делом необходимо удостовериться в том, что для предоставления файлов манифеста в настройках веб-» target=»_blank»>сервера указан MIME-тип text/cache-manifest. Если веб-» target=»_blank»>сервер будет указывать какой-либо другой тип файла, включая простой текстовый файл, браузер будет полностью игнорировать манифест.
Рассмотрите отключение обычного кэширования для файлов манифеста. Это может быть необходимым по той причине, что веб-» target=»_blank»>сервер может давать указание браузерам кэшировать файлы манифеста в течение определенного времени, точно так же, как и другие типы файлов. Такое поведение логично, но оно может вызвать большие проблемы.
Проблема состоит в том, что некоторые браузеры могут игнорировать обновленные файлы манифеста на веб-» target=»_blank»>сервере и продолжать использовать старые, кэшированные файлы манифеста, вследствие чего они также будут продолжать использовать старые, кэшированные файлы веб-страниц. (Особенно грешит неохотой расставаться со старыми файлами манифеста браузер Firefox.) Во избежание этой проблемы веб-» target=»_blank»>сервер необходимо настроить так, чтобы тот не указывал браузерам кэшировать файлы манифеста.
Откройте страницу в браузере, поддерживающем автономные приложения, иными словами, практически в любом браузере, за исключением Internet Explorer. Когда браузер обнаружит, что веб-страница использует манифест, он может запросить разрешение на загрузку файлов. Вероятнее всего, что такое разрешение будут требовать браузеры мобильных устройств по причине ограниченных возможностей хранения. Браузеры настольных компьютеров могут либо выдавать такой запрос, либо нет. Например, Firefox запрашивает разрешение на кэширование, a Chrome и Safari — нет:
Получив разрешение, браузер начинает кэширование файлов. Сначала загружается манифест, а потом все перечисленные в нем файлы. Процесс загрузки осуществляется в фоновом режиме, позволяя, таким образом, продолжать просмотр страницы. Этот процесс подобен тому, когда браузер загружает изображение или видео большого объема и при этом отображает остальную страницу.
Отключитесь от интернета. Если ваше приложение размещено на удаленном » target=»_blank»>сервере, просто разорвите подключение. Если же приложение размещено на локальном » target=»_blank»>сервере (т.е. на том же компьютере, что и браузер), остановите веб-» target=»_blank»>сервер.
Перейдите на одну из страниц автономного приложения и обновите ее. Даже если дать указание браузеру не кэшировать страницу, иногда он все равно сохранит ее, чтобы можно было возвращаться на ранее просмотренные страницы, нажимая кнопку Назад. Но если обновить страницу, браузер всегда будет пытаться подключиться к веб-» target=»_blank»>серверу.
При запросе обыкновенной страницы и при отсутствии подключения к интернету этот запрос не выполнится. Но при обновлении страницы автономного приложения браузер незаметно предоставляет копию страницы из кэша, даже не информируя пользователя об этом. Можно переходить с одной страницы автономного приложения на другую, но если перейти по ссылке на страницу, не являющуюся частью автономного приложения, браузер выдаст знакомое сообщение о невозможности подключиться к удаленному » target=»_blank»>серверу.
Чтобы продемонстрировать использование автономных приложений загрузите страницу canvas_labirint.html, на которой реализована игра, которую мы создавали ранее. В данной странице реализовано автономное управление, т.е. если вы отключитесь от интернета и обновите эту страницу, она все равно будет работать. Файл манифеста для этой страницы довольно простой, нам нужно кэшировать таблицу стилей, файл JavaScript и несколько изображений:
Обновление файла манифеста
Заставить автономное приложение работать — это только первая часть задачи. Вторая часть — обновление его содержимого.
Рассмотрим пример с лабиринтом. Если обновить файл canvas_labirint.html и перезагрузить страницу, браузер все равно будет выводить старую, кэшированную версию страницы, даже если компьютер подключен к интернету. Проблема состоит в том, что после сохранения автономного приложения в кэше браузер использует только эту кэшированную копию, игнорируя онлайновые версии соответствующих вебстраниц и не проверяя, были ли какие-либо изменения. А так как срок хранения автономного приложения в кэше никогда не истекает, браузер будет упрямо игнорировать измененные страницы на веб-» target=»_blank»>сервере.
Но при этом браузер регулярно проверяет присутствие нового файла манифеста. Таким образом, можно подумать, что все, что нужно сделать для решения этой проблемы — это сохранить новый файл манифеста на веб-» target=»_blank»>сервере.
Не обязательно. Чтобы инициировать обновление кэшированного автономного приложения, необходимо выполнение следующих требований:
Отсутствие кэширования файла манифеста
Если у браузера есть локальная кэшированная копия файла манифеста, он никогда не будет проверять наличие этого файла на веб-» target=»_blank»>сервере. Разные браузеры подходят по-разному к вопросу кэширования файлов манифеста. Некоторые браузеры (например Chrome) всегда проверяют наличие нового файла манифеста на веб-» target=»_blank»>сервере. Но Firefox следует традиционным правилам кэширования и хранит локальную копию файла манифеста в течение некоторого времени. Поэтому, чтобы избежать проблем в этой области, удостоверьтесь в том, что ваш веб-» target=»_blank»>сервер явно указывает своим клиентам не кэшировать файлы манифеста.
У манифеста должна быть проставлена новая дата
Когда браузер проверяет наличие нового файла манифеста на