千锋教育-做有情怀、有良心、有品质的IT职业教育机构

您现在的位置:首页 >> 学习资料 >> Android 桌面组件【widget】初探

Android 桌面组件【widget】初探

时间:2011-04-11 10:54:28 来源:DevDiv移动开发社区 作者:Vincent

下面是本篇的大纲:

    * 1、AppWidget 框架类
    * 2、在 Android 如何使用 Widget
    * 3、AppWidget 框架的主要类介绍
    * 4、DEMO 讲解

1、AppWidget 框架类

    * 1、AppWidgetProvider :继承自 BroadcastRecevier , 在AppWidget 应用 update、enable、disable 和 delete 时接收通知。其中,onUpdate、onReceive 是最常用到的方法,它们接收更新通知。
    * 2、 AppWidgetProvderInfo:描述 AppWidget 的大小、更新频率和初始界面等信息,以XML 文件形式存在于应用的 res/xml/目录下。
    * 3、AppWidgetManger :负责管理 AppWidget ,向 AppwidgetProvider 发送通知。
    * 4、RemoteViews :一个可以在其他应用进程中运行的类,向 AppWidgetProvider 发送通知。

2、在 Android 如何使用 Widget

    * 1、长按主界面

    * 2、之后弹出一个对话框,里面就有android 内置的一些桌面组件


3、AppWidget 框架的主要类介绍

1) AppWidgetManger 类

    * bindAppWidgetId(int appWidgetId, ComponentName provider)
      通过给定的ComponentName 绑定appWidgetId
    * getAppWidgetIds(ComponentName provider)
      通过给定的ComponentName 获取AppWidgetId
    * getAppWidgetInfo(int appWidgetId)
      通过AppWidgetId 获取 AppWidget 信息
    * getInstalledProviders()
      返回一个List<AppWidgetProviderInfo>的信息
    * getInstance(Context context)
      获取 AppWidgetManger 实例使用的上下文对象
    * updateAppWidget(int[] appWidgetIds, RemoteViews views)
      通过appWidgetId 对传进来的 RemoteView 进行修改,并重新刷新AppWidget 组件
    * updateAppWidget(ComponentName provider, RemoteViews views)
      通过 ComponentName 对传进来的 RemoeteView 进行修改,并重新刷新AppWidget 组件
    * updateAppWidget(int appWidgetId, RemoteViews views)
      通过appWidgetId 对传进来的 RemoteView 进行修改,并重新刷新AppWidget 组件

2) 继承自 AppWidgetProvider 可实现的方法为如下:

    * 1、onDeleted(Context context, int[] appWidgetIds)
    * 2、onDisabled(Context context)
    * 3、onEnabled(Context context)
    * 4、onReceive(Context context, Intent intent)
      Tip:因为 AppWidgetProvider 是继承自BroadcastReceiver  所以可以重写onRecevie 方法,当然必须在后台注册Receiver
    * 5、onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds)

4、Demo讲解

下面是我今天做的一个实例,提供给大家练习时做参考,效果如下:在布局中放一个 TextView 做桌面组件,然后设置TextView 的 Clickable="true" 使其有点击的功能,然后我们点击它时改变它的字体,再点击时变回来,详细操作如下流程:

    * 1、新建AppWidgetProvderInfo
    * 2、写一个类继承自AppWidgetProvider
    * 3、后台注册Receiver
    * 4、使 AppWidget 组件支持点击事件
    * 5、如何使TextView 在两种文本间来回跳转

问题抛出来了,那么一起解决它吧。

1、新建AppWidgetProvderInfo

代码如下:

  1. <?xml version="1.0" encoding="UTF-8"?>
     
  2. <appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
     
  3.     android:minWidth="60dp"
     
  4.     android:minHeight="30dp"
     
  5.     android:updatePeriodMillis="86400000"
     
  6.      
     
  7.     android:initialLayout="@layout/main">
     
  8. </appwidget-provider>
复制代码

Tip:上文说过AppWidgetProvderInfo 是在res/xml 的文件形式存在的,看参数不难理解,比较重要的是这里android:initialLayout="@layout/main" 此句为指定桌面组件的布局文件。

2、写一个类继承自AppWidgetProvider

主要代码如下:

  1. public class widgetProvider extends AppWidgetProvider
复制代码

并重写两个方法

  1. @Override
     
  2.     public void onUpdate(Context context, AppWidgetManager appWidgetManager,
     
  3.             int[] appWidgetIds) {}
     

  4.  
  5. @Override
     
  6.     public void onReceive(Context context, Intent intent) {}
复制代码

Tip:onUpdate 为组件在桌面上生成时调用,并更新组件UI,onReceiver 为接收广播时调用更新UI,一般这两个方法是比较常用的。

3、后台注册Receiver

