Android widget, part 0.1

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

<?xml version="1.0" encoding="utf-8"?>

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
              android:orientation="vertical"
              android:layout_width="fill_parent"
              android:layout_height="wrap_content"
              android:background="@drawable/bg"> // для красоты это фон окна

    <LinearLayout
            android:layout_alignParentTop="true"
            android:orientation="horizontal"
            android:layout_width="fill_parent"
            android:layout_height="18dip"
            >

        <ImageView
                android:src="@drawable/l" // закругление выделения текущего дня
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                />
        <TextView
                android:id="@+id/cur_day" // имя контрола для доступа в дальнейшем
                android:text="empty_day" // текст-заглушка для тестирования
                android:textSize="14sp"  // размер шрифта, подобран методом тыка
                android:textColor="#FFFFFF" // до соответствия картинке-макету
                android:gravity="center_vertical|left" 
                android:layout_gravity="center_vertical"
                android:singleLine="true"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:background="@drawable/blackbg" 
                />
        <ImageView
                android:src="@drawable/r"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                />
        <TextView
                android:text="other days"
                android:id="@+id/days"
                android:textSize="13sp" // размер шрифта неактивных дней поменьше
                android:textColor="#989898" // тут можно поменять цвет текста
                android:gravity="center_vertical|left"
                android:layout_gravity="center_vertical"
                android:singleLine="true"
                android:layout_width="fill_parent"
                android:layout_height="wrap_content"
                />

    </LinearLayout>

    <LinearLayout  // это часть с крупными цифрами
            android:orientation="horizontal"
            android:layout_width="fill_parent"
            android:layout_height="36dip" // фиксированная высота 36 пикселей
            android:layout_centerVertical="true"
            android:layout_centerInParent="true"
            >
        <LinearLayout  // это место для 2-х цифр для даты
                android:id="@+id/btnDate" // область прижимается к левому краю
                android:orientation="horizontal"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:layout_gravity="center_vertical"
                android:paddingLeft="5dip" // для красоты отступаем немного от края
                >

            <ImageView // первая цифра - десятки дней
                    android:id="@+id/date1"
                    android:src="@drawable/d1" // тестовая дата - "12"
                    android:layout_width="wrap_content"
                    android:layout_height="wrap_content"
                    />
            <ImageView
                    android:id="@+id/date2"
                    android:src="@drawable/d2"
                    android:layout_width="wrap_content"
                    android:layout_height="wrap_content"
                    />
        </LinearLayout>
        <LinearLayout // область для цифр и ":" между часами-минутами
                android:id="@+id/btnTime"
                android:orientation="horizontal"
                android:layout_width="fill_parent" // занимает остаток ширины виджета
                android:layout_height="wrap_content"
                android:gravity="right" // и выравнивает содержимое вправо
                android:layout_gravity="center_vertical"
                android:paddingRight="5dip" // ну и отступ для красоты
                >

            <ImageView
                    android:id="@+id/hour1"
                    android:src="@drawable/d0"
                    android:layout_width="wrap_content"
                    android:layout_height="wrap_content"
                    />
            <ImageView
                    android:id="@+id/hour2"
                    android:src="@drawable/d0"
                    android:layout_width="wrap_content"
                    android:layout_height="wrap_content"
                    />
            <ImageView
                    android:src="@drawable/dd" // для ":" id не нужен
                    android:layout_width="wrap_content"
                    android:layout_height="wrap_content"
                    android:layout_gravity="center_vertical" // выравниваем по центру
                    />
            <ImageView
                    android:id="@+id/min1"
                    android:src="@drawable/d0"
                    android:layout_width="wrap_content"
                    android:layout_height="wrap_content"
                    />
            <ImageView
                    android:id="@+id/min2"
                    android:src="@drawable/d0"
                    android:layout_width="wrap_content"
                    android:layout_height="wrap_content"
                    />
        </LinearLayout>

    </LinearLayout>

    <LinearLayout // то же, что и с днями
            android:layout_alignParentBottom="true"
            android:orientation="horizontal"
            android:layout_width="fill_parent"
            android:layout_height="18dip"
            >
        <ImageView
                android:src="@drawable/l"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                />
        <TextView
                android:id="@+id/cur_month"
                android:text="empty_month"
                android:textSize="14sp"
                android:textColor="#FFFFFF"
                android:gravity="center_vertical|left"
                android:layout_gravity="center_vertical"
                android:singleLine="true"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:background="@drawable/blackbg"
                />
        <ImageView
                android:src="@drawable/r"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                />
        <TextView
                android:text="other months"
                android:id="@+id/months"
                android:textSize="13sp"
                android:textColor="#989898"
                android:gravity="center_vertical|left"
                android:layout_gravity="center_vertical"
                android:singleLine="true"
                android:layout_width="fill_parent"
                android:layout_height="wrap_content"
                />
    </LinearLayout>

