Как сделать виджеты на андроид с картинками

Разработка виджета под Android

Подготовка

Для разработки была выбрана Android Stuido.Продукт еще очень сырой, не все разработчики готовы на него перейти, но отличная работа Preview и широкие возможности системы сборки Gradle берут верх над всеми недочетами. Поэтому мы рискнули попробовать, и, как оказалось, не зря.

Для тестирования, помимо непосредственной отладки на тестовом смартфоне, мы также использовали программные эмуляторы. Стандартным пользоваться достаточно проблематично, были рассмотрены различные высокопроизводительные эмуляторы Android-x86, AndroVM, Genymotion, Manymo и другие. В итоге мы выбрали Genymotion — он подкупил своей простотой установки и скоростью работы Android-x86, подробная инструкция по настройке и установке — необходим для тестирования на устройствах с Android 4.0 и ниже.

Данные эмуляторы отлично работают под различными ОС: Linux, Mac, Windows, у разработчиков бывают разные предпочтения, а переубеждать их неправильно, так что кроссплатформенные инструменты выручают.

Также эти программы помогают при автоматизированном тестировании: тесты написаны с использованием Android Instrumentation Framework, JUnit, Robotium. Подробнее об этом в следующей статье, которую мы опубликуем в ближайшее время 🙂

Проектирование

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

По данным Google Play, в мире зарегистрировано около 4500 видов различных устройств с поддержкой Android.

Помимо разрешения экрана, эти устройства могут различаться диагоналями и плотностью точек на единицу площади (ppi). К счастью, задачу можно упростить и для определения размеров элементов виджета использовать аппаратно-независимые пиксели — dp. Большинство смартфонов используют сетку 4×4, для 7-дюймовых планшетов сетка может быть 6×6, да еще и сам размер ячейки зависит от лаунчера и версий API Android. В таблице мы привели получившиеся размеры в dp для различных устройств:

Можно отталкиваться от формул:
для API младше 14 размер = (74 x количество ячеек) — 2
для последних версий размер = (70 x количество ячеек) — 30
Если во время тестирования вы сталкиваетесь с проблемами на каком-то конкретном устройстве, например при смене ориентации экрана, то проще добавить отдельный layout или указать нужный размер в dimens.xml, чем пытаться подогнать параметры. Еще на этапе проектирования обратите внимание на повторно используемые элементы, чтобы при разработке вынести их в отдельные layout, а для вставки в необходимое место используйте Include. В нашем приложении данную технологию использовали для новостей, и для реализации тени у некоторых элементов home_news_row.xml:

Реализация

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

Проанализировав текущее распространение версий Android мы выяснили, что версия 2.2 все еще актуальна и ее необходимо поддерживать. К сожалению, поддержка изменения размеров виджета доступна только с версии 3.0, поэтому для более старых версий сделаем статичную версию развернутого виджета. Доля устройств версий 3.x на текущий момент несущественна, и мы решили реагировать на изменение размера виджета начиная с Android 4.1 c помощью метода onAppWidgetOptionsChanged. Но не все с ним гладко: он не срабатывает в некоторых модифицированных прошивках. Пришлось искать альтернативное решение, и оно нашлось: мы использовали событие com.sec.android.widgetapp.APPWIDGET_RESIZE в методе onReceive():

При установке виджета на домашний экран, пользователь может выбрать в настройках цвет и прозрачность. В данной реализации нет нечего сложного, но есть один нюанс: уровень прозрачности необходимо добавить к выбранному цвету. Например, вот так это реализовано у нас:

Полученный цвет с уровнем прозрачности применяется к элементу виджета. В нашем случае мы просто устанавливаем setBackgroundColor() у LinearLayout.

Также бывают ситуации, когда в альбомном режиме размер ячейки виджета получается меньше, чем в портретном, в связи с чем текст заданной длины уже не помещается. Можно попробовать уменьшить размер текста, но на устройствах с низким разрешением он становится нечитаемым. В связи с этим при смене ориентации мы просто уменьшаем в layout альбомного режима количество выводимых строк text.setMaxLines(2), а размер шрифта оставляем прежним:

Последнее свойство добавляет в конце строки многоточие.

Для того, чтобы наш виджет было легче найти в списке установленных, нужен последний штрих: подготовка картинок-превью, или previewImage. Можно попытаться воспроизвести итоговый виджет в графическом редакторе, мы же воспользовались приложением Widget Preview.

Как создать собственный виджет на Android

Виджеты — характерная особенность Android. У многих приложений есть свои собственные виджеты, и в Play Store мы находим множество элементов, которые позволяют отображать погоду и другие элементы на главном экране. Что делать, если мы можем создавать собственные виджеты и создавать их с нуля?

Создание собственного виджета не обязательно требует программирования или написания приложений. В Play Store мы находим специальные инструменты, которые позволяют легко создавать собственные виджеты, на которых мы можем размещать любую информацию (погоду, астрономию, уровень заряда батареи, время, дату и многое, многое другое), а также правильно стилизовать и сортировать их.

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

Мы создаем собственные виджеты с помощью виджета Zooper

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

Пока пустое, затемненное поле будет отображаться. Чтобы начать создание виджета в выбранном месте, коснитесь своего шаблона пальцем. Мы перейдем на экран виджета Zooper. Сначала мы можем выбрать, хотим ли мы создать виджет с нуля, или, может быть, мы предпочтем выбрать готовый шаблон в качестве основы, которую мы будем модифицировать.

Для целей этой статьи я создам простой виджет с нуля. Я выбрал Empty и переместил его на экран конфигурации. На первом экране мы можем выбрать фон всего виджета, установить местоположение, прикрепить к нему наш календарь и изменить масштаб. Тем не менее, нас должно интересовать вкладка «Макет», в которой мы можем добавить отдельные элементы в виджет.

Каждый элемент, такой как дата, время, значок погоды или температура, называется модуль, который отображается в пределах данного виджета. На вкладке «Макет» мы можем добавить такие модули. Для этого нажмите кнопку «плюс» и выберите тип модуля из списка.

У нас есть текстовые модули (отображающие информацию в виде текста, то есть время, уровень заряда батареи, температуру, дату, астрономическую информацию и т. Д.), Значки и растровые изображения (графические элементы, которые могут отображать графику, связанную с погодой или статусом батареи), а также элементы прямоугольные, серии (например, вертикальные списки с днями недели) или индикаторы выполнения (например, панель, указывающая уровень заряда батареи или уровень сетевого сигнала).

Чаще всего мы будем использовать текстовые модули. Мы выбираем его из списка — мы можем видеть, что он установлен для отображения текущего времени по умолчанию. Мы можем изменить это в опции «Текстовый контент», где мы найдем доступные текстовые элементы для отображения вместо часа. Это могут быть такие, как дата, температура, восход / закат, широта и долгота, имя текущего оператора или сеть Wi-Fi, IP-адрес и многое другое. Все элементы разделены на такие группы, как Погода, Местоположение, Сеть, Система, Время, Дата, Аккумулятор или Календарь.

После выбора типа элемента мы можем установить его цвет, положение на виджетах (ось X, ось Y), размер, масштабирование и другие элементы. Как только мы закончим настройку, мы можем вернуться к списку модулей в опции «Макет» и добавить дополнительные элементы.

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

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

Photo Widget своими руками

Привет, уважаемое хабрасообщество. Моя предыдущая статья про кастомный экран разблокировки получила мало отзывов в виде комментариев, но тем не менее сто человек сохранило её в избранных, тем самым вдохновив меня на написание ещё одной статьи на непопулярную тему.

Многим пользователям смартфонов Xperia нравится красивый трёхмерный стандартный виджет фотографий. С точки зрения терминологии андроид, это не AppWidget, а простой View, очень похожий на виджет. Его можно с большой натяжкой назвать «плагином» к стандартному лаунчеру Xperia Home, поэтому в списке виджетов других лаунчеров его нет. В этом посте я расскажу, как можно сделать похожий виджет.

Введение

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

Основа виджета

Первым этапом необходимо сделать так, чтобы в списке доступных виджетов появился наш (напомню, не виджет). В Sony Ericsson поступили просто — стандартный лаунчер из списка установленных в системе пакетов выбирает те, что начинаются на «com.sonyericsson.advancedwidget» и добавляет название и иконку в список виджетов. Данный способ простой, но у него есть недостаток: один apk — один виджет. Мы поступим умнее (я надеюсь) — в манифесте нашего будущего виджета напишем так:

Класс PhotoWidgetReceiver оставим пустым:

Благодаря этому трюку наш лаунчер найдет все BroadcastReciever’ы, отвечающие на «by.arriva.ADVANCED_WIDGET». Далее приведен листинг кода из лаунчера.

String className — имя класса, унаследованного от BroadcastReciever, в нашем случае это PhotoWidgetReceiver. Лаунчер ищет в виджете класс PhotoWidget, в котором находится описание виджета. Вот его содержание:

Структура этого класса должна быть строго постоянной во всех ваших нестандартных (advanced) виджетах, т.к. такая же структура методов и в классе AdvancedWidgetInfo вашего лаунчера.

