Layout-редактор ADT-плагина

Для работы с XML-описанием GUI-интерфейса Activity-компонента ADT-плагин предлагает визуальный графический редактор.

Layout-редактор ADT-плагина имеет вкладку Graphical Layout для визуального редактирования GUI-интерфейса и XML-вкладку, отображающую код Layout-файла.

XML-код Layout-файла сгенерированной основы Android-проекта Blank Activity определяет GUI-интерфейс, состоящий из RelativeLayout-контейнера, содержащего TextView-компонент.

RelativeLayout-контейнер представлен классом android.widget.RelativeLayout, обеспечивающим компоновку дочерних компонентов android.view.View друг относительно друга и относительно родительского компонента.

Компоновку View-компонентов определяют XML-атрибуты.

Атрибуты android: layout_above и android: layout_below располагают компонент выше или ниже компонента с указанным идентификатором.

Атрибуты android: layout_toLeftOf, android: layout_toStartOf и android: layout_toRightOf, android: layout_toEndOf располагают компонент слева или справа компонента с указанным идентификатором.

Атрибуты android: layout_alignLeft, android: layout_alignStart, android: layout_alignRight, android: layout_alignEnd, android: layout_alignBottom, android: layout_alignTop выравнивают стороны компонента по сторонам компонента с указанным идентификатором.

Атрибут android: layout_alignBaseline выравнивает компонент по базовой линии компонента с указанным идентификатором.

Атрибуты android: layout_alignParentBottom, android: layout_alignParentEnd, android: layout_alignParentTop, android: layout_alignParentStart, android: layout_alignParentLeft, android: layout_alignParentRight располагают компонент внизу, вверху, в левой и в правой части родительского компонента.

Атрибут android: layout_alignWithParentIfMissing со значением true определяет расположение компонента по умолчанию относительно родительского компонента.

Атрибуты android: layout_centerHorizontal, android: layout_centerInParent, android: layout_centerVertical располагают компонент по центральной горизонтальной линии, по центру и по центральной вертикальной линии родительского компонента.

Атрибуты android: layout_marginBottom, android: layout_marginEnd, android: layout_marginLeft, android: layout_marginRight, android: layout_marginStart, android: layout_marginTop определяют отступы компонента.

Атрибуты android: layout_height и android: layout_width указывают размеры компонента, при этом константы FILL_PARENT, MATCH_PARENT и WRAP_CONTENT определяют заполнение родительского компонента, соответствие размерам родительского компонента и соответствие содержимому. Данные атрибуты могут принимать значения в виде px (пиксели), dp (виртуальные пиксели, px = dp * (dpi / 160)), sp (масштабируемые пиксели, основанные на предпочтительном размере шрифта), in (дюймы), mm (миллиметры).

TextView-компонент представлен классом android. widget. TextView, обеспечивающий отображение текста пользователю. XML-атрибуты android: layout_height и android: layout_width со значением «wrap_content» устанавливает высоту и ширину компонента, определяемые размером его содержимого. XML-атрибут android: text со значением @string/hello_world устанавливает текстовое содержимое компонента в виде значения строкового ресурса файла strings. xml Android-проекта с именем hello_world.

Интернационализация

Кнопка Any вкладки Graphical Layout указывает, что данный Android-проект не обеспечивает интернационализацию и локализацию приложения.

Для интернационализации Android-приложения в окне Package Explorer нажмем правой кнопкой мышки на узле проекта и в контекстном меню выберем команду New | Other | Android | Android XML Values File и нажмем кнопку Next. В окне мастера в поле File: введем имя файла strings. xml и нажмем кнопку Next, в списке Optional: Choose a specific configuration to limit the XML to: выберем Language и нажмем кнопку ->. В поле Language введем ru и нажмем кнопку Finish. В результате в каталоге res проекта будет создана папка values-ru с файлом strings. xml.

Для работы с Values-файлами Android-проекта ADT-плагин также предлагает визуальный графический редактор, имеющий вкладку Resources для визуального редактирования и XML-вкладку, отображающую код Values-файла.

Для создания локализованных строк Android-приложения откроем файл strings. xml каталога res/values-ru в редакторе и нажмем кнопку Add вкладки Resources, в предложенном списке выберем элемент String и нажмем кнопку OK. В поле Name введем имя элемента «hello_world», а в поле Value введем строку «Привет!». Еще раз нажмем кнопку Add вкладки Resources, в предложенном списке выберем элемент String и нажмем кнопку OK. В поле Name введем имя элемента «app_name», а в поле Value введем строку «Приложение Андроид». Таким образом, файл strings. xml каталога res/values будет локализован для России.

