桌面组件widget

前几天学习下了桌面组件开发,现将学习心得跟大家交流下,欢迎探讨!

一、 概述

要进行桌面组件Widget开发,首先要了解AppWidget框架结构。AppWidget是Android 1.5平台推出的一种崭新的应用程序框架。基于AppWidget框架,开发人员可以在OPhone及模拟器上开发形似传统widget的小应用程序,并将其嵌入到其他应用中。

二、AppWidet框架

1、AppWidgetProvider :继承自 BroadcastRecevier , 在AppWidget 应用 update、enable、disable 和 delete 时接收通知。其中,onUpdate、onReceive 是最常用到的方法,它们接收更新通知。 下面对AppWidgetProvider类常用到的方法进行介绍:

(1)onDeleted(Context context, int[]appWidgetIds)

(2)onDisabled(Context context)

(3)onEnabled(Context context)

(4)onReceive(Context context, Intentintent)

Tip:因为 AppWidgetProvider 是继承自BroadcastReceiver 所以可以重写onRecevie 方法,当然必须在后台注册Receiver

(5)onUpdate(Context context,AppWidgetManager appWidgetManager, int[] appWidgetIds)

2、 AppWidgetProvderInfo:描述 AppWidget 的大小、更新频率和初始界面等信息,以XML 文件形式存在于应用的res/xml/目录下。

3、AppWidgetManger :负责管理 AppWidget ,向 AppwidgetProvider 发送通知。 下面对AppWidgetManger 类中主要方法进行介绍:

(1)bindAppWidgetId(int appWidgetId,ComponentName provider)

通过给定的ComponentName 绑定appWidgetId

(2)getAppWidgetIds(ComponentNameprovider)

通过给定的ComponentName 获取AppWidgetId

(3)getAppWidgetInfo(int appWidgetId)

通过AppWidgetId 获取 AppWidget 信息

(4)getInstalledProviders()

返回一个List的信息

(5)getInstance(Context context)

获取 AppWidgetManger 实例使用的上下文对象

(6)updateAppWidget(int[] appWidgetIds,RemoteViews views)

通过appWidgetId 对传进来的 RemoteView 进行修改,并重新刷新AppWidget 组件

(7)updateAppWidget(ComponentNameprovider, RemoteViews views)

通过 ComponentName 对传进来的 RemoeteView 进行修改,并重新刷新AppWidget 组件

(8)updateAppWidget(int appWidgetId,RemoteViews views)

通过appWidgetId 对传进来的 RemoteView 进行修改,并重新刷新AppWidget 组件

4、RemoteViews :一个可以在其他应用进程中运行的类,向 AppWidgetProvider 发送通知。这是构造AppWidet的核心。

三、Widget示例:WidgetDemo

下面改写一个倒计时Demo,该Widget背景图能定时更新。

先看下程序运行效果图:

1、 新建一个Android工程,命名为WidgetDemo

2、 修改string.xml文件如下:





    Hello World, WidgetDemo!

    DaysToMay1ST



3、 修改main.xml布局文件。

由于Widget是一个实现在桌面的小应用程序,对UI的设计要求高,其中包括大小的计算和界面是否适合屏幕的布局等。所以首先要建立RemoteViews对应的布局文件main.xml。

代码如下:











4、 建立Widget内容提供者文件。我们在res下建立xml文件夹,并且新建一个widget_provider.xml代码如下:







 
5、 修改WidgetDemo.java代码如下:
package com.android.rui; 

import java.util.Calendar;    

import java.util.Date;    

import java.util.GregorianCalendar;    

import java.util.Timer;    

import java.util.TimerTask;    

import android.appwidget.AppWidgetManager;    

import android.appwidget.AppWidgetProvider;    

import android.content.ComponentName;    

import android.content.Context;    

import android.widget.RemoteViews;    

public class WidgetDemo extends AppWidgetProvider {    

/** Called when the activityis first created. */            

    @Override   

    public void onUpdate(Context context, AppWidgetManagerappWidgetManager,    

        int[] appWidgetIds){    

            

            Timer timer = new Timer();    

           timer.scheduleAtFixedRate(new MyTime(context,appWidgetManager), 1, 60000);    

            super.onUpdate(context,appWidgetManager, appWidgetIds);    

        }                        

        private class MyTime extends TimerTask{    

            RemoteViews remoteViews;    

            AppWidgetManager appWidgetManager;    

            ComponentName thisWidget;    

                