Непосредственно View

ContentObserver регистрирует все изменения во внешней памяти. Например, при добавлении фотографии метод onChange(boolean selfChange) вызывается несколько раз с интервалом в пару миллисекунд. Метод loadThumbnails() грузит миниатюры всех фотографий в отдельном потоке. Каждый раз при срабатывании метода onChange ContentObserver’а создаётся новый поток для создания миниатюр. Возникает ситуация, когда при добавлении одной фотографии сразу же создаётся одновременно несколько потоков, делающих одно и то же действия. Для того, чтобы избежать этой ситуации в переменной loaderId хранится id последнего созданного потока, а во всех потоках присутствует сравнение сохраненного id и id данного потока. Если цифры не равны, поток уничтожается.

Жесты листания и броска не вызывают перемещение холста View, как это принято. Вместо этого происходит изменение переменной getScrollY. Integer getSelected() возвращает текущую позицию в массиве миниатюр, float getSelectedPercent() возвращает угол наклона миниатюр относительно зрителя. Значение 0,5 соответствует 45 градусам. Возможно, следующая картинка прояснит ситуацию:

В методе onTouchEvent(MotionEvent me) важно не забыть вызывать getParent().requestDisallowInterceptTouchEvent(true) для того, чтобы во время листания миниатюр в виджете не происходило листание столов в лаунчере.

Ну и в конце пару слов о классе Transformation. Он возвращает матрицу трансформации для миниатюр в зависимости от того, что возвращают описанные выше getSelected() и getSelectedPercent().

Ещё следует отметить, что миниатюры всех изображений и видео хранятся в массиве Item[]. Это плохо. Правильным вариантом будет кэширование миниатюр.

Заключение

Вот так кратко я рассказал, как можно сделать симпатичный просмотрщик миниатюр фотографий. Я очень удивлён, что такие красивые трёхмерные эффекты листания изображений абсолютно не тормозят на моём древнем телефоне Samsung Galaxy Gio. Можете убедиться в этом на видео:

Как создать свои собственные виджеты для Android

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

Как создать свои собственные виджеты для Android

Добавить новые виджеты на экран Android довольно просто. Нажмите и удерживайте пустое место на главном экране. Ниже появится меню. Выберите ярлык «Виджеты». На некоторых моделях нужно сделать свайп двумя пальцами по экрану телефона.

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

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

Как создать свой собственный виджет для Android

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

Персонализация своего виджета

Вызовите список доступных виджетов на вашем устройстве, как было написано выше. Прокрутите вниз, пока не найдете шаблоны виджетов KWGT, и выберите виджет из опций.

Перетащите его на главный экран.

Нажмите на пустой виджет, чтобы открыть его в приложении KWGT, затем нажмите на кнопку «Создать».

Вы попадёте в раздел редактирования, в котором есть шесть вкладок: «Элементы», «Фон», «Слой», «Глобальные элементы», «Ярлыки» и «Сенсорный экран». Каждая вкладка позволяет вам настроить определенный аспект виджета.

В настоящее время ваш виджет представляет собой просто пустой контейнер, который необходимо заполнить различными объектами. Но сначала вы должны добавить фон в свой новый виджет. Нажмите на вкладку фона и выберите цвет.

Читайте также Интересные статьи:

В качестве альтернативы вы можете использовать изображение с вашего устройства.

Как создать свои собственные виджеты для Android — д обавление объектов

Затем нажмите «Элементы», для добавления элементов в свой виджет. Это кнопка «+» в правом верхнем углу.

Вы попадёте на панель, где сможете выбрать различные объекты для добавления в виджет.

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

Вот такой простой виджет у меня получился.

Заключение

KWGT Kustom Widget Maker — в этой программе есть огромное количество возможностей для тех пользователей, которые хотят поэкспериментировать над своим рабочим столом Android и создать свои собственные виджеты, а также сделать его действительно уникальным. В KWGT Kustom Widget Maker присутствуют макеты и дополнительные настройки для таких типов виджетов, как астрономическая информация, мировое время, батарея, погода, текстовые виджеты, состояние памяти, карты, аналоговые часы и многое, многое другое. Всё это можно настраивать: изменять шрифты, добавлять эффекты, размеры всех элементов или даже делать виджеты в 3D, добавлять анимации.

Виджеты на Android. Редкая фича, в которой придется разобраться

Привет, Хабр! Меня зовут Александр Хакимов, я android-разработчик в компании FINCH.

У вас бывало такое, что ваш дизайн был под iOS, а вам приходится адаптировать его под android? Если да, то часто ли ваши дизайнеры используют виджеты? К сожалению, виджет — редкий кейс для многих разработчиков, потому что с ним редко кто работает,

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

Создание виджета

Для создания виджета нужно знать:

Особенности компонентов виджета

С этим пунктом знаком любой разработчик, который хоть раз работал с RemoteViews. Если вы из таких, смело переходите к следующему пункту.

RemoteViews предназначен для описания и управления иерархиями Views, которые принадлежат процессу другого приложения. С помощью управления иерархиями можно изменять свойства или вызывать методы, принадлежащие View, которое выступает частью другого приложения. В RemoteViews входит ограниченный набор компонентов стандартной библиотеки компонентов android.widget.

View внутри виджетов работают в отдельном процессе (как правило, это домашний экран), поэтому для изменения UI виджета используется расширение BroadcastReceiver — AppWidgetProvider, работающий в нашем приложении.

Особенности отображения виджета в «сетке» экрана

Each widget must define a minWidth and minHeight, indicating the minimum amount of space it should consume by default. When users add a widget to their Home screen, it will generally occupy more than the minimum width and height you specify. Android Home screens offer users a grid of available spaces into which they can place widgets and icons. This grid can vary by a device; for example, many handsets offer a 4×4 grid, and tablets can offer a larger, 8×7 grid.

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

Пример настроек виджета при создании в Android Studio

Виджет, который добавили на на Home screen, обычно займет больше места чем минимальные ширина и высота экрана, которые вы задали. Android Home screens предоставляет пользователям сетку доступного пространств, в которых могут быть расположены виджеты и иконки. Эта сетка может отличаться в зависимости от устройства; например, многие телефоны предлагают сетку 4х4, а планшеты могут предложить большие сетки 8х7.

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

Минимальные ширину и высоту виджета для заданного количества столбцов и строк можно вычислить по формуле:

minSideSizeDp = 70 × n − 30, где n —количество строк или столбцов

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

Особенности обновления виджета

Так как AppWidgetProvider по своей сути является расширением BroadcastReceiver-а, с ним можно делать все то же самое, что и с обычным BroadcastReceiver. AppWidgetProvider просто парсит соответствующие поля из Intent, полученного в onReceive и вызывает методы перехвата с полученными extras.

Сложность возникла с частотой обновления контента — все дело в разнице внутренней работы виджетов на iOS и Android. Дело в том, что данные на iOS-виджетах обновляются тогда, когда виджет становится виден пользователю. В Android, такого события не существует. Мы не можем узнать, когда пользователь видит виджет.

Для виджетов на Android рекомендуемым способом обновления является обновление по таймеру. Настройки таймера задаются параметром виджета updatePeriodMillis. К сожалению, эта настройка не позволяет обновлять виджет чаще чем раз в 30 минут. Ниже я расскажу об этом подробнее.

Кейс создания виджета

Дальше речь пойдет о кейсе который был у нас в FINCH в крупном лотерейном приложении с приложением «Столото» для участия в государственных лотереях.

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

В нашем кейсе дизайн виджета предусматривал два состояния:

Как вы могли заметить, еще одной особенностью для авторизованного пользователя является кнопка «обновить», но об этом позже.

Для реализации отображения двух состояний, с учетом дизайна, я использовал RemoteAdapter в виде реализации RemoteViewsService, чтобы генерировать карточки контента.

А теперь немного кода и того, как все работает внутри. Если у вас уже был опыт работы с виджетом, то вы знаете, что любое обновление данных виджета начинается с метода onUpdate:

Пишем апдейт для каждого инстанса нашего виджета.

Пишем реализацию нашего сервиса. В нем нам важно указать, какую реализацию интерфейса RemoteViewsService.RemoteViewsFactory использовать, чтобы генерировать контент.

Фактически это тонкий wrapper над Adapter. Благодаря ему, мы можем связывать наши данные с remote collection view. RemoteViewsFactory предоставляет методы генерации RemoteViews для каждого элемента в наборе данных. У конструктора нет никаких требований — все что я делаю, это передаю в нем контекст.

Далее будет пару слов об основных методах:

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

При вызове команды на обновление данных, так же вызываем updateDataSync()

Внутри updateDataSync тоже все просто. Очищаем текущий список item-ов. Загружаем данные профиля и игры.

Здесь уже поинтереснее

Так как нам важно показывать профиль только авторизованному пользователю, то и информацию профиля нам нужно загружать только в этом случае:

Модель WidgetProfile собирается из разных источников, поэтому логика их получения и её дефолтные значения устроены таким образом, что отрицательное значение кошелька говорит о некорректных данных или проблемах с их получением.

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