Откроем файл activity_main. xml каталога ресурсов res/layout Android-проекта и увидим, что кнопка Locale… вкладки Graphical Layout изменилась на список с элементами Russian (ru) (русская версия) b Other (английская версия), при выборе которых в окне конечного вида GUI-интерфейса вкладки Graphical Layout будет отображаться соответствующий текст TextView-компонента.

После инсталляции и запуска Android-приложения в виртуальном устройстве с помощью выбора команды Run As | Android Application контекстного меню окна Package Explorer, нажмем кнопки Home и Settings устройства и выберем настройки Language & keyboard, в настройке Select locale выберем Русский – в результате Android-приложение будет отображать GUI-интерфейс в русской версии.

Другой, более быстрый способ интернационализации Android-приложения – это использование команды Add New Translation кнопки Locale…, открывающей диалоговое окно, в котором список Language позволяет выбрать язык локализации, а поля New Translation – ввести локализованные значения строковых ключей.

Панель инструментов Graphical Layout

Кнопка Android… вкладки Graphical Layout позволяет посмотреть конечный вид GUI-интерфейса относительно установленных версий Android-платформы.

Меню кнопки Configuration… вкладки Graphical Layout позволяет посмотреть конечный вид GUI-интерфейса для различных типов устройств, различных размеров экрана, различных локализаций, фрагментов и версий. Команда Manual Previews в сочетании с командой Add As Thumbnail дает возможность сформировать свой список просмотра.

Команда Create New кнопки Configuration… вкладки Graphical Layout обеспечивает создание альтернативных версий файла activity_main. xml описания GUI-интерфейса Activity-компонента для различных конфигураций Android-устройства. При запуске Android-приложения среда выполнения Android-устройства будет загружать подходящий ее конфигурации Layout-файл. Команда Create New предлагает следующие спецификаторы Android-конфигураций:

Country Code и Network Code – альтернатива языковой и региональной локализации.

LTR – layout-direction-left-to-right (определитель ldltr) направление письменности слева направо.

sw [n] dp – создает Layout-файл каталога res/layout-sw [n] dp для наименьшего размера из высоты и ширины ndp.

w [n] dp – создает Layout-файл каталога res/layout-w [n] dp для минимальной ширины экрана ndp.

h [n] dp – создает Layout-файл каталога res/layout-h [n] dp для минимальной высоты экрана ndp.

Small, Normal, Large, Xlarge – создает Layout-файл каталога res/layout- [small, normal, large, xlarge] для различных разрешений экрана 320x426, 320x470, 480x640, 720x960.

Long, Not Long – создает Layout-файл каталога res/layout-long и res/layout-notlong для широких экранов WQVGA, WVGA, FWVGA и для экранов QVGA, HVGA, VGA.

Portrait, Landscape – создает Layout-файл каталога res/layout-port и res/layout-land для вертикальной и горизонтальной ориентации экрана.

Not Night, Night – создает Layout-файл каталога res/layout-notnight и res/layout-night для работы в дневное и ночное время.

Low Density, Medium Density, High Density, Extra High Density, TV Density – создает Layout-файл каталога res/layout-ldpi, res/layout-mdpi, res/layout-hdpi, res/layout-xhdpi, res/layout-tvdpi для плотности экрана 120dpi, 160dpi, 240dpi, 320dpi, 213dpi.

Finger – создает Layout-файл каталога res/layout-finger для сенсорного экрана.

Soft – создает Layout-файл каталога res/layout-keyssoft для устройства с виртуальной клавиатурой.

No Keys – создает Layout-файл каталога res/layout-nokeys для устройства без аппаратной клавиатуры.

Hidden, Exposed – создает Layout-файл каталога res/layout-navhidden, res/layout-navexposed для устройства без и с кнопками навигации.

None, Trackball – создает Layout-файл каталога res/layout-nonav, res/layout-trackball для устройства, предоставляющим навигацию только с помощью сенсорного экрана, и для устройства с трекболом.

800x480 – создает Layout-файл каталога res/layout-1280x800 для экрана с разрешением 1280x800.

API 18 – создает Layout-файл каталога res/layout-v18 для устройства с Android-платформой 4.3 и выше.

