AppWidget初步入门

AppWidget 就是HomeScreen上显示的小部件，提供直观的交互操作。通过在HomeScreen中长按，在弹出的对话框中选择Widget部件来进行创建，长 按部件后并拖动到垃圾箱里进行删除。同一个Widget部件可以同时创建多个。

AppWidget的实现主要涉及到以下类：
1、AppWidgetProvider ：继承自 BroadcastRecevier ， 在AppWidget 应用 update、enable、disable 和 delete 时接收通知。其中，onUpdate、onReceive 是最常用到的方法，它们接收更新通知。

2、 AppWidgetProvderInfo：描述 AppWidget 的大小、更新频率和初始界面等信息，以XML 文件形式存在于应用的 res/xml/目录下。

3、AppWidgetManger ：负责管理 AppWidget ，向 AppwidgetProvider 发送通知。更新AppWidget的相关状态，获取已安装AppWidget的状态和其它相关AppWidget的状态

4、RemoteViews ：一个可以在其他应用进程中运行的类，向 AppWidgetProvider 发送通知。一个描述了可以在其他进程中显示的view层，它inflate于layout资源文件，并且这个类对提供一些基本操作修改view内容

一、首先需要提供一个定义了Widget界面布局的XML文件(位于res/layout/..)，需要注意的是使用的组件必须是RemoteViews所支 持的，目前原生API中支持的组件如下：

FrameLayout
LinearLayout
RelativeLayout

AnalogClock
Button
Chronmeter
ImageButton
ImageView
ProgressBar
TextView
ViewFlipper
ListView
GridView
StackView
AdapterViewFlipper

*如果使用了除此之外的组件，则在Widget创建时会导致android.view.InflateExceptionn异常。

二、然后需要提供一个xml文件来定义Widget的基本属性，放置到res/xml/..目录下。
如果使用的是Eclipse可按如下操作：
1) 在res/目录下创建xml/目录
2)创建xml文件（名字可任意），选择类型为AppWidgetProvider
3)在弹出的便捷界面进行参数设置

主要设置的参数如下:
minWidth: 定义Wdiget组件的宽度
minHeight: 定义Wdiget组件的高度
updatePeriodMillis: 更新的时间周期
initialLayout: Widget的布局文件
configure: 如果需要在启动前先启动一个Activity进行设置，在这里给出Activity的完整类名(后面会说到，与一般Activity的实现有些许差别)

*Widget大小的计算 :(单元格数*74)-2，API上说是为了防止像素计算时的整数舍入导致错所以-2...不是很明白

上代码，先上效果图：

11、先在res\layout中新建一个 main.xml 的文件里面内容如下：这个XML文件是AppWidget的布局文件

AppWidget中只有一个布局文件就是一个Button

<?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"
    android:orientation="vertical" >

    <Button 
        android:id="@+id/btn"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="飞鱼"
        />

</LinearLayout>

12、在res目录下新建一个xml目录，这个xml目录存放AppWidget的相关信息，在xml目录下新建一个 appwidgetinfo.xml 的xml文件

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

minWidth：AppWidget的宽度

minHeight：AppWidget的高度

updatePeriodMillis：更新频率。主要用于执行AppWidgetProvider中的Update()函数

initialLayout = "@layout/main"：指明AppWidget的布局文件

13、新建一个MyWidget的类继承自AppWidgetProvider

public class MyWidget extends AppWidgetProvider {

//	private static final String TAG = "MyWidget";
	private static final String broadcastString = "com.fy.MyWidget";

	// 每当一个Widget被删除的时候调用此函数
	@Override
	public void onDeleted(Context context, int[] appWidgetIds) {
		// TODO Auto-generated method stub
		super.onDeleted(context, appWidgetIds);
	}

	// 当最后一个Widget被删除的时候调用此函数
	// 在此方法中一般情况下执行一些AppWidget的结束性操作，如删除一个临时数据库等操作。
	@Override
	public void onDisabled(Context context) {
		// TODO Auto-generated method stub
		super.onDisabled(context);
	}

	// 当第一个Widget被创建的时候调用此函数
	// 在此方法中一般情况下执行一些AppWidget的初始化的工作，如新建一个数据库或者一些操作等
	@Override
	public void onEnabled(Context context) {
		// TODO Auto-generated method stub
		super.onEnabled(context);
	}

	// 调用其它函数时先调用此函数
	// onReceive相当一个经理，当外界来任务了，将任务分发给其下的员工（onEnable，onDeleted，onDisabled，onUpdate）处理 
	@Override
	public void onReceive(Context context, Intent intent) {
		
		if(intent.getAction().equals(broadcastString)) {
			RemoteViews remotesViews = new RemoteViews(context.getPackageName(), R.layout.main);
			remotesViews.setTextViewText(R.id.btn, "FY");
			
			// 获取AppWidgetManager更新appWidget的实例
			AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
			
			// 组件名称
			ComponentName componentName = new ComponentName(context, MyWidget.class);
			appWidgetManager.updateAppWidget(componentName, remotesViews);
		}
		
		super.onReceive(context, intent);
	}

	// 在这里onUpdate执行的条件有两个：1、到了我们所设定的更新周期了；2、添加一个新的AppWidget。 
    // 在onUpdate中一般为控件定义事件处理或者开启一个临时的Service。 
    // 这里是为我们的button控件添加点击事件处理 
    // context表示这个接收器正在运行的环境 
    // appWManager表示AppWidget的管理器可通过调用updateAppWidget(ComponentName, RemoteViews)更改指定AppWidget的控件属性 
    // appWidgetIds表示Appwidget的编号，系统自动生成 
	@Override
	public void onUpdate(Context context, AppWidgetManager appWidgetManager,
			int[] appWidgetIds) {
		// 初始化Intent
		Intent intent = new Intent();
		intent.setAction(broadcastString);
		PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);
		
		// 获取appWidget上的相关控件
		RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.main);
		remoteViews.setOnClickPendingIntent(R.id.btn, pendingIntent);
		
		// 更新所有的appWidget
		appWidgetManager.updateAppWidget(appWidgetIds, remoteViews);
		
	}

14、在AndroidManifest.xml中注册处理这个广播的类

<application
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name" >
        <receiver android:name=".MyWidget">
            <intent-filter >
<!--                 系统发出的广播 -->
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
<!--                 程序发出的广播 -->
				<action android:name="com.fy.MyWidget"/>
            </intent-filter>
            <meta-data
                android:name="android.appwidget.provider"
                android:resource="@xml/appwidgetinfo"
                />
                
        </receiver>
    </application>

这样一个简单的Widget就完成了。其实想人人网的Widget还有腾讯微博的Widget都很复杂。这只是一个简单的入门。

我现在在分析android自带音乐播放器的MediaAppWidgetProvider.java，如果今天晚上能完成的话就发表出来。