Метод updateGamesSync() использует getWidgetGamesInteractor и добавляет в список widgetItems набор актуальных для виджета игр.

Прежде чем перейти к генерации карточек, рассмотрим подробнее модель WidgetItem. Она реализована через kotlin sealed class, что делает модель более гибкой, а работу с ней более удобной.

Создаем RemoteViews и определяем их отклик через FillInIntent

Метод setOnClickFillInIntent назначает указанной viewId intent, который будет объединен с родительским PendingIntent для определения поведения при клике на view с этим viewId. Таким образом, мы сможем реагировать на клики пользователей в нашем WidgetProvider.

Ручное обновление виджета

Для нашего виджета было установлено время обновления в полчаса. Можно обновлять его чаще, например, через танцы с WorkManager, но зачем грузить вашу сеть и аккумулятор? Такое поведение на первых этапах разработки казалось адекватным.

Все изменилось когда «бизнес» обратил внимание, что когда пользователь смотрит на виджет, на нем отображаются неактуальные данные: «Вот на моем iPhone, я открываю виджет и там САМЫЕ свежие данные моего профиля».

Ситуация банальна: iOS генерирует новые карточки при КАЖДОМ показе виджетов, ведь для этого у них отведен специальный экран, а Android не имеет подобных событий для виджета в принципе. Пришлось учесть, что некоторые лотереи проводятся раз в 15 минут, поэтому виджет должен давать актуальную информацию – ты хочешь поучаствовать в каком-то тираже, а он уже прошел.

Чтобы выйти из этой неприятной ситуации и как то решить проблему с обновлением данных, мной было предложено и реализовано проверенное временем решение — кнопка «обновить».

Добавляем эту кнопку в макет layout-a со списком и инициализируем её поведение при вызове updateWidget

Первые наработки показали грустную картину: от нажатия на кнопку «обновить» до фактического обновления, могло пройти несколько секунд. Хотя виджет и генерируется нашим приложением, он фактически находится во власти системы и общается с нашим приложением через broadcast-ы.

Т.е. при нажатии на кнопку «обновить» нашего виджета запускается цепочка:

Во-первых, я добавил флаг isWidgetLoading с глобальным доступом через интерактор. Роль этого параметра довольно проста — не показывать кнопку «обновить», пока идет загрузка данных виджета.

Во вторых, процесс загрузки данных в фабрике я разделил на три этапа:

START — начало загрузки. На этом этапе состояние всех вьюшек адаптера и глобального флага загрузки меняется на «загружается».

MIDDLE — этап основной загрузки данных. После их загрузки глобальный флаг загрузки переводится в состояние «загружено», а в адаптере отображаются загруженные данные.

END — конец загрузки. Адаптеру на этом шаге не требуется изменять данные адаптера. Этот шаг нужен чтобы корректно обработать этап обновления вьюшек в WidgetProvider.

Давайте посмотрим подробнее как теперь выглядит обновление кнопки в провайдере:

А теперь посмотрим на то, что происходит в адаптере:

Надеюсь, что статья была для вас полезной. Если у вас был опыт создания виджетов для Android, то расскажите об этом в комментариях.

Oh, My Droid

Глаза боятся, руки делают!

UCCW – свой собственный виджет

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

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

Создание виджета требует навыков разработки, что приводит к засилию стандартных погодных виджетов на смартфонах большинства пользователей. Ведь где взять уникальный виджет, да еще чтобы на нем была полезная информация? Но не все так печально. Есть решение, которое называется UCCW – Ultimate Custom [Clock] Widget.

Как следует из названия, это универсальный настраиваемый виджет часов, позволяющий создавать собственные информеры с достаточно разнообразной функциональностью. Название UCCW наследовано с ранних версий, когда приложение было ориентировано на виджеты часов. На данный момент, вторая буква «C» в названии никак не расшифровывается, так как приложение вышло из детского возраста и стало иметь более широкие возможности, нежели создание виджетов разнообразных часовых механизмов.

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

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

Пример настройки UCCW

Базовые принципы

После установки приложения UCCW, в списке доступных виджетов появятся заготовки. Это пустышки, которые требуется наполнить контентом.

На данном этапе многие новички удаляют приложение, так как возникает двойное непонимание:

Заготовки бывают разных размеров от 1х1 до 4х4, а в случае использования стороннего ланчера, появляется возможность использовать шаблоны вплоть до 5х2.

Шаблоны виджетов UCCW

На данном этапе требуется установить шаблон на рабочий стол, после чего откроется окно настройки виджета. Где будет предлагаться:

Приглашение к творчеству

uzip – внутренний формат UCCW, в котором хранятся созданные виджеты, позволяет обмениваться скинами между пользователями

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

Откроется основное окно приложения, где по центру расположена подложка виджета, на которую мы и будем добавлять интересующую нас информацию. Но обо всем по порядку:

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

Создаем виджет

Для реализации задуманного, потребуется подготовиться и подобрать иконки для SMS и Звонков.

Подобрать иконки можно на Findicons

Выбираем виджет 2х1 и приступаем к настройкам.

Первым делом добавляем наши иконки, для этого нажимаем +/- и находим там последовательность элементов Image, выбираем Image 1 и Image 2 — это означает, что в виджет будет добавлено два изображения.

Вставка изображений в UCCW

После этого в рабочей области появится две заготовки. Чтобы начать редактировать изображение, нужно войти в меню селектора объектов и там выбрать Image 1 или Image 2, в нижней части появятся элементы управления свойственные для этого объекта.

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

После того как изображение выбрано, можно изменить его размер, для этого служит опция Scale.

Позиционируем его при помощи кнопки Position перемещаем объект на требуемую позицию. Для ускорения процесса, можно активировать пункт Faster movement.

Перемещение объектов в UCCW

Таким образом, позиционируем наши изображения на рабочей области и подбираем для них размер. После чего приступаем к работе с текстовыми объектами.

Для этого добавляем элементы Static Text, аналогично тому, как это было сделано с изображениями.

Редактирование текстовых элементов в UCCW

После добавления текстовых блоков, выбираем их через селектор объектов.
На первой закладке Controls #1 можно изменить размер текста через пункт Size, после чего переходим на третью закладку блока управления Controls #3, где нам нужен пункт Text, в открывшемся окне вводим текст:

После чего возвращаемся на первую закладку и позиционируем текст в соответствии с изображением.

Мы создали статические элементы, которые не изменяются ни при каких условиях, теперь переходим к созданию динамических.

Для добавления информации о пропущенных вызовах и сообщениях, открываем пункт +/- и находим там элементы: Missed Calls и Text Messages, добавляем их на рабочую область,

Размещение данных о пропущеных звонках и смс в UCCW

Все опции для настройки данных элементов совпадают с таковыми для Static Text, поэтому смело меняем размер и позиционируем блоки в соответствии с приложенным рисунком.

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

Добавление активных областей в UCCW виджет

Hotspots — служат для определения областей, в которых будут отрабатываться тапы на виджете и позволяют привязывать к данным действиям определенные события:

Обратите внимание, при добавлении новой активной зоны, она не видна на экране и для её вытаскивания нужно использовать Position, тащить требуется вниз.

После того как она появилась на экране, возможно изменить её размер и назначить действие.

Список действия для Hotspots в UCCW

Для нашего виджета выбираем запуск приложения SMS/MMS в пункте App, для вызова звонилки используем UCCW → Dialer.

Добавление второй зоны производится при нажатии кнопки #1, но это скорее не добавление, а активация предустановленных hotspots.

Добавление виджета в UCCW

После того как вы сделали все настройки, переходим в меню настроек и выбираем Save/Export skin, задаем имя и сохраняем его в системе. После чего нажимаем Hotspots mode и виджет появляется на рабочем столе. Но не обошлось без нюансов. Тап зоны не активны, для их активации нужно удалить виджет, создать новый и при создании выбрать только что сохраненный вариант, на рабочем столе появится иконка с предложением начать редактировать, тап по ней активирует ваш виджет.

Полученный результат: виджет 2х1, который может быть масштабирован стандартными средствами Android 4.x. Создание виджета занимает менее 15 минут времени и позволяет существенно сократить количество установленных в системе программ, заменив их одним универсальным решением в лице UCCW.

Описание элементов UCCW

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

Объекты доступные для добавления

Tasker – автоматизатор частых задач на смартфоне, так называемый «Умный профайлер». Позволяет настраивать поведение смартфона в зависимости от внешних факторов: отключить звук с 23:00 до 07:00; включить Wi-Fi при приближении к дому; выключить синхронизацию данных при нахождении на работе и многое другое.

Общие свойства

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

Общие свойства можно разделить на две группы:

С текстовыми элементами все просто, они обладают одинаковыми настройками и единственное различие между ними, это тип отображаемой информации.

Controls #1

Набор элементов управления на Contorls #1

Controls #2

Набор элементов управления на Contorls #2

Содержит только один пункт — Special Effects, в котором, вроде как, можно выбрать эффекты, которые есть, но их немного — один, реализует что-то вроде частичной прозрачности объекта. В принципе, может быть использован при создании виджетов со стилизацией под постаревшие и поблекшие от времени надписи.

