Android 桌面Widget開(kāi)發(fā)要點(diǎn)解析(時(shí)間日期Widget)

2020-04-11 12:04:13

字體：大中小

供稿：網(wǎng)友

最近需要編寫(xiě)一個(gè)日期時(shí)間的桌面Widget用來(lái)關(guān)聯(lián)日歷程序，以前很少寫(xiě)桌面Widget。對(duì)這方面技術(shù)不是很熟悉，今天花時(shí)間重新整理了一下，順便把編寫(xiě)一個(gè)簡(jiǎn)單時(shí)間日期程序過(guò)程記錄下來(lái)。

桌面Widget其實(shí)就是一個(gè)顯示一些信息的工具（現(xiàn)在也有人開(kāi)發(fā)了一些有實(shí)際操作功能的widget。例如相機(jī)widget，可以直接桌面拍照）。不過(guò)總的來(lái)說(shuō)，widget主要功能就是顯示一些信息。我們今天編寫(xiě)一個(gè)很簡(jiǎn)單的作為widget，顯示時(shí)間、日期、星期幾等信息。需要顯示時(shí)間信息，那就需要實(shí)時(shí)更新，一秒或者一分鐘更新一次。

這個(gè)時(shí)間Widget我是參考（Android應(yīng)用開(kāi)發(fā)揭秘）書(shū)里面的一個(gè)demo例子做的，只是把功能和界面完善了一下。下面是這次的效果圖：

1、繼承AppWidgetProvider
我們編寫(xiě)的桌面Widget需要提供數(shù)據(jù)更新，這里就需用用到AppWidgetProvider，它里面有一些系統(tǒng)回調(diào)函數(shù)。提供更新數(shù)據(jù)的操作。AppWidgetProvider是BrocastReceiver的之類(lèi)，也就是說(shuō)它其實(shí)本質(zhì)是一個(gè)廣播接收器。下面我們看看AppWidgetProvider的幾個(gè)重要的回調(diào)方法：

復(fù)制代碼代碼如下:

class WidgetProvider extends AppWidgetProvider 
{
    private static final String TAG="mythou_Widget_Tag";
    // 沒(méi)接收一次廣播消息就調(diào)用一次，使用頻繁
    public void onReceive(Context context, Intent intent) 
    {
        Log.d(TAG, "mythou--------->onReceive");
        super.onReceive(context, intent);
    }

    // 每次更新都調(diào)用一次該方法，使用頻繁
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) 
    {
        Log.d(TAG, "mythou--------->onUpdate");
        super.onUpdate(context, appWidgetManager, appWidgetIds);
    }

    // 沒(méi)刪除一個(gè)就調(diào)用一次
    public void onDeleted(Context context, int[] appWidgetIds) 
    {
        Log.d(TAG, "mythou--------->onDeleted");
        super.onDeleted(context, appWidgetIds);
    }

    // 當(dāng)該Widget第一次添加到桌面是調(diào)用該方法，可添加多次但只第一次調(diào)用
    public void onEnabled(Context context) 
    {
        Log.d(TAG, "mythou--------->onEnabled");
        super.onEnabled(context);
    }

    // 當(dāng)最后一個(gè)該Widget刪除是調(diào)用該方法，注意是最后一個(gè)
    public void onDisabled(Context context) 
    {
        Log.d(TAG, "mythou--------->onDisabled");
        super.onDisabled(context);
    }
}

其中我們比較常用的是onUpdate和onDelete方法。我這里刷新時(shí)間使用了一個(gè)Service，因?yàn)橐〞r(shí)刷新服務(wù)，還需要一個(gè)Alarm定時(shí)器服務(wù)。下面給出我的onUpdate方法：

復(fù)制代碼代碼如下:

public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) 
{
    super.onUpdate(context, appWidgetManager, appWidgetIds);
    Time time = new Time();
    time.setToNow();
　　//使用Service更新時(shí)間
    Intent intent = new Intent(context, UpdateService.class);
    PendingIntent pendingIntent = PendingIntent.getService(context, 0, intent, 0);
　　 //使用Alarm定時(shí)更新界面數(shù)據(jù)
    AlarmManager alarm = (AlarmManager)context.getSystemService(Context.ALARM_SERVICE);
    alarm.setRepeating(AlarmManager.RTC, time.toMillis(true), 60*1000, pendingIntent);
}