后台配置文件代码如下:

  1. <receiver android:name=".widgetProvider">
     
  2.             <meta-data android:name="android.appwidget.provider"
     
  3.                 android:resource="@xml/appwidget_provider"></meta-data>
     
  4.             <intent-filter>
     
  5.                 <action android:name="com.terry.action.widget.click"></action>
     
  6.                 <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
     
  7.                  
     
  8.             </intent-filter>
     
  9.         </receiver>
复制代码

Tip:因为是桌面组件,所以暂时不考虑使用Activity 界面,当然你在实现做项目时可能会需要点击时跳转到Activity 应用程序上做操作,典型的案例为Android  提供的音乐播放器。上面代码中比较重要的是这一句 <meta-data android:name="android.appwidget.provider"  android:resource="@xml/appwidget_provider"></meta-data>  大意为指定桌面应用程序的AppWidgetProvderInfo  文件,使其可作其管理文件。

4、使 AppWidget 组件支持点击事件

先看代码:

  1. public static void updateAppWidget(Context context,
     
  2.             AppWidgetManager appWidgeManger, int appWidgetId) {
     
  3.         rv = new RemoteViews(context.getPackageName(), R.layout.main);
     
  4.         Intent intentClick = new Intent(CLICK_NAME_ACTION);
     
  5.         PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0,
     
  6.                 intentClick, 0);
     
  7.         rv.setOnClickPendingIntent(R.id.TextView01, pendingIntent);
     
  8.         appWidgeManger.updateAppWidget(appWidgetId, rv);
     
  9.     }
复制代码

此方法为创建组件时 onUpdate 调用的更新UI的方法,代码中使用RemoteView 找到组件的布局文件,同时为其设置广播接收器CLICK_NAME_ACTION并且通过RemoteView 的setOnClickPendingIntent 方法找到我想触发事件的TextView 为其设置广播。接着

  1. @Override
     
  2.     public void onReceive(Context context, Intent intent) {
     
  3.         // TODO Auto-generated method stub
     
  4.         super.onReceive(context, intent);
     

  5.  
  6.         if (rv == null) {
     
  7.             rv = new RemoteViews(context.getPackageName(), R.layout.main);
     
  8.         }
     
  9.         if (intent.getAction().equals(CLICK_NAME_ACTION)) {
     
  10.             if (uitil.isChange) {
     
  11.                 rv.setTextViewText(R.id.TextView01, context.getResources()
     
  12.                         .getString(R.string.load));
     

  13.  
  14.             } else {
     
  15.                 rv.setTextViewText(R.id.TextView01, context.getResources()
     
  16.                         .getString(R.string.change));
     

  17.  
  18.             }
     
  19.             Toast.makeText(context, Boolean.toString(uitil.isChange),
     
  20.                     Toast.LENGTH_LONG).show();
     
  21.             uitil.isChange = !uitil.isChange;
     

  22.  
  23.         }
     
  24.         AppWidgetManager appWidgetManger = AppWidgetManager
     
  25.                 .getInstance(context);
     
  26.         int[] appIds = appWidgetManger.getAppWidgetIds(new ComponentName(
     
  27.                 context, widgetProvider.class));
     
  28.         appWidgetManger.updateAppWidget(appIds, rv);
     
  29.     }
复制代码

在onReceiver 中通过判断传进来的广播来触发动作。

5、如何使TextView 在两种文本间来回跳转

如何 TextView 在来两种状态中来回呢?这也是我比较调试最久的一个难点,问题出在对 AppWidget 的理解不够深入。 如果我的设想没错的话AppWidget 的生命周期应该在每接收一次广播执行一次为一个生命周期结束,也就是说你在重写的 AppWidgetProvider 类里面声明全局变量做状态判断,每次状态改变AppWidgetProvider 再接收第二次广播时即为你重新初始化也就是说桌件为你重新实例化了一次AppWidgetProvider 。今天我因为在里面放了一个boolean 值初始化为true ,观察调试看到每次进入都为TRUE 故你在设置桌面组件时,全局变量把它声明在另外一个实体类用来判断是没问题的,切忌放在本类。代码参考onReceiver方法。

效果图如下:


代码:
package com.terry;

import android.app.PendingIntent;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.widget.RemoteViews;
import android.widget.Toast;

public class widgetProvider extends AppWidgetProvider {
    private static final String CLICK_NAME_ACTION = "com.terry.action.widget.click";

