Android之桌面组件AppWidget

转载：Android之桌面组件App Widget初探

Android开发应用除了程序应用，还有App Widget应用。好多人会开发程序应用而不会开发App Widget应用。本帖子就是帮助大家学习如何开发App Widget应用的。
先简单说说App Widget的原理。App Widget是在桌面上的一块显示信息的东西，通过单击App Widget跳转到程序入口类。而系统自带的程序，典型的App Widget是music，这个Android内置的音乐播放小程序。这个是典型的App Widget+app应用。就是一个程序既可以通过App Widget启动，也可以通过App启动。App Widget就是一个AppWidgetProvider+一个UI界面显示（预先绑定了好多Intent），界面上的信息可以通过程序控制而改变，单击Widget上的控件只能激发发送一个Intent，或发出一个Service的启动通知。而AppWidgetProvider可以拦截这个Intent，而进行相应的处理（比如显示新的信息）。

以下模拟一下App Widget的应用

通过两种方式启动应用程序

1、App Widget启动

长按空白的桌面主屏幕会弹出“添加到主屏幕”，然后选择“窗口小部件”选项进入“选择窗口小部件”，最后选择想要的小部件就会添加到桌面主屏幕，当点击刚才添加的桌面控件就会进入到程序主入口。

1、2、3、

2、App启动：跟普通的Activity一样

以下为实现代码

main.xml布局文件，程序入口类的界面

my_layout.xml布局文件：带一个图片的按钮

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical" android:layout_width="fill_parent"
    android:layout_height="fill_parent">
    <TextView android:layout_width="fill_parent"
        android:layout_height="wrap_content" 
        android:text="程序入口" />
</LinearLayout>

类MainActivity程序入口类

package com.ljq.activity;
import android.app.Activity;
import android.os.Bundle;

/**
 * 主程序入口类
 * 
 * @author jiqinlin
 *
 */
public class MainActivity extends Activity{

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
    }
}

下面的代码才是开发AppWidget用到的代码

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical" 
    android:layout_width="fill_parent"
    android:layout_height="fill_parent">
    <!-- <ImageView
        xmlns:android="http://schemas.android.com/apk/res/android"
        android:id="@+id/imageView" 
        android:gravity="center"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content" /> -->
    <Button android:id="@+id/btn"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:gravity="center"
        android:background="@drawable/png1"/>
</LinearLayout>

my_appwidget.xml布局文件：

<?xml version="1.0" encoding="utf-8"?>
<!-- 
AppWidgetProvderInfo: 描述AppWidget的大小、更新频率和初始界面等信息，以XML文件形式存在于应用的res/xml/目录下。
注意：SDK1.5之后此android:updatePeriodMillis就失效了，要自己创建service更新
 -->
<appwidget-provider
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="75dip"
    android:minHeight="45dip"
    android:updatePeriodMillis="1000"
    android:initialLayout="@layout/my_layout"/>

TestActivity类

package com.ljq.activity;

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;

/**
 * 为手机添加桌面控件，当点击桌面控件时则进入主程序
 * 
 * AppWidgetProvider：继承自BroadcastRecevier，在AppWidget应用update、enable、disable和delete时接收通知。
 * 其中，onUpdate、onReceive是最常用到的方法，它们接收更新通知
 * 
 * @author jiqinlin
 *
 */
