[安卓开发]App Widget开发入门指导

本节所要讲的主要内容包括Android桌面小部件、App Widget的开发入门指导，并通过一个简单实例的形式来直观的讲解App Widget。

一、Widget 、App Widget 、Web App 的概念

Widget最初的概念是98年一个叫Rose的苹果工程师提出，直到2003年的时候才正式为大家所知，不过随后无数大公司都开始接受并应用这一思路。现在我们看到在苹果系统里按下F4弹出的Dashboard里的小工具叫Widget，在Windows 7里侧边栏上的那些漂亮的小工具叫Gadget（widget变体?），除此以外还有yahoo Widget等等Widget产品。他们有一个共同的特点就是采用前台Web开发用的技术（譬如HTML、CSS、Javascript）来制作的小工具、小部件。

在Android系统里，几乎每个可视化的View组件都叫Widget，起这个名字可能当时是为了赶时髦。

App Widget是从Android 1.5以后才有的东东，就是可以放在Android桌面上的应用程序小组件。这一点上看他的功能很像windows的侧边栏小工具，可惜的是他的采用技术并不是HTML等技术。当然App Widget才是我们本讲的主角，本来他应该顺理成章叫做Widget的，至少也要叫做Gadget吧，可惜这个名字已经被他自己的系统占用了，所以只好改名叫App Widget。

最后讲一下Web App 或者说是Android Web Application，也许叫mobile web application 更准确些。我们发现现在智能机系统平台很多，譬如iOS、Android、Windows Phone 、WebOS、BlackBerry等等，它们采用的技术框架也各不相同，有没有办法写一个程序在各个系统上都能运行呢？答案是肯定的，写基于Webkit的浏览器的应用即可。我们使用 HTML5、CSS3、JavaScript、WebKit 等技术来写的Web Application也许是今后的一个大潮流也说不准啊。有机会我们再讲讲Android Web Application 的开发。

二、App Widget 的简单例子：Hello App Widget

App Widget的技术实现有那么一点点绕，我们用一个最简单的例子Hello App Widget来操作一遍，然后再针对这个例子做讲解，也许你会理解的更快些。

1、新建一个项目 Lesson35_HelloAppWidget ，注意创建时可以不选Create Activity。

2、准备好一个Widget的显示布局文件 layout/widget.xml，内容如下：

XML/HTML代码

1. <?xml version="1.0" encoding="utf-8"?>
2. <linearlayout android:layout_height="fill_parent" android:layout_width="fill_parent" android:orientation="vertical" xmlns:android="http://schemas.android.com/apk/res/android" android:gravity="center">
3. <textview android:layout_height="wrap_content" android:layout_width="wrap_content" android:id="@+id/textView1" android:text="欢迎进入App Widget的世界！" android:textcolor="#ff0000ff">
4. </textview></linearlayout>

3、准备好一个Widget的配置文件 xml/provider_info.xml，该文件配置了widget可以占用的屏幕长宽、更新频率，所显示的布局文件（就是上面的那个布局文件）等，其内容如下：

XML/HTML代码

1. <?xml version="1.0" encoding="utf-8"?>
2. <!-- appwidget-provider Widget的配置文件  -->
3. <!-- android:minWidth 最小宽度 -->
4. <!-- android:minHeight 最小高度 -->
5. <!-- android:updatePeriodMillis 组件更新频率（毫秒） -->
6. <!-- android:initialLayout 组件布局XML的位置 -->
7. <!-- android:configure Widget设置用Activity -->
8. <appwidget -provider="" xmlns:android="http://schemas.android.com/apk/res/android" android:initiallayout="@layout/widget" android:updateperiodmillis="86400000" android:minheight="72dp" android:minwidth="294dp">
9. </appwidget>

4、准备好一个处理widget请求的Java文件，basic.android.lesson35包下的HelloWidgetProvider，他继承了AppWidgetProvider类，在本例中没有任何请求处理的具体代码，我在java文件中写了大量注释，方便你的理解。内容如下：