</LinearLayout>

Похоже это окончательный вариант разметки виджета:

по высоте ровно 72 пиксела, все хорошо видно.. Можно приступать собственно к виджету

Виджет описывается xml-файлом в папке res/xml, скажем widget.xml:

<?xml version="1.0" encoding="utf-8"?>

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="294dip"
    android:minHeight="72dip"
    android:updatePeriodMillis="86400000"
    android:initialLayout="@layout/main"
/>

Параметров немного – максимальный размер (высчитанный по формуле из предположения, что займет 4 область 4 * 1 клетки на экране), время между обновлениями (не может быть меньше 30 минут, так что бесполезный параметр в данном случае) и файл с описанием разметки виджета (который уже сделан и протестирован).

Затем надо создать новый класс, скажем с именем SimpleClockClass, и добавить его описание в манифест:

    <receiver android:name=".SimpleClockClass" android:label="Simple Clock Widget">
        <intent-filter>
            <action android:name="android.appwidget.action.APPWIDGET_UPDATE"/>
        </intent-filter>
        <meta-data android:name="android.appwidget.provider"
                   android:resource="@xml/widget"/>
    </receiver>

здесь говорится: “есть класс SimpleClockClass, который реагирует на сообщение APPWIDGET_UPDATE, данные о нем – в файле res/xml/widget, имейте его в виду, когда система будет обновлять свои виджеты”.. Ну что-то типа такого..

Создаем новый класс:

package info.hamster.simpleclock.widget;

import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.Context;

public class SimpleClockClass extends AppWidgetProvider {
    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        super.onUpdate(context, appWidgetManager, appWidgetIds);
    }
}

Тут все очень простенько – наш класс наследуется от AppWidgetProvider и пока ничего не делает. Зато виджет можно скомпилировать, загрузить в телефон/эмулятор и добавить на рабочий стол и посмотреть, что все работает:

Упс.. что-то не так с высотой, да и фон не украшает ни разу.. Не знаю, в чем там дело с высотой, в разметке стоит “по содержимому”, меняем на точный размер, ну и удаляем фон, как-то так:

<?xml version="1.0" encoding="utf-8"?>

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
              android:orientation="vertical"
              android:layout_width="fill_parent"
              android:layout_height="72dip">

    <LinearLayout ...

Так лучше; тут я логику не понял: я как-будто бы сказал системе, что я не вылезу за 294*72 прямоугольник, логично как-бы, что wrap_content должен вписывать лайоут в эти рамки.. а вписывает черти-как..

Дальше – пора удалять тестовое активити, которое помогало отладить разметку виджета; удалить надо сам java файл и упоминание о нем в манифесте; вместо этого добавим “фичу”, которая обычно встречается – при добавлении виджета на рабочий стол покажем экран настроек виджета. Делается просто: сначала разметка – это будет типичный экран настроек, такой, как у самого телефона, создаем файл в res/xml, называем его скажем config.xml:

<?xml version="1.0" encoding="utf-8"?>

<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">
    <PreferenceCategory
            android:title="Отображение">
        <CheckBoxPreference
                android:title="12/24 формат времени"
                android:defaultValue="false"
                android:summary="Использовать 24-часовой формат"
                android:key="timeFormat"/>
        </PreferenceCategory>
    <PreferenceCategory
            android:title="Поведение">
        <ListPreference
                android:title="Тап по часам"
                android:summary="Действие при тапе по часам"
                android:key="clockAction"
                android:defaultValue="0"/>
        <ListPreference
                android:title="Тап по дате"
                android:summary="Действие при тапе по дате"
                android:key="dateAction"
                android:defaultValue="0"/>

    </PreferenceCategory>
</PreferenceScreen>

Что тут: 2 раздела (красоты ради), в “Отображении” настройка показа времени – в 12 или 24-часовом формате; в “Поведении” 2 списка – какую программу запускать при тапе на дате и времени. Делаем новую активити, с именем класса ConfigClass:

package info.hamster.simpleclock.widget;

import android.os.Bundle;
import android.preference.PreferenceActivity;

public class ConfigClass extends PreferenceActivity {
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        addPreferencesFromResource(R.xml.config);
    }
}

Класс наследуется от PreferenceActivity – это даст нужный внешний вид и поведение, разметка берется из config.xml. В манифест добавляется соотв. запись:

        <activity android:name=".Settings" android:label="Settings Activity">
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_CONFIGURE"/>
                <action android:name="android.intent.action.VIEW"/>
            </intent-filter>
        </activity>

что значит – активити является настроечной для виджета, кроме этого в widget.xml надо добавить строчку с указанием, какой класс отвечает за конфигурирование:

<?xml version="1.0" encoding="utf-8"?>

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="294dip"
    android:minHeight="72dip"
    android:updatePeriodMillis="86400000"
    android:initialLayout="@layout/main"
    android:configure="info.hamster.simpleclock.widget.ConfigClass"
/>

Компилируем, загружаем в телефон/эмулятор, добавляем виджет на рабочий стол – оп:

Правда не стоит тапать по спискам – надо допиливать еще, а так будет “Sorry.. blahblahblah has stopped”. И еще надо придумать механизм для завершения настройки

Завершение настройки – тут просто, надо добавить в Config меню, с единственным пунктом Save settings или типа того (ну не обязательно пункт должен быть один – About, Visit us.. тоже могут присутствовать). В res/menu создаем xml файл с описанием меню:

<?xml version="1.0" encoding="utf-8"?>

<menu xmlns:android="http://schemas.android.com/apk/res/android">
<item android:id="@+id/save_settings"
          android:icon="@android:drawable/ic_menu_preferences"
          android:title="Сохранить настройки" />
</menu>

в ConfigClass переопределяем метод:

    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        MenuInflater inflater = getMenuInflater();
        inflater.inflate(R.menu.menu, menu);
        return true;
    }

проверяем в эмуляторе – добавляем виджет и в окне настроек жмем кнопку Menu:

Иконка на кнопке – стандартная (потому что в menu.xml указали android:icon="@android:drawable/ic_menu_preferences")

Теперь делаем следующее: когда экран настроек создается, надо запомнить id виджета (потому что в теории их ведь может быть несколько одинаковых на рабочем слоте), и установить результат создания активити как Cancelled, а после выбора “Сохранить настроки” установить результат работы активити как RESULT_OK и закрыть ее; так что ConfigClass меняем:

    int mAppWidgetId = AppWidgetManager.INVALID_APPWIDGET_ID;

    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        addPreferencesFromResource(R.xml.config);

        Bundle extras = getIntent().getExtras();
        if (extras != null) {
            mAppWidgetId = extras.getInt(
                    AppWidgetManager.EXTRA_APPWIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID);
        }
        setResult(RESULT_CANCELED);
    }
...
    @Override
    public boolean onOptionsItemSelected(MenuItem item) {
        switch (item.getItemId()) {
            case R.id.save_settings:
                Intent resultValue = new Intent();
                resultValue.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, mAppWidgetId);
                setResult(RESULT_OK, resultValue);
                finish();
            default:
                return super.onOptionsItemSelected(item);
        }
    }

Проверяем – добавляем виджет на рабочий стол, появляется экран настроек, вызываем меню, выбираем “Сохранить настройки” – виджет появляется на столе, если же нажать на Home или Back – нет; как и задумано