public class TestActivity extends AppWidgetProvider {
    /**
     * 用来间隔的更新App Widget，间隔时间用AppWidgetProviderInfo里的updatePeriodMillis属性定义(单位为毫秒)。
     * 注意：SDK1.5之后此android:updatePeriodMillis就失效了，要自己创建service更新。
     * 这个方法也会在用户添加App Widget时被调用，因此它应该执行基础的设置，比如为视图定义事件处理器并启动一个临时的服务Service，如果需要的话。
     * 但是，如果你已经声明了一个配置活动，这个方法在用户添加App Widget时将不会被调用，
     * 而只在后续更新时被调用。配置活动应该在配置完成时负责执行第一次更新。
     */
    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        System.out.println("onUpdate");
        //点击桌面组件时进入主程序入口
        Intent intent=new Intent(context, MainActivity.class);
        PendingIntent pendingIntent=PendingIntent.getActivity(context, 0, intent, 0);
        //RemoteViews类描述了一个View对象能够显示在其他进程中，可以融合layout资源文件实现布局。
        //虽然该类在android.widget.RemoteViews而不是appWidget下面,但在Android Widgets开发中会经常用到它，
        //主要是可以跨进程调用(appWidget由一个服务宿主来统一运行的)。
        RemoteViews myRemoteViews = new RemoteViews(context.getPackageName(), R.layout.my_layout);
        //myRemoteViews.setImageViewResource(R.id.imageView, R.drawable.png1);//设置布局控件的属性（要特别注意）
        myRemoteViews.setOnClickPendingIntent(R.id.btn, pendingIntent);
        ComponentName myComponentName = new ComponentName(context, TestActivity.class);
        //负责管理AppWidget，向AppwidgetProvider发送通知。提供了更新AppWidget状态，获取已经安装的Appwidget提供信息和其他的相关状态
        AppWidgetManager myAppWidgetManager = AppWidgetManager.getInstance(context);
        myAppWidgetManager.updateAppWidget(myComponentName, myRemoteViews);
    }
    
    /**
     * 当App Widget从宿主中删除时被调用。
     */
    @Override
    public void onDeleted(Context context, int[] appWidgetIds) {
        System.out.println("onDeleted");
        super.onDeleted(context, appWidgetIds);
    }
    
    /**
     * 当一个App Widget实例第一次创建时被调用。
     * 比如，如果用户添加两个App Widget实例，只在第一次被调用。
     * 如果你需要打开一个新的数据库或者执行其他对于所有的App Widget实例只需要发生一次的设置，
     * 那么这里是完成这个工作的好地方。
     */
    @Override
    public void onEnabled(Context context) {
        System.out.println("onEnabled");
        super.onEnabled(context);
    }
    
    /**
     * 当你的App Widget的最后一个实例被从宿主中删除时被调用。你应该在onEnabled(Context)中做一些清理工作，比如删除一个临时的数据库
     */
    @Override
    public void onDisabled(Context context) {
        System.out.println("onDisabled");
        super.onDisabled(context);
    }
    
    /**
     * 接收到每个广播时都会被调用，而且在上面的回调函数之前。
     * 你通常不需要实现这个方法，因为缺省的AppWidgetProvider实现过滤所有App Widget广播并恰当的调用上述方法。
     * 注意: 在Android 1.5中，有一个已知问题，onDeleted()方法在调用时不被调用。
     * 为了规避这个问题，你可以像Group post中描述的那样实现onReceive()来接收这个onDeleted()回调。
     */
    @Override
    public void onReceive(Context context, Intent intent) {
        System.out.println("onReceive");
        super.onReceive(context, intent);
    }
    
}

清单文件

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.ljq.activity" android:versionCode="1"
    android:versionName="1.0">
    <application android:icon="@drawable/icon" android:label="@string/app_name">
        <activity android:name=".MainActivity" android:label="主程序">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        <!-- TestActivity类为一个广播接收器，因为TestActivity继承自AppWidgetProvider -->
        <receiver  android:name=".TestActivity"    android:label="添加桌面控件">
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
            </intent-filter>
            <meta-data android:name="android.appwidget.provider"
                android:resource="@xml/my_appwidget"/>
        </receiver>
    </application>
    <uses-sdk android:minSdkVersion="7" />

</manifest>

转载：Android之桌面组件App Widget案例

模拟一个案例：把AppWidget添加到桌面后，点击AppWidget后AppWidget文本会轮回改变