Controls #3

Набор элементов управления на Controls #3

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

Controls #4

Набор элементов управления на Controls #3

В данном пункте производится настройка тени для текста.

Это были базовые методы работы с любыми объектами, теперь перейдем непосредственно к работе с каждым элементом по отдельности. Все элементы можно разбить на логические блоки: Часы, Аккумулятор, Погода, Фигуры, Изображения, Переменные+Tasker.

В этот блок входят все элементы, которые каким-либо образом связаны с временем. Их условно можно разделить на следующие подгруппы:
1. Текстовые — Time, Date, Hour, Minute, Hour/minute separator, Am/Pm, Day of the month, Day of the week, Month, Year, Week of the year, Week bar.
2. Графические — Analog Clock, Series clock, Hour series, Minute series, AMPM series, Day of the month series, Day of the week series, Month series, Year series.

Добавляется Controls #5, в котором возможно выбрать формат времени:

Второй пункт Separator, отвечает за настройку разделителя между часами и минутами. Например, можно совсем убрать разделитель и получить часы в военном стиле ( у американских военных на часах нет разделителя).

Date, Hour, Minute, Am/Pm

Однотипные элементы выводящие информацию о дате, часе и минуте.
Все настройки этих элементов собраны в Controls #5, а самые обширные они у даты.

Варианты настройки даты

Минуты и часы не менее любопытны. Настраиваются они абсолютно одинаково, поэтому рассмотрим их совместно.

Для настройки доступно аж 7 разных закладок. На последней выставляется формат в котором будет отображаться время. Разница между минутами и часами только в том, что форматов для часов предусмотрено больше. Но с ними то все ясно и никаких сложностей нет. Плюс выбирая классические форматы, мы оставляем неактивными вкладки 5 и 6. Присутствует отдельный формат Text, который выводит информацию прописью.

Для входа в режим правки выводимого текста, требуется нажать Custom text и там выбрать Make a custom file вы попадете в окно, где указаны строки с числами от 1 до 24 (или 60 для минут), где можете вписать собственный текст. Чек бокс Broken text позволят делать разрывы в тексте, в таком случае вы сможете настроить каждую часть отдельно.

Более дательно с методами настройки текста можно ознакомиться на скриншотах ниже, а если что-то осталось неясным, — спросить в комментариях.

При этом позволяется сделать до 3-х разрывов текста, в таком случае отображаться они будут поочередно.

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

Второй важный момент, это установка изображения вместо цифр.

Для того чтобы использовать собственные изображения, вы должны подготовить их в формате png и дать имена вида:

после чего данные файлы требуется перенести в папку /sdcard/UltimateCustomClockWidget/image_fonts/ /*.png

После этого файлы появтся в списке и появится возможность их использования.

Использование изображений в элементах Hour и Minutes

Hour/minute separator, Day of the month, Day of the week, Month, Year, Week of the year, Week bar

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

Небольшой интерес представляет Week bar — полоска дней недели, можно использовать для занятия пустого места, плюс неплохо выглядит даже без настроек.

Создайте виджет Android для своего приложения

С первых дней существования ОС виджеты для Android позволяли пользователям взаимодействовать со своими любимыми приложениями, не выходя из рабочего стола. Так как же создать виджет для Android?

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

Виджеты делают ваше приложение заметным на рабочем столе пользователя.

В этой статье я покажу вам, как улучшить взаимодействие с пользователем и при этом побудить пользователей взаимодействовать с вашим приложением, создав виджет Android! К концу этой статьи вы создадите прокручиваемый виджет коллекции, который отображает полный набор данных на главном экране пользователя.

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

Что такое виджеты для Android?

Виджет приложения – это легкое миниатюрное приложение, которое находится на главном экране пользователя.

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

Действительно ли моему проекту нужен виджет приложения?

Есть несколько причин, по которым вам следует подумать о добавлении виджета приложения в свой проект Android.

Виджеты для Android могут улучшить пользовательский опыт

Как правило, чем меньше шагов навигации требуется для выполнения задачи, тем лучше для пользователя.

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

Более мощный, чем ярлыки приложений

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

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

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

Обратите внимание, что виджеты реагируют только на события onClick, что предотвращает случайное взаимодействие пользователей с вашим виджетом при перемещении по домашнему экрану. Единственное исключение – когда пользователь пытается удалить ваш виджет, перетаскивая его к действию «Удалить» на своем домашнем экране, так как в этом сценарии ваш виджет будет реагировать на жест вертикального смахивания.

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

Создайте виджет Android для долгосрочного взаимодействия

Убедить людей загрузить ваше приложение – это только первый шаг к созданию успешного приложения для Android. Скорее всего, если вы возьмете свой собственный смартфон или планшет Android и проведете по панели приложений, то обнаружите несколько приложений, которые вы не использовали дни, недели или даже месяцы!

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

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

Создание виджета приложения-коллекции

В этом руководстве мы создадим виджет коллекции, который отображает массив в виде прокручиваемого ListView.

Чтобы помочь вам отслеживать жизненный цикл виджета приложения, этот виджет также будет запускать различные всплывающие сообщения при прохождении через различные состояния жизненного цикла. Ближе к концу этого руководства мы усовершенствуем наш виджет с помощью настраиваемого изображения предварительного просмотра, которое будет отображаться в средстве выбора виджетов Android, и действия по настройке, которое позволит пользователям настраивать виджет, прежде чем размещать его на своем рабочем столе.

Создайте новый проект Android с настройками по вашему выбору, и приступим!

Создание макета вашего виджета

Для начала давайте определим пользовательский интерфейс (UI) виджета.

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

При создании макета вы ограничены следующим:

Обратите внимание, что подклассы вышеуказанных классов и представлений не поддерживаются.

Создайте новый файл ресурсов макета с именем list_widget.xml. Поскольку мы будем отображать наши данные с помощью ListView, этот макет в основном служит контейнером для элемента :

Заполнение виджета коллекции

Затем нам нужно создать поставщика данных для нашего ListView. Создайте новый класс Java с именем DataProvider.java и добавьте следующее:

AppWidgetProvider: настройка виджета

Чтобы создать виджет Android, вам нужно создать несколько файлов.

Наш первый специфичный для виджета файл – это AppWidgetProvider, представляющий собой BroadcastReceiver, где вы определяете различные методы жизненного цикла виджета, такие как метод, вызываемый при первом создании вашего виджета, и метод, который вызывается, когда этот виджет в конечном итоге удаляется.

Создайте новый класс Java (Файл> Создать> Класс Java) с именем CollectionWidget.

Для начала все файлы поставщиков виджетов должны быть наследниками класса AppWidgetProvider. Затем нам нужно загрузить файл ресурсов макета list_widget.xml в объект RemoteViews и сообщить AppWidgetManager об обновленном объекте RemoteViews:

Создайте адаптер

Поскольку мы отображаем наши данные в ListView, нам нужно определить метод setRemoteAdapter() в нашем AppWidgetProvider. SetRemoteAdapter () эквивалентен вызову AbsListView.setRemoteViewsAdapter (), но предназначен для использования в виджетах приложений.

В этом методе нам нужно определить идентификатор AdapterView (R.id.widget_list) и цель службы, которая в конечном итоге будет предоставлять данные нашему RemoteViewsAdapter – мы скоро создадим этот класс WidgetService.

Определение методов жизненного цикла виджета

В нашем AppWidgetProvider нам также необходимо определить следующие методы жизненного цикла виджета:

Получение нового контента с onUpdate

Метод жизненного цикла виджета onUpdate () отвечает за обновление представлений вашего виджета новой информацией.

Этот метод вызывается каждый раз:

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

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

Когда вы вызываете onUpdate (), вам нужно указать, обновляете ли вы каждый экземпляр этого виджета или только конкретный экземпляр. Если вы хотите обновить каждый экземпляр, вы можете использовать appWidgetIds, который представляет собой массив идентификаторов, который идентифицирует каждый экземпляр на устройстве.

В следующем фрагменте я обновляю каждый экземпляр:

Обратите внимание, что для упрощения кода этот метод onUpdate () в настоящее время не вносит никаких изменений в виджет.

onEnabled: выполнение начальной настройки

Метод жизненного цикла onEnabled () вызывается в ответ на ACTION_APPWIDGET_ENABLED, который отправляется, когда экземпляр вашего виджета добавляется на рабочий стол в первый раз. Если пользователь создает два экземпляра вашего виджета, то onEnabled () будет вызываться для первого экземпляра, но не для второго.

Метод жизненного цикла onEnabled () – это то место, где вы должны выполнить любую настройку, необходимую для всех экземпляров вашего виджета, например, создать базу данных, которая будет передавать информацию о вашем виджете.

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

Обратите внимание: если пользователь удаляет все экземпляры вашего виджета, а затем создает новый экземпляр, то он классифицируется как первый экземпляр, и метод жизненного цикла onEnabled () будет вызван еще раз.

Очистка с помощью onDisabled

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

В этом методе жизненного цикла виджета вы должны очистить все ресурсы, созданные в методе onEnabled (), например, удалив базу данных, созданную в onEnabled ().

Чтобы упростить наш код, я просто буду показывать тост каждый раз, когда запускается этот метод:

Завершенный AppWidgetProvider

Ваш файл CollectionWidget теперь должен выглядеть примерно так:

Файл AppWidgetProviderInfo

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

Файл AppWidgetProviderInfo хранится в папке res / xml вашего проекта.

Если в вашем проекте еще нет этой папки, вам необходимо ее создать:

Затем создайте файл collection_widget_info, который мы будем использовать как наш AppWidgetProviderInfo:

В нашем файле AppWidgetProviderInfo нам нужно определить следующие свойства:

1. android: previewImage

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

Если вы не предоставите previewImage, вместо этого Android будет использовать значок вашего приложения. Чтобы побудить пользователей выбирать ваш виджет из средства выбора виджетов, вы должны предоставить графическое изображение, которое показывает, как ваш виджет будет выглядеть после правильной настройки на главном экране пользователя.

Самый простой способ создать изображение для предварительного просмотра – использовать приложение Widget Preview, которое включено в эмулятор Android. Это приложение позволяет вам настроить виджет, а затем создать изображение, которое затем можно будет использовать в своем проекте Android.

Мы будем создавать это изображение, как только закончим создание нашего виджета, поэтому сейчас я буду использовать автоматически сгенерированный ресурс mipmap / ic_launcher в качестве временного изображения предварительного просмотра.

2. android: widgetCategory

Виджеты приложений должны быть размещены внутри App Widget Host, который обычно является стандартным домашним экраном Android, но также может быть сторонней программой запуска, такой как Evie Launcher или Nova Launcher.

Между уровнями API 17 и 20 можно было размещать виджеты приложений на главном экране или экране блокировки, но поддержка экрана блокировки устарела на уровне API 21.

Вы можете указать, можно ли разместить виджет вашего приложения на главном экране, на экране блокировки (который Android называет «блокировкой клавиатуры») или на обоих, используя атрибут android: widgetCategory. Поскольку в последних версиях Android невозможно разместить виджеты на экране блокировки, мы будем ориентироваться только на домашний экран.

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

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

3. android: initialLayout

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

4. android: resizeMode = “по горизонтали | по вертикали”

Атрибут android: resizeMode позволяет указать, можно ли изменять размер виджета по горизонтали, вертикали или по обеим осям.

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

5. android: minHeight и android: minWidth.

Если размер вашего виджета можно изменять, вам необходимо убедиться, что пользователь не сжимает ваш виджет до такой степени, что он становится непригодным для использования. Вы можете использовать атрибуты minHeight и minWidth, чтобы определить наименьший размер вашего приложения, который будет уменьшаться при изменении его размера пользователем.

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

6. android: updatePeriodMillis

В AppWidgetProviderInfo вы также укажете, как часто ваш виджет должен запрашивать новую информацию.

Наименьший поддерживаемый интервал обновления – один раз в 1800000 миллисекунд (30 минут). Даже если вы объявите более короткий интервал обновления, ваш виджет будет обновляться только каждые полчаса.

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

Вы также должны учитывать, какой контент будет отображать ваш виджет.

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

Чтобы найти этот идеальный баланс, вам может потребоваться протестировать свой виджет в диапазоне частот обновления и измерить влияние на срок службы батареи и своевременность содержимого вашего виджета. Если у вас есть желающая группа тестировщиков, вы можете даже настроить A / B-тестирование, чтобы увидеть, воспринимаются ли одни частоты обновления более положительно, чем другие.

Наконец, как только вы определили идеальный интервал обновления, вы можете использовать более короткий интервал при разработке и тестировании приложения. Например, вы можете использовать самую короткую возможную частоту обновления (android: updatePeriodMillis = “1800000 ″), когда вы проверяете, что метод onUpdate () вашего приложения запускается правильно, а затем измените это значение перед тем, как опубликовать свое приложение для широкой публики.

Завершенный AppWidgetProviderInfo

Готовый файл collection_widget_info.xml должен выглядеть примерно так:

Не загромождайте рабочий стол пользователя!

Чтобы рабочий стол никогда не выглядел загроможденным, мы добавим к нашему виджету отступы и поля. Если ваш проект еще не содержит файла sizes.xml, вам необходимо его создать:

Откройте файл sizes.xml и определите следующие значения полей и отступов:

Отправка данных в виджет

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

Создайте новый класс Java (New> Java Class) с именем WidgetService и добавьте следующее:

Регистрация вашего виджета в Манифесте

Теперь нам нужно внести некоторые изменения в Manifest нашего проекта.

Для начала откройте Manifest и зарегистрируйте свой виджет как BroadcastReceiver. Нам также необходимо добавить фильтр намерений для действия android.appwidget.action.APPWIDGET_UPDATE:

Далее необходимо указать поставщика виджетов приложения:

Наконец, нам нужно объявить службу, которая будет отправлять данные нашему виджету, которым в данном случае является класс WidgetService. Для этой службы требуется разрешение android.permission.BIND_REMOTEVIEWS:

Протестируйте свой виджет

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

Если бы это был реальный Android-проект, вы бы, как правило, расширили бы методы жизненного цикла, в частности метод onUpdate (), но это все, что нам нужно для создания виджета, который вы можете установить и протестировать на своем Android-устройстве:

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

Создание изображения предварительного просмотра виджета Android

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

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

Вы можете быстро и легко создать изображение для предварительного просмотра, используя приложение Widget Preview, входящее в состав эмулятора Android.

Обратите внимание, что предварительный просмотр виджетов не включен в последние образы системы Android, поэтому вам необходимо создать AVD с помощью Nougat (уровень API 25) или более ранней версии:

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

Настраиваемые виджеты: добавление действия конфигурации

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

Есть несколько причин, по которым вы можете захотеть добавить Activity в свой проект.

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

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

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

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

Никто не оценит виджет, который визуально конфликтует с остальной частью рабочего стола!

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

Давайте добавим в наш проект конфигурацию Activity!

Во-первых, нашей конфигурации Activity требуется макет, поэтому создайте новый файл ресурсов макета с именем config_activity.xml.

Я собираюсь добавить в этот макет следующие кнопки:

Вот мой завершенный файл config_activity.xml:

Создайте действие конфигурации

Теперь нам нужно создать нашу конфигурацию Activity.

Для начала создайте новый класс Java с именем ConfigActivity. В этом действии мы собираемся получить идентификатор виджета приложения из намерения, запустившего действие конфигурации. Если у этого намерения нет идентификатора виджета, то нам нужно вызвать метод finish ():

Затем нам нужно создать намерение возврата, передать исходный appWidgetId и установить результаты из Activity конфигурации:

Если вы предоставляете Activity конфигурации, то трансляция ACTION_APPWIDGET_UPDATE не будет отправляться автоматически при запуске Activity конфигурации, что означает, что метод onUpdate () не будет вызываться, когда пользователь создает экземпляр вашего виджета.

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

Вот завершенная ConfigActivity:

После того, как вы создали действие конфигурации, вам нужно объявить это действие в манифесте и указать, что оно принимает действие APPWIDGET_CONFIGURE:

Наконец, поскольку ссылка на Activity конфигурации находится вне области действия пакета, нам необходимо объявить эту Activity в нашем AppWidgetProviderInfo, которым в данном случае является файл collection_widget_info.xml:

Тестирование вашего проекта

Пришло время протестировать готовый проект:

Подведение итогов

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

Если вы хотите продолжить работу с этим проектом, вы можете попробовать добавить свой собственный код в метод onUpdate (), чтобы создать виджет, который обновляется новой информацией с интервалом, определенным в вашем файле AppWidgetProviderInfo (collection_widget_info).

Если вы создаете виджет для Android, не забудьте поделиться своими творениями в комментариях ниже!

Создание виджета для рабочего стола

AppWidget, или просто «виджет» — один из самых эффектных и удобных элементов пользовательского интерфейса в операционной системе Android, который можно добавить на рабочий стол для быстрого доступа к тем или иным функциям соответствующего приложения.

В данной статье мы разберемся, как собственноручно создать свой виджет.

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

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

Начнем создание виджета мы с дизайна. Благо, компания Google предоставила весьма полезные UI Guidelines для разработчиков программного обеспечения, где подробно описан процесс создания дизайна и основные принципы эргономичности. Есть также и отдельная официальная инструкция для создания виджетов, с которой можно ознакомиться по ссылке: http://developer.android.com/guide/practices/ui_guidelines/widget_design.html.

Виджет, занимающий одну «клетку» на рабочем столе, имеет разрешение 80х100 точек, соответственно, для создания продолговатый виджет длиной в 4 клетки и высотой в одну, то нужно, соответственно, 320х100 пикселей. Такой размер мы и возьмем за основу создаваемого нами виджета.

Теперь перейдем к созданию программной части. Виджет может не иметь программной части. Проще говоря, в меню добавления виджетов он будет, но в основном меню приложений – нет. Мы создадим виджет именно такого типа. Создаем новый проект, и называем его для удобства так, чтобы основной класс имел имя widget.java.

Редактируем AndroidManifest.xml. Объявляем наш виджет:

Теперь редактируем widget.java. Тут необходимо описать, как будет реагировать виджет на различные условия. Класс AppWidgetProvider имеет такие методы:

onUpdate – метод вызывается при создании виджета, а также по истечении заданного времени. Время задается в конфигурационном файле данного виджета. Отметим, что используется чаще всего.

onDeleted – метод выполняется при удалении виджета с рабочего стола.

onEnabled – метод вызывается при первой активации виджета. Но если добавляется еще один точно такой же виджет, данный метод уже не выполняется.

onDisabled – метод выполняется тогда, когда удаляется последняя копия виджета с рабочего стола. Соответственно, данный метод является обратным onEnabled.

onReceive – метод вызывается одновременно со всеми остальными. Зачастую не используется вообще.

Сильно углубляться в программную часть виджета мы не будем, а потому не будем переполнять наш пример какими-либо обработчиками, а просто реализуем весь функционал посредством Layouts. Необходимо следующим образом объявить класс AppWidgetProvider:

public class widget extends AppWidgetProvider <

Далее, описываем наш виджет – это нужно для того, чтобы мобильный аппарат понимал, с чем имеет дело. Для этого нужно создать папку xml в папке res. В ней создаем файл с именем widget_info.xml. Открываем созданный файл и прописываем в него вот такой код:

Приведем краткое описание заданных параметров:

minWidth – минимальная необходимая для работы виджета ширина.

minHeight – минимальная необходимая для работы виджета высота.

updatePeriodMillis – период, за который происходит обновления виджета, указывается в миллисекундах. Параметр весьма полезен, так как по истечении указанного временного промежутка срабатываем метод onUpdate объекта AppWidgetProvider.

initialLayout – параметр указывает на ресурс с описанием интерфейса нашего виджета.

Формула подсчета размеров виджета имеет такой вид: (количество клеток * 74) — 2.

Приступим к описанию интерфейса создаваемого нами виджета. Здесь-то нам и пригодится созданный ранее фон. Импортируем рисунок фона в папку dwawable (или во всех три папки drawable для разных разрешений экрана). В папке layout создаем файл с именем widget.xml. Интерфейс описывается как для обычных Activity, но есть некоторые ограничения. Допустимы для использования такие элементы:

Создадим LinearLayout, к которому применим созданную картинку-фон и добавим для примера AnalogClock. Сами часы в рамку не влезут, но как наглядный пример вполне сгодятся. Итак:

Вот, в принципе, и всё. После установки виджета на Android-девайс или на эмулятор, его можно установить на один из рабочих столов. После добавления будем созерцать следующее:

Полный список

— создаем простой виджет
— разбираемся в его Lifecycle

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

Для понимания темы виджетов желательно знать, что такое BroadcastReceiver. Я о нем упоминал в Уроках 96 и 100. Это просто слушатель, который регистрируется в системе, ловит с помощью настроенного Intent Filter сообщения (Intent) и выполняет какой-либо код. Почему-то не сделал я отдельного урока по нему. Но, думаю, еще сделаю. Есть там свои интересные особенности, о которых можно поговорить.

Думаю, нет особой необходимости подробно объяснять, что такое виджеты. Все их видели на своих девайсах. Это что-то типа мини-приложений расположенных на рабочем столе (Home). Они позволяют просмотреть какую-либо информацию из основных приложений, либо повлиять на поведение этих приложений. В качестве примера можно привести – прогноз погоды, текущее время, баланс какого-либо счета, список сообщений в различных мессенджерах, управление состоянием WiFi/3G/GPS/Bluetooth, яркость экрана и т.д. и т.п. В этом уроке сделаем простейший виджет, который отобразит статичный текст.

Чтобы создать простейший виджет нам понадобятся три детали:

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

2) XML-файл c метаданными

В нем задаются различные характеристики виджета. Мы пока что укажем следующие параметры:

— layout-файл (из п.1.), чтобы виджет знал, как он будет выглядеть
— размер виджета, чтобы виджет знал, сколько места он должен занять на экране
— интервал обновления, чтобы система знала, как часто ей надо будет обновлять виджет

3) Класс, наследующий AppWidgetProvider. В этом классе нам надо будет реализовать Lifecycle методы виджета.

Давайте создадим три этих детали. Activity нам не понадобится, поэтому не забудьте убрать галку Create Activity в визарде создания нового проекта

Создадим проект без Activity:

Project name: P1171_SimpleWidget
Build Target: Android 2.3.3
Application name: SimpleWidget
Package name: ru.startandroid.develop.p1171simplewidget

Добавим строки в strings.xml:

Создаем layout-файл widget.xml:

RelativeLayout, а внутри зеленый TextView с текстом по центру. Т.е. виджет просто будет показывать текст на зеленом фоне.

Создаем файл метаданных res/xml/widget_metadata.xml:

В атрибуте initialLayout указываем layout-файл для виджета.

Атрибуты minHeight и minWidth содержат минимальные размеры виджета по высоте и ширине.

Есть определенный алгоритм расчета этих цифр. Как вы наверняка замечали, при размещении виджета, экран делится на ячейки, и виджет занимает одну или несколько из этих ячеек по ширине и высоте. Чтобы конвертнуть ячейки в dp, используется формула 70 * n – 30, где n – это количество ячеек. Т.е. если мы, например, хотим, чтобы наш виджет занимал 2 ячейки в ширину и 1 в высоту, мы высчитываем ширину = 70 * 2 – 30 = 110 и высоту = 70 * 1 – 30 = 40. Эти полученные значения и будем использовать в атрибутах minWidth и minHeight.

Осталось создать класс, наследующий AppWidgetProvider.

onEnabled вызывается системой при создании первого экземпляра виджета (мы ведь можем добавить в Home несколько экземпляров одного и того же виджета).

onUpdate вызывается при обновлении виджета. На вход, кроме контекста, метод получает объект AppWidgetManager и список ID экземпляров виджетов, которые обновляются. Именно этот метод обычно содержит код, который обновляет содержимое виджета. Для этого нам нужен будет AppWidgetManager, который мы получаем на вход.

onDeleted вызывается при удалении каждого экземпляра виджета. На вход, кроме контекста, метод получает список ID экземпляров виджетов, которые удаляются.

onDisabled вызывается при удалении последнего экземпляра виджета.

Во всех методах выводим в лог одноименный текст и список ID для onUpdate и onDeleted.

Осталось немного подрисовать манифест. Добавьте туда ваш класс как Receiver

— укажите для него свои label и icon. Этот текст и эту иконку вы увидите в списке выбираемых виджетов, когда будете добавлять виджет на экран.

— настройте для него фильтр с action = android.appwidget.action.APPWIDGET_UPDATE

— добавьте метаданные с именем android.appwidget.provider и указанием файла метаданных xml/widget_metadata.xml в качестве ресурса

После этого секция receiver в манифесте должна получиться примерно такая:

Виджет готов. Все сохраняем и запускаем. Никаких Activity, разумеется, не всплывет. В консоли должен появиться текст:

\P1171_SimpleWidget\bin\P1171_SimpleWidget.apk installed on device
Done!

Открываем диалог создания виджета и видим в списке наш виджет с иконкой и текстом, которые мы указывали в манифесте для receiver.

Выбираем его и добавляем на экран.

Виджет появился, смотрим логи.

onEnabled
onUpdate [8]

Сработал onEnabled, т.к. мы добавили первый экземпляр виджета. И сразу после добавления, сработал метод onUpdate для этого экземпляра. Видим, что ему назначен (У вас, скорее всего, будет другой ID). Т.е. система добавила экземпляр виджета на экран и вызвала метод обновления с указанием ID экземпляра.

Добавим еще один экземпляр

onEnabled не сработал, т.к. добавляемый экземпляр виджета уже не первый. onUpdate же снова отработал для нового добавленного экземпляра и получил на вход >

Теперь давайте удалим с экрана два этих экземпляра виджета. Сначала второй. В логах увидим:

Сработал onDeleted и получил на вход ID удаляемого экземпляра виджета.

Удаляем первый экземпляр. В логах:

onDeleted [8]
onDisabled

Наш виджет обновляется (получает вызов метода onUpdate) раз в 40 минут. Если кому не лень, добавьте снова пару виджетов на экран и подождите. Когда они снова обновятся, в логах это отразится.

Так создается и работает простой виджет. Пока остановимся на этом, чтобы уложились в голове схема создания виджета и его lifecycle-методы. Из интересного хотелось бы еще отметить пару вещей.

BroadcastReceiver

Класс AppWidgetProvider является расширением класса BroadcastReceiver (в манифесте мы его и прописали как Receiver). Он просто получает от системы сообщение в onReceive, определяет по значениям из Intent, какое именно событие произошло (добавление, удаление или обновление виджета), и вызывает соответствующий метод (onEnabled, onUpdate и пр.).

В манифесте мы для нашего Receiver-класса настроили фильтр с action, который ловит события update. Каким же образом этот Receiver ловит остальные события (например, удаление)? Хелп пишет об этом так:

Т.е. ACTION_APPWIDGET_UPDATE – это единственный action, который необходимо прописать явно. Остальные события AppWidgetManager каким-то образом сам доставит до нашего AppWidgetProvider-наследника.

Отступы

Если мы расположим рядом несколько экземпляров виджета, увидим следующую картину

Не очень приятное зрелище. Надо бы сделать отступ.

Добавим android:padding=»8dp» к RelativeLayout в нашем layout-файле

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

Кстати, для них сработал onUpdate, смотрите логи. В метод был передан массив ID всех работающих экземпляров виджета.

В Android 4.0 (API Level 14) и выше этот недостаток с отступами был устранен, и вручную делать отступы больше не надо. Давайте проверим. Уберите ранее добавленный в RelativeLayout отступ. И укажите в манифесте android:targetSdkVersion версию 14 (или выше), чтобы система знала, что можно использовать стандартные возможности, а не режим совместимости.

Все сохраняем, запускаем наш виджет на эмуляторе с 4.1. Добавим три экземпляра.

Система сама делает отступы между виджетами.

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

В layout для RelativeLayuot указываете:

И создаете два файла.

res/values/dimens.xml с записью:

и res/values-v14/dimens.xml с записью:

В манифесте android:targetSdkVersion должен быть 14 или выше.

Таким образом, на старых версиях (без системного отступа) отступ будет 8dp, а на новых – 0dp и останется только системный отступ.

На следующем уроке:

— настраиваем виджет при размещении
— работаем с view-компонентами виджета при обновлении

Присоединяйтесь к нам в Telegram:

— в канале StartAndroid публикуются ссылки на новые статьи с сайта startandroid.ru и интересные материалы с хабра, medium.com и т.п.

— в чатах решаем возникающие вопросы и проблемы по различным темам: Android, Kotlin, RxJava, Dagger, Тестирование

— ну и если просто хочется поговорить с коллегами по разработке, то есть чат Флудильня

— новый чат Performance для обсуждения проблем производительности и для ваших пожеланий по содержанию курса по этой теме

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

Содержание статьи

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

Проектируем виджет

Цель нашего проекта — создать виджет, который периодически пингует указанные пользователем сайты и выводит соответствующую информацию на домашний экран. Традиционно будем использовать редактор кода Eclipse с плагином ADT.

В андроиде любой виджет представляет собой визуальный компонент, работающий в рамках того приложения, в которое он встраивается (как правило, это домашний экран). Кроме того, виджет умеет выводить устройство из режима ожидания, чтобы отобразить на экране актуальную информацию. Поэтому при разработке виджета нужно свести к минимуму время его обновления (можно, конечно, и пренебречь, но ANR в виджете — это уже моветон). Вполне логично напрашивается некоторый фоновый сервис, который будет пинговать сайты и записывать результат для дальнейшего анализа. Таким образом, задача виджета сведется к извлечению этих данных и выводу информации в виде текстовой строки — ссылки на сайт и некоторой графики — доступности сайта (рис. 1). Также нам потребуется простенькая форма для ввода списка подконтрольных сайтов, то есть GUI. Кстати, настоятельно рекомендую ознакомиться со статьей в мартовском номере «Хакера» «Хакерский Cron на Android», поскольку там подробно рассмотрена работа фонового сервиса.

Рис. 1. Хакерский виджет

Хакер #196. Все о Docker

Ping? Нет, не знаю.

В Java есть замечательный класс InetAddress, имеющий в своем чреве не менее замечательный метод isReachable(). Этот метод проверяет доступность ресурса и принимает в качестве параметра тайм-аут, то есть время, по истечении которого не отвечающий ресурс считается недоступным:

Лаконично, не правда ли? Вся проблема в том, что этот код прекрасно работает в Windows, но в Android’е всегда возвращает false, даже если приложению дать разрешение на доступ в интернет. По непонятной причине для отправки ICMP-пакета (Echo-Request) требуется рут.

Мы же ничего требовать не будем и поступим следующим образом: будем подключаться к сайту по протоколу HTTP и смотреть на код ответа. Если получим код 200 (HTTP OK), значит, сайт жив и работает, в противном случае считаем, что что-то не так (сайт недоступен).

Разрешения

Так как наша цель — сайты в интернете, необходимо получить соответствующие разрешения у пользователя в манифесте проекта (AndroidManifest.xml):

Первая строка запрашивает разрешение на доступ в интернет, тогда как вторая позволяет отслеживать состояние подключения к сети (в терминологии Play Market — «просмотр состояния сети») — если сеть недоступна, пинговать что-либо особого смысла нет. Функция проверки подключения к сети выглядит следующим образом:

Для доступа к сервису управления сетевыми подключениями используется константа Context.CONNECTIVITY_SERVICE, после чего метод getActiveNetworkInfo возвращает объект типа NetworkInfo, который содержит информацию о текущем соединении. Если подключение установлено, метод isConnected вернет true.

SQLite? No. Shared Preferences!

Как ты сам понимаешь, нам необходимо где-то хранить список сайтов и их (не)доступность. Сначала я хотел вновь использовать базу данных SQLite, но решил не повторяться и рассказать о другой полезной технологии Android — общих настройках (Shared Preferences). Общие настройки — довольно простой механизм, основанный на парах «ключ — значение» и предназначенный для сохранения примитивных данных приложения (число, строка, булево значение). С точки зрения Android настройки хранятся в виде обычного XML-файла внутри приватной директории приложения (data/data/имя_пакета/shared_pref/).

Для наших целей напишем небольшой класс (PingPref) для сохранения и чтения данных:

В конструкторе класса нужно вызвать метод getSharedPreferences в контексте приложения, указав имя файла общих настроек и режим доступа. Константа Context.MODE_PRIVATE указывает на то, что файл настроек будет доступен только внутри приложения (Google настоятельно рекомендует использовать только это значение). Каждый сайт будем хранить в двух ключах: siteN_url (ссылка) и siteN_status (доступность). В качестве последней используем число: 1 — сайт жив, 0 — сайт ушел (читай: «его ушли»), –1 — статус не определен (например, в случае отсутствия доступа к сети). Сеттеры (put.String, put.Int) и геттеры со значениями по умолчанию (get.String, get.Int) в пояснениях не нуждаются. Содержимое файла pref.xml в работе представлено на рис. 2.

Рис. 2. Pref.xml трудится

Здесь все просто — несколько полей ввода (EditText) да кнопка (Button). Вся эта красота представлена на рис. 3. Обработчик кнопки (см. Main.java) считывает содержимое полей (применяется коллекция ArrayList) и записывает их в файл общих настроек, используя метод setData описанного выше класса PingPref:

В качестве первоначального статуса доступности сайта, как и условились, устанавливаем –1. В заключение происходит запуск фонового сервиса startService, подробнее о котором поговорим далее.

Рис. 3. GUI такой GUI

Фоновый сервис

Начиная с Android 3.0 (версия API 11), любой функционал, связанный с сетевой активностью, должен обязательно выполняться во вторичном потоке. Любая попытка подобной работы в главном (графическом) потоке приложения приведет к выбросу исключения NetworkOnMainThreadException и немедленному завершению программы. Это правило относится и к фоновому сервису, так как он тоже фактически выполняется в главном потоке. Как ты уже, наверное, догадался (а если нет — срочно покупай мартовский «Хакер»), мы будем использовать IntentService. Данный фоновый сервис берет на себя всю работу по созданию вторичного потока, позволяя нам сосредоточиться непосредственно на функционале.

Для начала зарегистрируем сервис в манифесте:

Основная работа сервиса кипит и бурлит внутри onHandleIntent, текст которого приведен ниже (отладочная печать присутствует):

Так как мы не собираемся в дальнейшем запрашивать каких-либо ресурсов с сайта, в заголовке запроса смело указываем лексему соединения setRequestProperty(«Connection», «close»), то есть после ответа сервер разорвет связь. Метод setConnectTimeout устанавливает тайм-аут соединения и подбирается экспериментально (в моем случае пять секунд при соединении 3G вполне хватило). Возвращаемое методом getResponseCode значение HttpURLConnection.HTTP_OK определяет положительный вердикт функции. Имей в виду: при использовании мобильного доступа к интернету шанс словить IOException и MalformedURLException весьма высок. Это происходит потому, что метод isConnected объекта NetworkInfo не всегда оперативно реагирует на изменение состояния сети, и мы можем прийти в isSiteAvail с отсутствующим соединением. Так что, если внезапно все сайты окажутся недоступными, паниковать, конечно, следует, но не сразу.

Объект HttpURLConnection обрабатывает только те ссылки, которые начинаются с http://, то есть протокол нужно указывать явным образом.

Функция refreshWidget инициирует обновление виджета посредством трансляции (передачи) уникального широковещательного намерения FORCE_WIDGET_UPDATE, которое наш виджет будет отлавливать, так как он является широковещательным приемником. Термин «широковещательность» означает глобальный характер обработки намерений — любое другое приложение может обработать наше намерение, равно как и мы можем подписаться на обработку чужого. Чтобы не было путаницы, намерения должны быть уникальными. Кстати, если например, нужно открыть интернет-ссылку (одно намерение), а в системе установлено несколько браузеров (несколько широковещательных приемников) — появится окно с выбором предпочитаемого. В следующем разделе мы рассмотрим этот механизм более подробно.

Ближе к концу создаем уже знакомое тебе отложенное намерение на повторный запуск сервиса через не менее знакомый менеджер сигнализаций. Только вместо метода set будем использовать setRepeating, а точнее — setInexactRepeating. Последний помогает в некоторой степени уменьшить энергозатраты, собирая для выполнения близкие по времени сигнализации. Поэтому вместо точного интервала мы передаем константу AlarmManager.INTERVALFIFTEEN_MINUTES для опроса сайтов примерно через каждые 15 мин и AlarmManager.INTERVAL_HALF_HOUR (

30 мин) в случае отсутствия соединения для новой попытки. Возможно, ты захочешь указать другие константы объекта AlarmManager: INTERVAL_HOUR (час), INTERVAL_HALF_DAY (12 ч), INTERVAL_DAY (раз в сутки). Замечу, что эти интервалы очень_ условные, и при необходимости соблюдения более точного расписания следует использовать метод setRepeating, но, как уже отмечалось, он более прожорлив. К слову, будить устройство мы не станем — используем AlarmManager.ELAPSED_REALTIME, так как обновление информации для виджета при выключенном экране не только не требуется, но и, вероятно, вызовет укоризненный взгляд коллег из рубрики X-Mobile.

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

Виджет

В Android виджет реализуется в виде широковещательного приемника, реагирующего на некоторые события (строго говоря — намерения(Intent)), для наполнения визуальной разметки актуальными данными по таймеру, с помощью сервиса, по клику и так далее. Разработка виджета начинается с регистрации его класса (PingWidget) в манифесте проекта:

Здесь тег intent-filter содержит минимум одно стандартное действие — android.appwidget.action.APPWIDGET_UPDATE, используемое для обновления содержимого виджета (еще есть DELETED, ENABLED и DISABLED, но они необязательны). Так как обновлять виджет мы будем, во-первых, самостоятельно, во-вторых, в разные моменты времени, добавим еще одно действие — com.example.pinger.FORCE_WIDGET_UPDATE для нашей задачи. Кроме того, нам потребуется отдельный XML-файл, описывающий настройки виджета (файл res\xml\widget_provider.xml):

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

Домашний экран в Android разделен виртуальной сеткой, состоящей из ячеек, размеры которых зависят от физических размеров устройства. Можно сказать, что ярлык приложения на домашнем экране соответствует одной ячейке. Наш виджет будет иметь размеры 4 х 2 или 250 dp x 110 dp (в аппаратно-независимых пикселях). Изменение размеров виджета пользователем мы не планируем, поэтому resizeMode устанавливаем в none.

Атрибут updatePeriodMillis задает минимальный период между обновлениями виджета (в миллисекундах) системой, но нам сейчас он неинтересен, так как виджет мы будем обновлять вручную, как только возникнет такая необходимость. Представь, наш фоновый сервис не запущен, а на рабочем экране висит виджет (типичное состояние устройства после перезагрузки) — Android вызовет процедуру его обновления незамедлительно, а уже потом через updatePeriodMillis миллисекунд. При первом обновлении просто запустим наш сервис, и как только он начнет работать, дальнейшее обновление информации в виджете будет инициировать именно он. Поэтому сейчас смело ставим 86 400 000 (то есть раз в сутки) и двигаемся дальше.

Если ты хочешь, чтобы в меню виджетов вместо иконки приложения красовалась симпатичная картинка (см. рис. 4), добавь ссылку на соответствующий ресурс в формате PNG в атрибуте previewImage. О том, как быстро и просто получить такое превью, читай врезку.

Рис. 4. Меню виджетов

Атрибут initialLayout позволяет указать разметку виджета в формате XML. Да, ты не ошибся, разметка виджета во многом напоминает разметку активности или диалогового окна — те же метки, кнопки, картинки, менеджеры компоновки и прочее. Фрагмент разметки нашего виджета представлен ниже (widget.xml):

Наш виджет состоит из небольших картинок (im1, im2, im3, im4) типа ImageView и текстовых меток (txt1, txt2, txt3, txt4) типа TextView. Для компоновки используем RelativeLayout, то есть все компоненты визуально выровнены друг относительно друга. Разумеется, картинки и надписи мы будем менять при отрисовке виджета. Поле alpha задает непрозрачность виджета в диапазоне от 0 (прозрачный) до 1 (непрозрачный), а вот background позволяет задать картинку для фона с эффектами стекла, бликами и тенями (да, я сторонник скевоморфизма). Для генерации такой текстуры можно воспользоваться онлайн-редакторами, которых в интернете очень много (см. полезные ссылки). Кстати, для правильного масштабирования виджета на разных экранах фон желательно перевести в формат NinePatch, о котором расскажет врезка.

Рис. 5. Виджет на смартфоне, а GitHub-то упал.

Итак, от визуальной стороны виджета (см. рис. 5) плавно переходим к логике его работы (класс PingWidget.java):

NinePatch vs PNG

Изображения формата NinePatch (или растягивающиеся) — это файлы формата PNG, в которых области, предназначенные для масштабирования, помечены явным образом. Android SDK включает в себя визуальный редактор draw9patch, который находится по адресу SDK/Tools/draw9patch.bat.

На рис. 7 ты можешь видеть область растягивания нашего виджета (Patches), помеченную фиолетовым цветом. Какой бы размер виджета ни был, логотип твоего любимого журнала, а также закругленные уголки искажаться не будут. Эта область задается с помощью линеек слева и сверху от изображения. Обрати внимание на рамку толщиной в один пиксель с черными полосами — именно эта информация будет добавлена к исходному изображению.

Рис. 7. Размер — это главное!

На рис. 8 темным цветом показана область для контента (Content). Здесь мы видим, что все наши картинки и текстовые метки будут иметь небольшой отступ от рамки виджета. Эту красоту определяют линейки справа и снизу от изображения.

Рис. 8. Область для контента не уступает

Результат работы сохраняется в формате PNG c добавлением цифры 9 перед расширением файла (например, widget.9.png). При указании ссылки на графический ресурс указывать девятку не нужно (то есть android:background=»@drawable/widget»).

Класс AppWidgetProvider, являющийся широковещательным приемником, предоставляет нам удобные обработчики жизненного цикла виджета: onUpdate и onReceive (есть и другие — onDeleted, onDisabled, onEnabled, но мы их не рассматриваем). Первый вызывается при обновлении интерфейса виджета с периодичностью updatePeriodMillis (см. выше), как и договорились — просто запускаем сервис (как вариант, можно использовать уже полученные, но, возможно, неактуальные данные — все зависит от задачи). Второй, onReceive, срабатывает при получении определенного действия — FORCE_WIDGET_UPDATE, зарегистрированного нами ранее в манифесте проекта. Именно этот код и отвечает за манипуляции с картинками и текстовыми полями в UI виджета. Функция updateWidget сначала запрашивает объект класса AppWidgetManager, который применяется для обновления виджетов и предоставляет информацию о них. В частности, нас интересуют идентификаторы всех виджетов (массив appWidgetIds), ведь их может быть несколько и обновить нужно каждый из них:

В единственном цикле функции drawWidget происходит итерация по всем работающим в данный момент виджетам. Класс RemoteViews используется в качестве компонента для доступа к разметке, размещенной внутри процесса другого приложения (мне одному это напоминает Inject?). Если бы мы работали с активностью или фрагментом, то могли бы использовать вполне обычное findViewById. Но наш виджет работает в рамках домашнего экрана, поэтому для получения доступа к разметке необходимо в конструкторе RemoteViews указать название пакета (context.getPackageName()) и ресурс с разметкой (R.layout.widget). Используя views.setTextViewText и views.setImageViewResource, изменяем надпись и картинку (вспомогательная функция getPicture возвращает ссылку на подходящий ресурс). Как только мы внесли правки по всем строкам, фиксируем их в виджете, вызывая updateAppWidget.

Вместо заключения

Мы проделали большую работу, и наш виджет работает как часы — админ наверняка будет доволен. Но вот один вопрос так и остался не заданным: как остановить периодические запуски сервиса, если он больше не нужен? Спешу тебя обрадовать, в коде приложения (загляни на dvd.xakep.ru или мой сайт) остановка уже реализована с помощью специального флага setStopServiceFlag, срабатывающего в момент нажатия кнопки «Назад» в главной активности приложения (на кнопку «Домой» не распространяется). Обязательно изучи этот вопрос — это и будет твоим домашним заданием.

Превью для виджета

В Play Market живет мегаполезное приложение для разработчиков виджетов — Widget Preview, которое позволяет встроить в себя любой зарегистрированный в системе виджет, после чего делает его снимок. Результат можно сохранить в файл или отправить по почте.

Рис. 6. Так какого цвета платье?