Теперь надо заполнить списки приложениями, которые можно запускать по тапу, ну и сохранить выбранные значения; PreferenceActivity автоматом сохраняет выбранные в нем значения в переменные с одноименными (с контролами в окне настроек) именами в SharedPreferences, хранилище настроек (ну и вообще данных) для приложения. Код:

  final SharedPreferences prefs = PreferenceManager.getDefaultSharedPreferences(getBaseContext());

  final ListPreference listClockActions = (ListPreference) findPreference("clockAction");
  final ListPreference listDateActions = (ListPreference) findPreference("dateAction");
  // это элементы управления из окна настроек, нашли их по 
  // имени, заданному в xml файле

  final Intent mainIntent = new Intent(Intent.ACTION_MAIN, null);
  mainIntent.addCategory(Intent.CATEGORY_LAUNCHER);
  final List<ResolveInfo> pkgAppsList = this.getPackageManager().queryIntentActivities(mainIntent, 0);

  // тут список приложений; для запуска и отображения мне надо 3 параметра
  // Красивое название приложения
  // package name - имя приложения собственно для запуска
  // activity name - активити, которое надо вызвать
  // тупо делаю 3 массива
        my_list = new String[pkgAppsList.size()];
        my_list2 = new String[pkgAppsList.size()];
        my_list3 = new String[pkgAppsList.size()];

        int i = 0;
        PackageManager pm = this.getPackageManager();

        for (ResolveInfo info : pkgAppsList) {
            my_list[i] = info.loadLabel(pm).toString();
            my_list2[i] = info.activityInfo.packageName;
            my_list3[i++] = info.activityInfo.name;
        }

        listClockActions.setEntries(my_list);
        listClockActions.setEntryValues(my_list2);
        listDateActions.setEntries(my_list);
        listDateActions.setEntryValues(my_list2);
  // выбранное значение из списка сохранится автоматически, а вот 
  // имя активити - нет, надо его сохранить отдельно в том же хранилище
        listClockActions.setOnPreferenceChangeListener(
                new Preference.OnPreferenceChangeListener() {
                    public boolean onPreferenceChange(Preference preference, Object o) {

                        int i = ((ListPreference) preference).findIndexOfValue(o.toString());

                        // для записи в preferences создаем редактор и коммитим изменения потом
                        SharedPreferences.Editor editor = prefs.edit();
                        editor.putString("clockActivity", my_list3[i]);
                        editor.commit();

                        return true;
                    }
                }
        );

        listDateActions.setOnPreferenceChangeListener(
                new Preference.OnPreferenceChangeListener() {
                    public boolean onPreferenceChange(Preference preference, Object o) {

                        int i = ((ListPreference) preference).findIndexOfValue(o.toString());

                        SharedPreferences.Editor editor = prefs.edit();
                        editor.putString("dateActivity", my_list3[i]);
                        editor.commit();

                        return true;
                    }
                }

        );

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

Это все делалось с ConfigClass.java; возвращаемся к SimpleClockClass.java, Пока в нем не делается ничего полезного, обьявлен к переопределению один метод, onUpdate; дописываем:

@Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {

        final int N = appWidgetIds.length;
        SharedPreferences prefs = PreferenceManager.getDefaultSharedPreferences(context);

        // настроки у виджета общие (если будет неск. экземпляров на рабочем столе), так что
        // перебираем все
        for (int i = 0; i < N; i++) {
            int appWidgetId = appWidgetIds[i];

            // читаю из хранилища значение для clockAction - так называется
            // список в окне настроек, в котором выбираем программу для запуска после
            // тапа по времени
            final String clockActionPackage = prefs.getString("clockAction", "");
            Intent intent = null;

            intent = new Intent(Intent.ACTION_MAIN);
            // clockActivity мы сохранили "вручную"
            ComponentName name = new ComponentName(clockActionPackage, prefs.getString("clockActivity", ""));

            // теперь магия - до конца еще не осознал ее
            // делаем "отложенное намерение" - запустить программу по имени пакета и активити
            intent.addCategory(Intent.CATEGORY_LAUNCHER);
            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED);
            intent.setComponent(name);
            PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);

            // ищем "окно" нашего виджета таким вот способом
            RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.main);
            // и говорим - "если будет клик по элементу btnTime (а это лайоут в лайоуте в лайоуте,
            // а в нем самом - 5 "картинок" с изображением цифр и ":" между часами и минутами)
            // то хочу наконец выполнить давно отложенное намерение".. ну типа того
            views.setOnClickPendingIntent(R.id.btnTime, pendingIntent);

            final String dateActionPackage = prefs.getString("dateAction", "");

            intent = new Intent(Intent.ACTION_MAIN);
            name = new ComponentName(dateActionPackage, prefs.getString("dateActivity", ""));

            intent.addCategory(Intent.CATEGORY_LAUNCHER);
            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED);
            intent.setComponent(name);
            pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);

            views.setOnClickPendingIntent(R.id.btnDate, pendingIntent);

            // ну и обновляем виджет по id
            appWidgetManager.updateAppWidget(appWidgetId, views);
        }
    }

Проверяем – запускаем, настраиваем, применяем, тапаем, смотрим – запускается.. Ну и нормально

Проект в текущем состоянии - здесь