main.xml布局文件

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical" android:layout_width="fill_parent"
    android:layout_height="fill_parent">
    <TextView android:id="@+id/tv"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content" 
        android:text="程序入口" 
        android:textSize="50dip"/>
</LinearLayout>

res/xml/my_appwidget.xml布局文件

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

清单文件

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.ljq.activity" android:versionCode="1"
    android:versionName="1.0">
    <application android:icon="@drawable/icon"
        android:label="@string/app_name">
        <receiver android:name=".TestActivity">
            <meta-data android:name="android.appwidget.provider"
                android:resource="@xml/my_appwidget">
            </meta-data>
            <intent-filter>
                <action android:name="COM.LJQ.ACTION.WIDGET.CLICK"></action>
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
            </intent-filter>
        </receiver>
    </application>
    <uses-sdk android:minSdkVersion="7" />

</manifest>

变量类UtilTool：用来控件文本改变

package com.ljq.activity;

public class UtilTool {
    public static boolean isChange=true;
}

TestActivity类，继承自AppWidgetProvider

package com.ljq.activity;

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;

public class TestActivity extends AppWidgetProvider {
    // 自定义一个Action名
    private static final String ACTION_CLICK_NAME = "COM.LJQ.ACTION.WIDGET.CLICK";
    private RemoteViews rv;

    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        System.out.println("onUpdate");
        //获取R.layout.main布局，通过类RemoteViews对布局R.layout.main里的控件进行操作
        /*rv = new RemoteViews(context.getPackageName(), R.layout.main);
        Intent intentClick = new Intent(ACTION_CLICK_NAME);
        PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intentClick, 0);
        rv.setOnClickPendingIntent(R.id.tv, pendingIntent);
        
        ComponentName cmp = new ComponentName(context, TestActivity.class);
        AppWidgetManager myAppWidgetManager = AppWidgetManager.getInstance(context);
        myAppWidgetManager.updateAppWidget(cmp, rv);*/
        final int N = appWidgetIds.length;
        for (int i = 0; i < N; i++) {
            int appWidgetId = appWidgetIds[i];
            updateAppWidget(context, appWidgetManager, appWidgetId);
        }
    
    }
    
    //AppWidget生命周期: 每接收一次，广播执行一次为一个生命周期结束。
    //也就是说在重写AppWidgetProvider类里面声明全局变量做状态判断，
    //每次状态改变AppWidgetProvider再接收第二次广播时即为你重新初始化也就是说重新实例化了一次AppWidgetProvider。
    //今天我因为在里面放了一个boolean值初始化为true，观察调试看到每次进入都为TRUE故你在设置桌面组件时，
    //全局变量把它声明在另外一个实体类用来判断是没问题的，切忌放在本类。
    @Override
    public void onReceive(Context context, Intent intent) {
        System.out.println("onReceive");
        if (rv == null) {
            rv = new RemoteViews(context.getPackageName(), R.layout.main);
        }
        if (intent.getAction().equals(ACTION_CLICK_NAME)) {
            if (UtilTool.isChange) {
                rv.setTextViewText(R.id.tv, "abc");
            } else {
                rv.setTextViewText(R.id.tv, "123");
            }
            UtilTool.isChange = !UtilTool.isChange;
            AppWidgetManager appWidgetManger = AppWidgetManager.getInstance(context);
            int[] appIds = appWidgetManger.getAppWidgetIds(new ComponentName(context, TestActivity.class));
            appWidgetManger.updateAppWidget(appIds, rv);
        }else{
            super.onReceive(context, intent);
        }
        
    }
    
    private void updateAppWidget(Context context,
            AppWidgetManager appWidgeManger, int appWidgetId) {
        rv = new RemoteViews(context.getPackageName(), R.layout.main);
        Intent intentClick = new Intent();
        intentClick.setAction(ACTION_CLICK_NAME);
        PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intentClick, 0);
        rv.setOnClickPendingIntent(R.id.tv, pendingIntent);
        appWidgeManger.updateAppWidget(appWidgetId, rv);
    }

}