2、AndroidManifest.xml配置

復(fù)制代碼代碼如下:

  <application 
        android:icon="@drawable/icon" 
        android:label="@string/app_name">
        <!-- AppWidgetProvider的注冊(cè) mythou-->
        <receiver 
            android:label="@string/app_name_timewidget" 
            android:name="com.owl.mythou.TimeWidget">
                <intent-filter>
                    <action android:name="android.appwidget.action.APPWIDGET_UPDATE"></action>
                </intent-filter>
                <meta-data 
　　　　　　　　　　　　android:name="android.appwidget.provider" 
　　　　　　　　　　　　android:resource="@xml/time_widget_config">
　　　　　　　　  </meta-data>
        </receiver>
        <!-- 更新時(shí)間的后臺(tái)服務(wù) mythou-->
        <service android:name="com.owl.mythou.UpdateService"></service>

    </application>

AndroidManifest主要是配置一個(gè)receiver，因?yàn)锳ppWidgetProvider就是一個(gè)廣播接收器。另外需要注意的是，里面需要提供一個(gè)action，這個(gè)是系統(tǒng)的更新widget的action。還有meta-data里面需要指定widget的配置文件。這個(gè)配置文件，需要放到res/xml目錄下面，下面我們看看time_widget_config.xml的配置

3、appWidget配置：

復(fù)制代碼代碼如下:

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider
  xmlns:android="http://schemas.android.com/apk/res/android"
  android:initialLayout="@layout/time_widget_layout"
  android:minWidth="286dip" 
  android:minHeight="142dip" 
  android:updatePeriodMillis="0">
</appwidget-provider>

•android:initialLayout 指定界面布局的Layout文件，和activity的Layout一樣
•android:minWidth 你的widget的最小寬度。根據(jù)Layout的單元格計(jì)算（72*格子數(shù)-2）
•android:minHeigh 你的widget的最小高度。計(jì)算方式和minwidth一樣。（對(duì)這個(gè)不了解可以看我Launcher分析文章）
•android:updatePerioMillis 使用系統(tǒng)定時(shí)更新服務(wù)，單位毫秒。

這里需要說(shuō)明android:updatePerioMillis的問(wèn)題，系統(tǒng)為了省電，默認(rèn)是30分鐘更新一次，如果你設(shè)置的值比30分鐘小，系統(tǒng)也是30分鐘才會(huì)更新一次。對(duì)于我們做時(shí)間Widget來(lái)說(shuō)，顯然不靠譜。所以只能自己編寫(xiě)一個(gè)Alarm定時(shí)服務(wù)更新。

4、更新Widget的Service服務(wù)

復(fù)制代碼代碼如下:

class UpdateService extends Service
{
    @Override
    public void onStart(Intent intent, int startId) 
    {
        super.onStart(intent, startId);
        UpdateWidget(this);
    }
    private void UpdateWidget(Context context) 
    {    
        //不用Calendar，Time對(duì)cpu負(fù)荷較小
        Time time = new Time();
        time.setToNow();
        int hour = time.hour;
        int min = time.minute;
        int second = time.second;
        int year = time.year;
        int month = time.month+1;
        int day = time.monthDay;
        String strTime = String.format("%02d:%02d:%02d %04d-%02d-%02d", hour, min, second,year,month,day);
        RemoteViews updateView = new RemoteViews(context.getPackageName(),
                R.layout.time_widget_layout);

        //時(shí)間圖像更新
        String packageString="org.owl.mythou";
        String timePic="time";
        int hourHbit = hour/10;
        updateView.setImageViewResource(R.id.hourHPic, getResources().getIdentifier(timePic+hourHbit, "drawable", packageString));
        int hourLbit = hour%10;
        updateView.setImageViewResource(R.id.hourLPic, getResources().getIdentifier(timePic+hourLbit, "drawable", packageString));
        int minHbit = min/10;
        updateView.setImageViewResource(R.id.MinuteHPic, getResources().getIdentifier(timePic+minHbit, "drawable", packageString));
        int minLbit = min%10;
        updateView.setImageViewResource(R.id.MinuteLPic, getResources().getIdentifier(timePic+minLbit, "drawable", packageString));

        //星期幾
        updateView.setTextViewText(R.id.weekInfo, getWeekString(time.weekDay+1));

        //日期更新，根據(jù)日期，計(jì)算使用的圖片
        String datePic="date";
        int year1bit = year/1000;
        updateView.setImageViewResource(R.id.Year1BitPic, getResources().getIdentifier(datePic+year1bit, "drawable", packageString));
        int year2bit = (year%1000)/100;
        updateView.setImageViewResource(R.id.Year2BitPic, getResources().getIdentifier(datePic+year2bit, "drawable", packageString));
        int year3bit = (year%100)/10;
        updateView.setImageViewResource(R.id.Year3BitPic, getResources().getIdentifier(datePic+year3bit, "drawable", packageString));
        int year4bit = year%10;
        updateView.setImageViewResource(R.id.Year4BitPic, getResources().getIdentifier(datePic+year4bit, "drawable", packageString));
        //月
        int mouth1bit = month/10;
        updateView.setImageViewResource(R.id.mouth1BitPic, getResources().getIdentifier(datePic+mouth1bit, "drawable", packageString));
        int mouth2bit = month%10;
        updateView.setImageViewResource(R.id.mouth2BitPic, getResources().getIdentifier(datePic+mouth2bit, "drawable", packageString));
        //日
        int day1bit = day/10;
        updateView.setImageViewResource(R.id.day1BitPic, getResources().getIdentifier(datePic+day1bit, "drawable", packageString));
        int day2bit = day%10;
        updateView.setImageViewResource(R.id.day2BitPic, getResources().getIdentifier(datePic+day2bit, "drawable", packageString));

        //點(diǎn)擊widget，啟動(dòng)日歷
        Intent launchIntent = new Intent();
        launchIntent.setComponent(new ComponentName("com.mythou.mycalendar",
                "com.mythou.mycalendar.calendarMainActivity"));
        launchIntent.setAction(Intent.ACTION_MAIN);
        launchIntent.addCategory(Intent.CATEGORY_LAUNCHER);
        launchIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK
                | Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED);
        PendingIntent intentAction = PendingIntent.getActivity(context, 0,
                launchIntent, 0);
        updateView.setOnClickPendingIntent(R.id.SmallBase, intentAction);
        AppWidgetManager awg = AppWidgetManager.getInstance(context);
        awg.updateAppWidget(new ComponentName(context, TimeWidgetSmall.class),
                updateView);
    }
}

上面就是我的Service，因?yàn)槲业慕缑鏁r(shí)間和日期都是使用圖片做的（純屬為了好看點(diǎn)）。所以多了很多根據(jù)時(shí)間日期計(jì)算使用的圖片名字的代碼，這些就是個(gè)人實(shí)際處理，這里不多說(shuō)。
有一點(diǎn)需要說(shuō)明的是RemoteViews

復(fù)制代碼代碼如下:

RemoteViews updateView = new RemoteViews(context.getPackageName(), R.layout.time_widget_layout);

從我們的界面配置文件生成一個(gè)遠(yuǎn)程Views更新的對(duì)象，這個(gè)可以在不同進(jìn)程中操作別的進(jìn)程的View。因?yàn)閃idget是運(yùn)行在Launcher的進(jìn)程里面的，而不是一個(gè)獨(dú)立的進(jìn)程。這也是一種遠(yuǎn)程訪問(wèn)機(jī)制。最后就是加了一個(gè)點(diǎn)擊桌面Widget啟動(dòng)一個(gè)程序的功能，也是使用了PendingIntent的方法。

編寫(xiě)一個(gè)桌面Widget主要就是這些步驟，最后補(bǔ)充一點(diǎn)，桌面Widget的界面布局只支持一部分android的標(biāo)準(zhǔn)控件，如果需要做復(fù)雜widget界面，需要自定義控件。這部分后面有時(shí)間再說(shuō)~

上一篇：Android GPS定位測(cè)試(附效果圖和示例)

下一篇：Android 如何收集已發(fā)布程序的崩潰信息