Android中桌面小部件AppWidget的使用

　　　　桌面小部件一般用于图库、音乐播放器、天气预报、日历、时钟等。尤其系统应用，其实可以长按手机桌面，底部会出现“桌面小工具”的图标，点击即可查看当前设备上的所有桌面小部件。那如何在自己的应用上实现小部件的功能呢？以下就从一个简单的demo介绍：

 一、AppWidgetProvider的使用：

public class AppWidgetProvider extends BroadcastReceiver {
......
}

查看源码可知，AppWidgetProvider本身是一个广播接收者。

实现步骤：一些注意事项在代码中都有注释。

1、自定义一个TaskAppWidgetProvider，继承自AppWidgetProvider ；

public class TaskAppWidgetProvider extends AppWidgetProvider {

    //    AppWidgetProvider：继承了BroadcastReceiver

    private final String TAG="TaskAppWidgetProvider";
    private final String UPDATE_WIDGET_ACTION = "android.appwidget.action.APPWIDGET_UPDATE";

    @Override
    public void onReceive(Context context, Intent intent) {
        // TODO Auto-generated method stub
        super.onReceive(context, intent);
        Log.i(TAG, "onReceive() " + intent.getAction());
    }


    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager,
            int[] appWidgetIds) {
        // TODO Auto-generated method stub
        super.onUpdate(context, appWidgetManager, appWidgetIds);
        Log.i(TAG, "onUpdate()   appWidgetIds.length: " + (appWidgetIds!=null?appWidgetIds.length:0));
        
        initWidget(context, appWidgetIds);
        
    }
    
    //初始化界面
    private void initWidget(Context context, int[] appWidgetIds){
        RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.task_appwidget);
        views.setTextViewText(R.id.change_text, "onUpdate中修改文本-");
        initListener(context, views);
        
        update(context, appWidgetIds, views);        //通知系统更新widget---否则，对界面的修改及设置的监听事件等均无效
    }
    //设置控件的点击事件
    private void initListener(Context context,RemoteViews views){
        Intent intent;
        PendingIntent pendingIntent;
        
        intent = new Intent(context, MainActivity.class);
        pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);
        views.setOnClickPendingIntent(R.id.main_btn, pendingIntent);
        
        intent = new Intent(context, SearchActivity.class);
        pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);
        views.setOnClickPendingIntent(R.id.search_btn, pendingIntent);
    }
    
    /**
     * 更新Widget
     * @param context
     * @param appWidgetIds  当前桌面该应用部件的实例个数，简单理解：即在桌面添加了几个该部件
     * @param views
     */
    private void update(Context context,int[] appWidgetIds, RemoteViews views){
        AppWidgetManager widgetMng = AppWidgetManager.getInstance(context);
        if(appWidgetIds != null){
            widgetMng.updateAppWidget(appWidgetIds, views);
        }else{
            widgetMng.updateAppWidget(new ComponentName(context, getClass()), views);
        }
    }
    
}

 2、在AndroidManifest.xml中注册，不同的是，此处要指定在桌面小部件列表中显示的布局；

 <receiver
            android:name="com.test.appwidget.TaskAppWidgetProvider"
            android:label="@string/widget_title" >
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />    <!-- 在添加小部件时，android系统发出的广播      与下面的meta-data都是必须的，否则在小部件列表中不会显示 -->
            </intent-filter>

            <meta-data
                android:name="android.appwidget.provider"        
                android:resource="@xml/task_widget_info" />        <!-- name：必需是此名称     resource:在窗口小部件列表中显示的布局  -->
        </receiver>

3、定义xml文件<appwidget-provider/>,里面是关于小部件的配置信息及具体显示布局；

//task_widget_info.xml
<?xml version="1.0" encoding="UTF-8"?>
<appwidget-provider
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:initialLayout="@layout/task_appwidget"
    android:minHeight="150dip"
    android:minWidth="200dip"
    android:previewImage="@drawable/local_search"
    android:updatePeriodMillis="86400" >

</appwidget-provider>

android:initialLayout是具体显示布局：task_appwidget.xml

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:layout_gravity="center_horizontal"
    android:background="#afffffff"
    android:padding="10dp" >

    <LinearLayout
        android:id="@+id/linear_layout"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="vertical" >

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="测试窗口小部件"
            android:textColor="#000"
            android:textSize="20sp" />

        <TextView
            android:id="@+id/change_text"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="change-text"
            android:textColor="#000"
            android:textSize="18sp" />
    </LinearLayout>

    <Button
        android:layout_below="@id/linear_layout"
        android:id="@+id/main_btn"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="10dp"
        android:text="click-main" />
    
    <Button
        android:id="@+id/search_btn"
        android:layout_toRightOf="@id/main_btn"
        android:layout_marginLeft="10dp"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignBottom="@id/main_btn"
        android:text="click-search" />

</RelativeLayout>

 

上述完成后，运行程序；在手机桌面长按，观察在桌面小工具中是否存在，若存在则说明成功！

二、参考：

原文参考：http://www.cnblogs.com/TerryBlog/archive/2010/07/29/1788319.html