Меню кнопки обеспечивает просмотр конечного вида GUI-интерфейса для различных типа экранов.

Меню кнопки дает возможность посмотреть конечный вид GUI-интерфейса для вертикальной и горизонтальной ориентации экрана (Portrait и Landscape), в нормальном состоянии, в настольном и автомобильном держателях, при соединении с телевизором, без экрана (Normal, Car Dock, Desk Dock, Television, Appliance), для Android-устройства, работающего в дневное и ночное время (Day Time и Night Time).

Меню кнопки обеспечивает просмотр конечного вида GUI-интерфейса с применением различных стилей для приложения.

Для всего приложения стиль устанавливается с помощью атрибута android: theme="@style/AppTheme» тэга <application> файла манифеста AndroidManifest. xml и ресурса res/values/styles. xml.

Для Activity-компонента стиль устанавливается с помощью атрибута android: theme="@style/ActivityTheme» тэга <activity> файла манифеста AndroidManifest. xml и ресурса res/values/styles. xml.

Применение стиля к Activity-компоненту может существенно менять отображение его GUI-интерфейса на экране Android-устройства. Например, при установке стиля Theme. Dialog, Activity-компонент отображается в виде диалогового окна, не заполняя полностью весь экран.

Кнопки вкладки Graphical Layout, расположенные ниже панели кнопок с меню, обеспечивают регулировку значений атрибутов android: layout_width, android: layout_height и др. корневого контейнера, а также эмуляцию размера экрана и увеличение-уменьшение изображения экрана.

Palette-палитра вкладки Graphical Layout позволяет визуально заполнить GUI-интерфейс Activity-компонента View-компонентами с помощью перетаскивания элементов Palette-палитры в область просмотра конечного вида GUI-интерфейса.

Кроме того, вкладка Graphical Layout имеет контекстное меню, открывающееся при нажатии правой кнопкой мышки на View-компоненте в окне просмотра конечного вида GUI-интерфейса, с помощью опций которого можно изменять свойства выбранного View-компонента.

Редактор файла AndroidManifest. xml ADT-плагина

Для файла манифеста AndroidManifest. xml ADT-плагин также предоставляет визуальный графический редактор.

Редактор файла AndroidManifest. xml ADT-плагина имеет вкладки Manifest, Application, Permissions, Instrumentation и AndroidManifest. xml.

Набор опций вкладок Manifest и Application зависит от версии Android-платформы, на основе которой создан Android-проект.

Вкладка Manifest ADT-редактора файла AndroidManifest. xml содержит следующие поля и ссылки:

Package – редактирование имени пакета Android-приложения, значение атрибута package элемента <manifest>.

Version Code – редактирование версии Android-приложения, значение атрибута android: versionCode элемента <manifest>.

Version name – редактирование строки, представляющей пользователю версию Android-приложения, значение атрибута android: versionName элемента <manifest>.

Shared user id – если данное приложение является одним из модулей большого Android-приложения, установка данного идентификатора одинаковым для всех модулей с подписанием их одним сертификатом дает взаимный доступ к данным, значение атрибута android: sharedUserId элемента <manifest>.

Shared user label – отображаемая пользователю метка sharedUserId-идентификатора, значение атрибута android: sharedUserLabel элемента <manifest>.

Раздел Manifest Extras – с помощью кнопки Add обеспечивает добавление в манифест следующих тэгов:

<uses-sdk> (элемент Uses Sdk) – указывает совместимость с версиями Android-платформы.

<supports-screens> (элемент Supports Screens) – указывает поддержку Android-приложением различных экранов.

<uses-configuration> (элемент Uses Configuration) – указывает, какие опции устройства требуются для работы Android-приложения.

<uses-feature> (элемент Uses Feature) – указывает для других Android-приложений, от какой опции устройства зависит работа данного Android-приложения.

<protected-broadcast> (элемент Protected Broadcast) – указывает Broadcasts-сообщения, которые может посылать только Android-система.

<compatible-screens> (элемент Compatible Screens) – указывает для Android Market совместимость приложения с конфигурациями экрана, используя тэги <screen> (элемент Screen кнопки Add).

<original-package> (элемент Original Package) – предназначен только для системных приложений.

