下面是本篇的大纲:

  • 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、长按主界面
  • Android 桌面组件widget
    • 2、之后弹出一个对话框,里面就有android 内置的一些桌面组件
      Android 桌面组件widget

    3、AppWidget 框架的主要类介绍

    1)AppWidgetManger

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

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

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

    4、Demo讲解

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

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

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

    1、新建AppWidgetProvderInfo

    代码如下:

    <?xml version="1.0" encoding="UTF-8"?><appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"    android:minWidth="60dp"    android:minHeight="30dp"    android:updatePeriodMillis="86400000"         android:initialLayout="@layout/main"></appwidget-provider>

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

    2、写一个类继承自AppWidgetProvider

    主要代码如下:

    public class widgetProvider extends AppWidgetProvider

    并重写两个方法

  • @Override    public void onUpdate(Context context, AppWidgetManager appWidgetManager,            int[] appWidgetIds) {}@Override    public void onReceive(Context context, Intent intent) {}

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

    3、后台注册Receiver

    后台配置文件代码如下:

  • <receiver android:name=".widgetProvider">            <meta-data android:name="android.appwidget.provider"                android:resource="@xml/appwidget_provider"></meta-data>            <intent-filter>                <action android:name="com.terry.action.widget.click"></action>                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />                             </intent-filter>        </receiver>

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

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

    先看代码:

    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);    }

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

    @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);    }

    在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[i];            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);    }}

    Android 桌面组件widget

更多相关文章

  1. android常用功能组件——setRequestedOrientation
  2. [置顶] Android系统安全之旅 第1章 编译Android程序的方法
  3. Android使背景灯(Brightness)高亮的方法
  4. android spinner自动弹出列表,设置title,TtextView不换行自动截取
  5. Android 获取控件高度宽度三种方法,防止0的出现
  6. [android]组件和控件的区别

随机推荐

  1. Android在开机时自动启动一个应用程序
  2. android参考例子
  3. android manifest.xml中元素含义android
  4. Android布局属性详解
  5. android 布局大全
  6. Android(安卓)sms 发送、接收及格式
  7. Android(安卓)短信 彩信 wap push的接收
  8. 使用 ViewStub 延迟展开视图
  9. Android(安卓)API Level对应Android版本
  10. android sms发送、接收及格式