            public MyTime(Contextcontext,AppWidgetManager appWidgetManager){    

                this.appWidgetManager =appWidgetManager;   

                switch(Declare.i)//让widget背景图定时变换              
                {
                case 1:
                    remoteViews = new RemoteViews(context.getPackageName(),R.layout.main1);
                    Declare.i++;
                    break;
                case 2:
                    remoteViews = new RemoteViews(context.getPackageName(),R.layout.main2);
                    Declare.i++;
                    break;
                case 3:
                    remoteViews = new RemoteViews(context.getPackageName(),R.layout.main3);
                    Declare.i++;
                    break;
                default:                    
                    remoteViews = new RemoteViews(context.getPackageName(),R.layout.main);
                    Declare.i=0;
                    Declare.i++;
                    break;
                }                    

                thisWidget = newComponentName(context,WidgetDemo.class);    

            }            

            public void run() {    

                    

                Date date = new Date();    

                Calendarcalendar = new GregorianCalendar(2011,05,01);    

                long days =(((calendar.getTimeInMillis()-date.getTime())/1000))/86400-30;    

                remoteViews.setTextViewText(R.id.may1st, "距离五一假期还有" + days+"天");    

                appWidgetManager.updateAppWidget(thisWidget, remoteViews);    

                    

            }    

                

        }     

}

6、 修改配置文件AndroidManifest.xml文件。

由于使用了reciever和“android.appwidget.action.APPWIDGET_UPDATE”,所以需要在AndroidManifest.xml中进行注册。

代码如下:





    

            

                    

                    

                

                

             

 


四、Widget事件处理

在以上五一假期倒计时的DEMO中只是更新显示了一个界面。在Widget中同样可以通过setOnClickPendingIntent方法来监听一个事件的处理。

比如:当我们点击一个”widget_button”按钮时,会弹出一个Toast提示。主要代码如下:

public class widget extends AppWidgetProvider

{

    public void onReceive(Context context,Intent intent)

    {

    super.onReceive(context,intent);

    if(intent.getAction().equals("com.android.myapp.widget.CLICK"))

    {

        Toast.makeText(context,"It works!",Toast.LENGTH_SHORT).show();

    }

    }

   

    public void onUpdate(Context context, AppWidgetManagerappWidgetManager,int[] appWidgetIds) {

        final int N = appWidgetIds.length;

        for (int i = 0; i < N; i++) {

            int appWidgetId = appWidgetIds[i];

            RemotesViews rv = new RemoteViews(context.getPackageName(),R.layout.main);

            Intent intentClick = new Intent("com.android.myapp.widget.CLICK");

            PendingIntent pendingIntent =PendingIntent.getBroadcast(context, 0,intentClick, 0);

            rv.setOnClickPendingIntent(R.id.widget_button,pendingIntent);

           appWidgetManager.updateAppWidget(appWidgetId, rv);

        }

    }

}
Tip: "com.android.myapp.widget.CLICK"事件需要在AndroidManifext.xml文件中声明,声明方式同上面的 "android.appwidget.action.APPWIDGET_UPDATE"。

五、Widget启动Activity

在Widget中同样可以启动一个Activity,比如Android自带的音乐播放器,当我们添加一个音乐播放器桌面小部件并点击”button”时就开启一个Activity来显示播放音乐的界面。

通过如下代码即可以启动一个Activity:

RemoteViews rv=newRemoteViews(context.getPackageName(),R.layout.mywidget);

Intent intentActivity=new Intent(context,MusicPlayer.class);

PendingIntentpendingIntentActivity=PendingIntent.getActivity(context, 0, intentActivity, 0);

rv.setOnClickPendingIntent(R.id.button,pendingIntentActivity);

appWidgetManager.updateAppWidget(appWidgetId,rv);
当我们点击”button”按钮时就可以启动指定的Activity了,代码如下:

context.startActivity(intentActivity);

六、Widget启动Service

Widget还可以启动一个服务。比如Android自带的音乐播放器,要播放音乐肯定需要使用service在后台播放,所以就需要在音乐播放器桌面小部件中启动一个service。使用下面方法可以在Widget中启动一个Service:

RemoteViews rv=new RemoteViews(context.getPackageName(),R.layout.mywidget);

Intent intentService=new Intent(“Service名”);

context.startService(intentService);

appWidgetManager.updateAppWidget(appWidgetId,rv);


你可能感兴趣的:(桌面组件widget)