欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  移动技术

Android 桌面Widget开发要点解析(时间日期Widget)

程序员文章站 2023-11-25 10:30:04
最近需要编写一个日期时间的桌面widget用来关联日历程序,以前很少写桌面widget。对这方面技术不是很熟悉,今天花时间重新整理了一下,顺便把编写一个简单时间日期程序过程...

最近需要编写一个日期时间的桌面widget用来关联日历程序,以前很少写桌面widget。对这方面技术不是很熟悉,今天花时间重新整理了一下,顺便把编写一个简单时间日期程序过程记录下来。

桌面widget其实就是一个显示一些信息的工具(现在也有人开发了一些有实际操作功能的widget。例如相机widget,可以直接桌面拍照)。不过总的来说,widget主要功能就是显示一些信息。我们今天编写一个很简单的作为widget,显示时间、日期、星期几等信息。需要显示时间信息,那就需要实时更新,一秒或者一分钟更新一次。

这个时间widget我是参考(android应用开发揭秘)书里面的一个demo例子做的,只是把功能和界面完善了一下。下面是这次的效果图:

Android 桌面Widget开发要点解析(时间日期Widget)

1、继承appwidgetprovider
我们编写的桌面widget需要提供数据更新,这里就需用用到appwidgetprovider,它里面有一些系统回调函数。提供更新数据的操作。appwidgetprovider是brocastreceiver的之类,也就是说它其实本质是一个广播接收器。下面我们看看appwidgetprovider的几个重要的回调方法:

复制代码 代码如下:

class widgetprovider extends appwidgetprovider
{
    private static final string tag="mythou_widget_tag";
    // 没接收一次广播消息就调用一次,使用频繁
    public void onreceive(context context, intent intent)
    {
        log.d(tag, "mythou--------->onreceive");
        super.onreceive(context, intent);
    }

    // 每次更新都调用一次该方法,使用频繁
    public void onupdate(context context, appwidgetmanager appwidgetmanager, int[] appwidgetids)
    {
        log.d(tag, "mythou--------->onupdate");
        super.onupdate(context, appwidgetmanager, appwidgetids);
    }

    // 没删除一个就调用一次
    public void ondeleted(context context, int[] appwidgetids)
    {
        log.d(tag, "mythou--------->ondeleted");
        super.ondeleted(context, appwidgetids);
    }

    // 当该widget第一次添加到桌面是调用该方法,可添加多次但只第一次调用
    public void onenabled(context context)
    {
        log.d(tag, "mythou--------->onenabled");
        super.onenabled(context);
    }

    // 当最后一个该widget删除是调用该方法,注意是最后一个
    public void ondisabled(context context)
    {
        log.d(tag, "mythou--------->ondisabled");
        super.ondisabled(context);
    }
}

其中我们比较常用的是onupdate和ondelete方法。我这里刷新时间使用了一个service,因为要定时刷新服务,还需要一个alarm定时器服务。下面给出我的onupdate方法:
复制代码 代码如下:

public void onupdate(context context, appwidgetmanager appwidgetmanager, int[] appwidgetids)
{
    super.onupdate(context, appwidgetmanager, appwidgetids);
    time time = new time();
    time.settonow();
  //使用service更新时间
    intent intent = new intent(context, updateservice.class);
    pendingintent pendingintent = pendingintent.getservice(context, 0, intent, 0);
   //使用alarm定时更新界面数据
    alarmmanager alarm = (alarmmanager)context.getsystemservice(context.alarm_service);
    alarm.setrepeating(alarmmanager.rtc, time.tomillis(true), 60*1000, pendingintent);
}

2、androidmanifest.xml配置
复制代码 代码如下:

  <application
        android:icon="@drawable/icon"
        android:label="@string/app_name">
        <!-- appwidgetprovider的注册 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>
        <!-- 更新时间的后台服务 mythou-->
        <service android:name="com.owl.mythou.updateservice"></service>

    </application>

androidmanifest主要是配置一个receiver,因为appwidgetprovider就是一个广播接收器。另外需要注意的是,里面需要提供一个action,这个是系统的更新widget的action。还有meta-data里面需要指定widget的配置文件。这个配置文件,需要放到res\xml目录下面,下面我们看看time_widget_config.xml的配置

3、appwidget配置:
复制代码 代码如下:

<?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的最小宽度。根据layout的单元格计算(72*格子数-2)
•android:minheigh 你的widget的最小高度。计算方式和minwidth一样。(对这个不了解可以看我launcher分析文章)
•android:updateperiomillis 使用系统定时更新服务,单位毫秒。

这里需要说明android:updateperiomillis的问题,系统为了省电,默认是30分钟更新一次,如果你设置的值比30分钟小,系统也是30分钟才会更新一次。对于我们做时间widget来说,显然不靠谱。所以只能自己编写一个alarm定时服务更新。

4、更新widget的service服务

复制代码 代码如下:

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对cpu负荷较小
        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);

        //时间图像更新
        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));

        //日期更新,根据日期,计算使用的图片
        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));

        //点击widget,启动日历
        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,因为我的界面时间和日期都是使用图片做的(纯属为了好看点)。所以多了很多根据时间日期计算使用的图片名字的代码,这些就是个人实际处理,这里不多说。
有一点需要说明的是remoteviews
复制代码 代码如下:

remoteviews updateview = new remoteviews(context.getpackagename(), r.layout.time_widget_layout);

从我们的界面配置文件生成一个远程views更新的对象,这个可以在不同进程中操作别的进程的view。因为widget是运行在launcher的进程里面的,而不是一个独立的进程。这也是一种远程访问机制。最后就是加了一个点击桌面widget启动一个程序的功能,也是使用了pendingintent的方法。

编写一个桌面widget主要就是这些步骤,最后补充一点,桌面widget的界面布局只支持一部分android的标准控件,如果需要做复杂widget界面,需要自定义控件。这部分后面有时间再说~