<package-verifier> (элемент Package Verifier) – указывает имя пакета приложения, которое вызывается PackageManager-сервисом при инсталляции данного приложения. PackageManager-сервис посылает Broadcast-сообщение ACTION_PACKAGE_NEEDS_VERIFICATION указываемому пакету, который должен содержать BroadcastReceiver-компонент для верификации инсталляции.

Exporting – содержит ссылки Use the Export Wizard и Export an unsigned APK, запускающие опции экспорта подписанного и неподписанного для публикации Android-приложения.

Links – содержит ссылки Application (открывает вкладку Application редактора), Permission (открывает вкладку Permission редактора), Instrumentation (открывает вкладку Instrumentation редактора), XML Source (открывает вкладку AndroidManifest. xml редактора), Documentation (пытается открыть локализованную страницу документации).

Вкладка Application ADT-редактора файла AndroidManifest. xml помогает редактировать тэг <application> файла манифеста с помощью разделов Application Toggle, Application Attributes и Application Nodes.

Раздел Application Toggle вкладки Application содержит ссылку application – открывает страницу документации элемента <application> и флажок Define an <application> tag in the AndroidManifest. xml – включает элемент <application> в файл манифеста.

Раздел Application Attributes вкладки Application определяет атрибуты элемента <application> с помощью следующих полей и списков:

Name – при нажатии открывает мастер создания Java-класса, расширяющего класс android. app. Application. Созданный Application-класс указывается в качестве значения атрибута android: name тэга <application>. Если приложение содержит несколько Activity-компонентов, решить проблему обеспечения для них общих глобальных в рамках приложения данных и сервисов поможет Application-класс. При запуске приложения Android-система создаст единственный экземпляр Application-класса и будет вызывать его методы жизненного цикла. Рекомендуется реализовать Application-класс как Singleton-класс со статическим доступом к глобальным данным и сервисам.

Theme – общий для Activity-компонентов стиль, указываемый как значение атрибута android: theme тэга <application>. Предварительно необходимо создать ресурсный файл каталога res/values со стилем, используя команду New | Other | Android | Android XML Values File контекстного меню окна Package Explorer, дополнить его тэгом <style>, нажать кнопку Browse поля Theme и выбрать созданный ресурс – в результате у тэга <application> появится атрибут android: theme.

Label – отображаемое пользователю имя приложения, указываемое значением атрибута android: label тэга <application>. Кнопка Browse поля Label позволяет выбрать значение атрибута в ресурсном файле каталога res/values, содержащем тэги <string>.

Icon – значок приложения, определяемый значением атрибута android: icon тэга <application>. Кнопка Browse поля Icon позволяет выбрать значение атрибута как имя файла изображения, расположенного в каталоге res/drawable. Папки drawable могут иметь спецификаторы ldpi, mdpi, hdpi, xhdpi, nodpi и tvdpi, обеспечивающие отображение значка на экранах с различной плотностью.

Logo – определяет значение атрибута android: logo тэга <application>, указывающего логотип приложения для отображения в панели ActionBar.

Description – краткое описание приложения, которое указывается значением атрибута android: description тэга <application> и должно определяться ссылкой на строковый ресурс. Кнопка Browse поля Description позволяет выбрать значение атрибута в ресурсном файле каталога res/values, содержащем тэги <string>.

Permission – список позволяет выбрать разрешение, которое должно иметь стороннее Android-приложение для взаимодействия с данным Android-приложением в целом, указывается значением атрибута android: permission тэга <application>.

Process – определяет значение атрибута android: process тэга <application>, указывающего имя процесса приложения. Если данное приложение является одним из модулей большого Android-приложения, которые имеют одинаковый sharedUserId-идентификатор и подписаны одним сертификатом, тогда установка значения атрибута android: process одинаковым для всех модулей обеспечивает их запуск в одном процессе.

Task affinity – определяет значение атрибута android: taskAffinity тэга <application>, указывающего имя задачи для всех Activity-компонентов приложения, по умолчанию – имя пакета приложения. Task-задача представляет собой набор Activity-компонентов, с которыми пользователь взаимодействует для выполнения своей задачи, при этом Activity-компоненты задачи организуются в обратный стек, в порядке, в котором каждый Activity-компонент был запущен другим Activity-компонентом.

Allow task reparenting – определяет значение атрибута android: allowTaskReparenting тэга <application> – если true, тогда Activity-компоненты приложения могут перемещаться из задачи, которая их запустила, в задачу переднего плана, с которой Activity-компоненты имеют общее taskAffinity-значение, по умолчанию false.