Android应用程序窗口小部件AppWidget是微小的应用程序视图,也是一种UI组件.它可以让一小块程序嵌入到Launcher中并且可以周期性的更新,由于AppWidget自动更新的特性,所以它比较适合用来设计一些天气,新闻,日历等功能
下面来看看AppWidget做出来的效果图:
从效果图可以看到在"小部件"的内容中有谷歌自己的音乐,商店小部件,腾讯的小部件等等,其中MyWidgetActivity就是Demo程序的小部件,其中“4*1”,“1*1”表示在占据大小,这个可以在配置文件XML中定义
在/res目录新建一个文件夹xml,在/res/xml目录下新建一个appwidget01.xml文件:
<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider
xmlns:android="http://schemas.android.com/apk/res/android"
android:minWidth = "294dp"
android:minHeight = "20dp"
android:updatePeriodMillis = "0"
android:initialLayout = "@layout/appwidgetlayout"
>
</appwidget-provider>
其中
1.<appwidget-provider>标签定义App Widget的属性
2.android:minWidth 宽度
3.android:minHeight 长度
4.android:updatePeriodMillis定义App Widget的更新频率,Android框架每隔一段时间,会回调AppWidgetProvider类的onUpdate()事件,以前android的版本设定为1毫秒为单位,现在版本为了省电,更新时间为30~60分钟,所以现在设定30分钟以内的更新意义不大,系统默认为30~60分钟更新
5.android:initialLayout 组件布局XML的位置
接着在看看小部件布局以及效果图
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="fill_parent" android:layout_height="fill_parent">
<TextView
android:id="@+id/txtapp"
android:text="花花小部件测试"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:textSize="22dp"
android:background="#000000">
</TextView>
<Button
android:id="@+id/btnSend"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Send">
</Button>
<Button
android:id="@+id/btnSend2"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Send2">
</Button>
<!--
<EditView
android:id="@+id/btnSend3"
android:layout_width="wrap_content"
android:layout_height="wrap_content" >
</EditView>
-->
</LinearLayout>
可以看到跟平时的布局没有什么区别,但是,你必须意识到App Widget布局是基于RemoteViews,这并不支持所有类型的布局或视图小部件。
一个RemoteViews对象(以及,相应的,一个App Widget)可以支持
下面这些布局类:
· FrameLayout
· LinearLayout
· RelativeLayout
以及下面的小部件类:
· AnalogClock
· Button
· Chronometer
· ImageButton
· ImageView
· ProgressBar
· TextView
不支持这些类的派生.
如果我们把EditText这个组件加入到AppWidget中,程序不会有异常,并且可以正常运行,但是效果如下图
可以看到加载部件出现问题,不仅EditText看不到,其他的组件也加载不了了
下面我们来看关键的实现代码AppWidget.java
package com.example.mywidgetactivity;
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.os.Bundle;
import android.util.Log;
import android.widget.RemoteViews;
import android.widget.Toast;
public class AppWidget extends AppWidgetProvider
{
private final String Send = "Send";
private final String Send2 = "Send2";
/**
* 删除一个AppWidget时调用
* */
@Override
public void onDeleted(Context context, int[] appWidgetIds)
{
Log.i("huahua", "AppWidget --> onDeleted");
Toast.makeText(context, "删除小部件", Toast.LENGTH_SHORT).show();
super.onDeleted(context, appWidgetIds);
}
/**
* 最后一个appWidget被删除时调用
* */
@Override
public void onDisabled(Context context)
{
Log.i("huahua", "AppWidget --> onDisabled");
Toast.makeText(context, "onDisabled", Toast.LENGTH_SHORT).show();
super.onDisabled(context);
}
/**
* AppWidget的实例第一次被创建时调用
* */
@Override
public void onEnabled(Context context)
{
Log.i("huahua", "AppWidget --> onEnabled");
Toast.makeText(context, "onEnabled", Toast.LENGTH_SHORT).show();
super.onEnabled(context);
}
/**
* 接受广播事件
* */
@Override
public void onReceive(Context context, Intent intent)
{
Log.i("huahua", "AppWidget --> onReceive");
Toast.makeText(context, "onReceive", Toast.LENGTH_SHORT).show();
if (intent.getAction().equals(Send))
{
Log.i("huahua", "AppWidget --> 相应Btn1按钮");
}
else if(intent.getAction().equals(Send2))
{
Log.i("huahua", "AppWidget --> 相应Btn2按钮");
}
super.onReceive(context, intent);
}
/**
*到达指定的更新时间或者当用户向桌面添加AppWidget时被调用
*@param AppWidgetManager 顾名思义是AppWidget的管理器
*@param appWidgetIds 桌面上 所有的widget都会被分配一个唯一的ID标识,那么这个数组就是他们的列表
* */
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
int[] appWidgetIds)
{
Log.i("huahua", "AppWidget --> onUpdate");
Toast.makeText(context, "onUpdate", Toast.LENGTH_SHORT).show();
//创建一个Intent对象
Intent intent1 = new Intent(Send);
Intent intent2 = new Intent(Send2);
//设置pendingIntent的作用
PendingIntent pendingIntent1 = PendingIntent.getBroadcast(context, 0,intent1, 0);
PendingIntent pendingIntent2 = PendingIntent.getBroadcast(context, 0, intent2, 0);
//小部件在Launcher的布局
RemoteViews remoteViews = new RemoteViews(context.getPackageName(),R.layout.appwidgetlayout);
//绑定事件
remoteViews.setOnClickPendingIntent(R.id.btnSend, pendingIntent1);
remoteViews.setOnClickPendingIntent(R.id.btnSend2, pendingIntent2);
//更新Appwidget
appWidgetManager.updateAppWidget(appWidgetIds, remoteViews);
}
}
AppWidgetProvider 类扩展BroadcastReceiver 为一个简便类来处理App Widget广播。AppWidgetProvider只接收和这个App Widget相关的事件广播,比如这个App Widget被更新,删除,启用,以及禁用。当这些广播事件发生时,AppWidgetProvider 将接收到下面的方法调用:
onUpdate(Context, AppWidgetManager, int[])
这个方法调用来间隔性的更新App Widget,间隔时间用AppWidgetProviderInfo 里的updatePeriodMillis属性定义(参见添加AppWidgetProviderInfo元数据)。这个方法也会在用户添加App Widget时被调用,因此它应该执行基础的设置,比如为视图定义事件处理器并启动一个临时的服务Service,如果需要的话。但是,如果你已经声明了一个配置活动,这个方法在用户添加App Widget时将不会被调用,而只在后续更新时被调用。配置活动应该在配置完成时负责执行第一次更新。
onDeleted(Context, int[])
当App Widget从宿主中删除时被调用。
onEnabled(Context)
当一个App Widget实例第一次创建时被调用。比如,如果用户添加两个你的App Widget实例,只在第一次被调用。如果你需要打开一个新的数据库或者执行其他对于所有的App Widget实例只需要发生一次的设置,那么这里是完成这个工作的好地方。
onDisabled(Context)
当你的App Widget的最后一个实例被从宿主中删除时被调用。你应该在onEnabled(Context)中做一些清理工作,比如删除一个临时的数据库。
onReceive(Context, Intent)
这个接收到每个广播时都会被调用
在onUpdate()中,创建RemoteViews的实例,传入AppWidgteProvider所在的包名和该AppWidget所要用的Layout;
如果要响应layoutId中某个viewId被点击操作,要创建本地的PendingIntent,并通过setOnClickPendingIntetn设置到RemoteViews中;
为layoutId中要显示的控件加上显示元素,比如某个ImageView的ImageResource。
用AppWidgetManager.updateAppWidget()更新RemoteViews到系统中,AppWidget系统会更新与之绑定的AppWidgetHost。
因为AppWidgetProvider继承了BroadcastReceiver,在清单xml也需要定义
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.mywidgetactivity"
android:versionCode="1"
android:versionName="1.0" >
<uses-sdk
android:minSdkVersion="8"
android:targetSdkVersion="17" />
<application
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >
<activity
android:name="com.example.mywidgetactivity.MainActivity"
android:label="@string/app_name" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<receiver android:name="AppWidget">
<intent-filter>
<action android:name="Send"></action>
<action android:name="Send2"></action>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE"></action>
</intent-filter>
<meta-data android:name="android.appwidget.provider"
android:resource="@xml/appwidget01" />
</receiver>
</application>
</manifest>
完全不需要在主Activity中做什么事情,只要写一个继承AppWidgetProvider的类就可以实现小部件的功能了,还是很简单吧
源码下载地址