    private static RemoteViews rv;

    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager,
            int[] appWidgetIds) {
        // TODO Auto-generated method stub
        final int N = appWidgetIds.length;
        for (int i = 0; i < N; i++) {
            int appWidgetId = appWidgetIds;
            updateAppWidget(context, appWidgetManager, appWidgetId);
        }
    }

    @Override
    public void onReceive(Context context, Intent intent) {
        // TODO Auto-generated method stub
        super.onReceive(context, intent);

        if (rv == null) {
            rv = new RemoteViews(context.getPackageName(), R.layout.main);
        }
        if (intent.getAction().equals(CLICK_NAME_ACTION)) {
            if (uitil.isChange) {
                rv.setTextViewText(R.id.TextView01, context.getResources()
                        .getString(R.string.load));

            } else {
                rv.setTextViewText(R.id.TextView01, context.getResources()
                        .getString(R.string.change));

            }
            Toast.makeText(context, Boolean.toString(uitil.isChange),
                    Toast.LENGTH_LONG).show();
            uitil.isChange = !uitil.isChange;

        }
        AppWidgetManager appWidgetManger = AppWidgetManager
                .getInstance(context);
        int[] appIds = appWidgetManger.getAppWidgetIds(new ComponentName(
                context, widgetProvider.class));
        appWidgetManger.updateAppWidget(appIds, rv);
    }

    public static void updateAppWidget(Context context,
            AppWidgetManager appWidgeManger, int appWidgetId) {
        rv = new RemoteViews(context.getPackageName(), R.layout.main);
        Intent intentClick = new Intent(CLICK_NAME_ACTION);
        PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0,
                intentClick, 0);
        rv.setOnClickPendingIntent(R.id.TextView01, pendingIntent);
        appWidgeManger.updateAppWidget(appWidgetId, rv);
    }
}

课程咨询

免费咨询热线
400-811-9990
  • 北京天丰利校区(总部):北京市海淀区宝盛北里西区28号天丰利商城4层
    北京沙河校区:北京市昌平区沙阳路18号北京科技职业技术学院广场服务楼2层、南区服务楼2层
    咨询电话:400-186-9990 010-82790226-801
    面授课程:iOS培训、Android培训、HTML5培训、UI培训、PHP培训、JavaEE培训、好程序员
  • 深圳科技园校区:深圳市南山区科苑南路高新技术产业园R3-B栋5层
    深圳大学城校区:深圳市南山区留仙大道1201号大学城创客小镇16栋2楼、3楼
    深圳西部硅谷校区:深圳市宝安区宝安大道5010号西部硅谷B座A605-619
    咨询电话:0755-86681178/9-801
    面授课程:iOS培训、Android培训、HTML5培训、UI培训、PHP培训、JavaEE培训、好程序员
  • 上海学院地址:上海市宝山区同济支路199号智慧七立方3号楼2-4层
    咨询电话:400-627-7899 021-65025129-602
    面授课程:iOS课程培训、Android课程培训、HTML5课程培训、UI课程培训、好程序员
  • 郑州学院地址:郑州市金水区纬五路21号河南教育学院综合楼(经纬中学楼)6/7/8层
    咨询电话:0371-55911950 400-186-9990
    面授课程:iOS课程培训、Android课程培训、HTML5课程培训、UI课程培训
  • 广州学院地址:广州市天河区元岗路310号智汇park创意园E座5层
    咨询电话:020-22119207 400-186-9990
    面授课程:iOS课程培训、Android课程培训、HTML5课程培训
  • 大连学院地址:大连市甘井子区软件园路2号B8座二楼
    咨询电话:0411-39026086 400-186-9990
    面授课程:iOS课程培训、Android课程培训、HTML5课程培训
  • 武汉学院地址:武汉市东新区光谷大道77号金融港B26栋9楼
    咨询电话:027-59905902 027-59905908 027-59905909
    面授课程:iOS课程培训、Android课程培训、HTML5课程培训
  • 成都旅游学院校区:成都市一环路西二段17号四川旅游学院青羊校区内
    成都华立校区:成都一环路西二段17号华立大厦3楼
    咨询电话:028-83178771 028-61967740
    面授课程:iOS课程培训、Android课程培训、HTML5课程培训、UI课程培训
  • 西安南二环校区:西安市二环南路西段60号永安大厦4层
    西安科技园校区:西安市雁塔区高新六路52号立人科技园C座西区4层
    咨询电话:029-85260160 029-85261030 029-85260960
    面授课程:iOS课程培训、Android课程培训、HTML5课程培训
  • 杭州学院地址:浙江省杭州市江干区九堡旺田书画城A座4层
    咨询电话:0571-86893632 010-82790226-801
    面授课程:iOS课程培训、Android课程培训、HTML5课程培训
  • 青岛校区地址:青岛市市南区金坛路17号青岛职业技术学院南校区实训楼A4层
    咨询电话:0532-80910752/3 010-82790226-801
    面授课程:iOS课程培训、Android课程培训、HTML5课程培训、UI课程培训
  • 了解千锋动态
    关注千锋教育服务号

  • 扫码关注千锋互联
    身边的移动开发导师

关闭