Android小部件AppWidget

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的类就可以实现小部件的功能了,还是很简单吧

源码下载地址

发布了21 篇原创文章 · 获赞 8 · 访问量 5万+

猜你喜欢

转载自blog.csdn.net/zhangxuebing2/article/details/20149207