Java代码

1. package basic.android.lesson35;
2. import android.appwidget.AppWidgetManager;
3. import android.appwidget.AppWidgetProvider;
4. import android.content.Context;
5. import android.content.Intent;
6. import android.util.Log;
7. // AppWidgetProvider 是 BroadcastReceiver 的子类，本质是个 广播接收器，它专门用来接收来自 Widget组件的各种请求（用Intent传递过来），所以如果让我给他起名的话 我会给他命名为AppWidgetReceiver,每一个Widget都要有一个AppWidgetProvider.
8. public class HelloWidgetProvider extends AppWidgetProvider {
9. //每个请求都会传递给onReceive方法，该方法根据Intent参数中的action类型来决定自己处理还是分发给下面四个特殊的方法。
10. @Override
11. public void onReceive(Context context, Intent intent) {
12. Log.i("yao", "HelloWidgetProvider --> onReceive");
13. super.onReceive(context, intent);
14. }
15. //如果Widget自动更新时间到了、或者其他会导致Widget发生变化的事件发生，或者说Intent的值是android.appwidget.action.APPWIDGET_UPDATE，那么会调用onUpdate，下面三个方法类似
16. @Override
17. public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
18. //AppWidgetManager 顾名思义是AppWidget的管理器，appWidgetIds 桌面上所有的widget都会被分配一个唯一的ID标识，那么这个数组就是他们的列表
19. Log.i("yao", "HelloWidgetProvider --> onUpdate");
20. super.onUpdate(context, appWidgetManager, appWidgetIds);
21. }
22. //当一个App Widget从桌面上删除时调用
23. @Override
24. public void onDeleted(Context context, int[] appWidgetIds) {
25. Log.i("yao", "HelloWidgetProvider --> onDeleted");
26. super.onDeleted(context, appWidgetIds);
27. }
28. //当这个App Widget第一次被放在桌面上时调用(同一个App Widget可以被放在桌面上多次，所以会有这个说法)
29. @Override
30. public void onEnabled(Context context) {
31. Log.i("yao", "HelloWidgetProvider --> onEnabled");
32. super.onEnabled(context);
33. }
34. //当这个App Widget的最后一个实例被从桌面上移除时会调用该方法。
35. @Override
36. public void onDisabled(Context context) {
37. Log.i("yao", "HelloWidgetProvider --> onDisabled");
38. super.onDisabled(context);
39. }
40. }

5、配置AndroidManifest.xml文件，增加一个receiver标签，这个标签看起来很像前面讲的BroadReceiver的配置，具体内容如下：

XML/HTML代码

1. <?xml version="1.0" encoding="utf-8"?>
2. <manifest xmlns:android="http://schemas.android.com/apk/res/android" android:versionname="1.0" android:versioncode="1" package="basic.android.lesson35">
3. <uses -sdk="" android:minsdkversion="7">
4. <application android:icon="@drawable/icon" android:label="@string/app_name">
5. <!-- receiver的 android:name指向的是widget的请求处理器或者说请求接收者 -->
6. <receiver android:label="Hello,App Widget" android:name=".HelloWidgetProvider">
7. <intent -filter="">
8. <!-- widget默认的事件action -->
9. <action android:name="android.appwidget.action.APPWIDGET_UPDATE"></action>
10. </intent>
11. <!-- widget元数据,name是写死的，resource指的是widget的配置文件 -->
12. <meta -data="" android:name="android.appwidget.provider" android:resource="@xml/provider_info">
13. </receiver>
14. </application>
15. </uses></manifest>

6、编译并运行程序，我们知道这种Widget程序，即使装完了也不会在程序列表中出现，因为它根本就没有main Activity，下面我给不清楚的同学说一下如何把一个widget放到桌面上。

在模拟器上桌面上长按，等待弹出下面对话框：

选择窗口小部件：

选择Hello，App Widget：