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，如果今天晚上能完成的话就发表出来。
