Android小工具开发（1501211016杨晓）
Android小工具开发
作者：杨晓 学院：软件与微电子学院 学号：1501211016
摘 要 安卓小工具（App Widgets）是可以嵌入在其他程序中运行的程序，小工具开发简单，支持的功能也有限，但是小巧精悍，常常用于在桌面显示一些关键信息，桌面上的日历，天气，时间，都是小工具的常见应用。 本文介绍了安卓上小工具开发的方方面面，对于常见的问题给出了解决方案。
关键字：android， widget，小工具
正文
开发小工具的一般流程： 1 修改manifest，添加AppWidgetProvider类型的Reciver，在meta-data中填写AppWidgetProviderInfo 配置文件,
<receiver android:name="AppWidget">
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE"></action>
</intent-filter>
<meta-data android:name="android.appwidget.provider"
android:resource="@xml/appwidget01" />
</receiver>
2 在res下新建xml目录，创建appwidget01：
<appwidget-provider
xmlns:android="http://schemas.android.com/apk/res/android"
android:minWidth = "294dp"
android:minHeight = "72dp"
android:updatePeriodMillis = "86400000"
android:initialLayout = "@layout/appwidgetlayout"
>
</appwidget-provider>
这是widget配置信息，updatePeriodMillis表示多久执行一次Widget的OnUpdate（），initialLayout表示layout文件。
3 创建layout文件 Widget支持以下的layout：
FrameLayout
LinearLayout
RelativeLayout
GridLayout
同时，支持以下的Widget Class
AnalogClock
Button
Chronometer
ImageButton
ImageView
ProgressBar
TextView
ViewFlipper
ListView
GridView
StackView
AdapterViewFlipper
4 创建类AppWidgetProvider
public class AppWidget extends AppWidgetProvider
{
private final String broadCastString = "com.qlf.appWidgetUpdate";
/**
* 删除一个AppWidget时调用
* */
@Override
public void onDeleted(Context context, int[] appWidgetIds)
{
super.onDeleted(context, appWidgetIds);
}
/**
* 最后一个appWidget被删除时调用
* */
@Override
public void onDisabled(Context context)
{
super.onDisabled(context);
}
/**
* AppWidget的实例第一次被创建时调用
* */
@Override
public void onEnabled(Context context)
{
super.onEnabled(context);
}
/**
* 接受广播事件
* */
@Override
public void onReceive(Context context, Intent intent)
{
super.onReceive(context, intent);
}
/**
* 到达指定的更新时间或者当用户向桌面添加AppWidget时被调用
* */
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
int[] appWidgetIds)
{
}
}
5 运行程序，在桌面上长按，就可以看到小工具，拖动到桌面上，done！
6 接下来为天气预报开发一个小工具，显示当前天气，温度。
AppWidgetManager widgetmanager = AppWidgetManager.getInstance(MyService.this);
ComponentName name = new ComponentName(MyService.this,AppWidget.class);// 获取前面参数包下的后参数的Widget
RemoteViews views = new RemoteViews("cn.itcast.mobilesafe",
R.layout.appwidgetlayout);// 获取Widget的布局
views.setTextViewText(R.id.todayWeather, "北京 雾霾 pm2.5 1000");//
widgetmanager.updateAppWidget(name, views);//更新Widget
可以看出对widget的更新是通过RemoteViews实现的。
Widget的生命周期： Widget有以下的生命周期方法： 1.onEnabled方法：此方法在Widget第一次被创建的时候调用，并且只调用一次，此方法中常放入初始化数据，服务的操作。
2.onReceive方法：通BroadcastReceiver的OnReceive方法，但是这里有所不同的是，当接收到Widget操作时首先调用的是OnReceive方法，然后才是相关的操作方法。这也很好理解，Widget的是运行在桌面运用程序中的小控件，当自己的应用程序需要调用Widget是，就需要发送广播事件去调用。
3.onUpdate：Widget在固定的时间里更新时调用的方法。
4.onDeleted：Widget被删除时调用的方法。
5.onDisabled：所用Widget被删除是调用的方法，同onEnabled方法相对。
使用PendingIntent 对Widget的事件的处理要通过pendingIntent进行。 pendingIntent是一种特殊的Intent。主要的区别在于Intent的执行立刻的，而pendingIntent的执行不是立刻的。pendingIntent执行的操作实质上是参数传进来的Intent的操作，但是使用pendingIntent的目的在于它所包含的Intent的操作的执行是需要满足某些条件的。
// Create an Intent to launch ExampleActivity
Intent intent = new Intent(context, ExampleActivity.class);
PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);
// Get the layout for the App Widget and attach an on-click listener
// to the button
RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.appwidget_provider_layout);
views.setOnClickPendingIntent(R.id.button, pendingIntent);
// Tell the AppWidgetManager to perform an update on the current app widget
appWidgetManager.updateAppWidget(appWidgetId, views);
设置预览图 在选择小工具界面会显示预览图，如果没有设置预览图，将会显示app的图标。 预览图在XML中配置：
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
...
android:previewImage="@drawable/preview">
</appwidget-provider>
在锁屏界面上显示小工具 最好让我们的天气预报小工具能在锁屏界面直接显示，这么我们就不用麻烦的解锁了。 只要进行稍许配置，就能实现在锁屏界面上显示小工具：
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
...
android:widgetCategory="keyguard|home_screen">
</appwidget-provider>
现在我们的小工具既可能出现在桌面上，也可能在解锁界面上，我们可能需要对这两种情况配置不同的界面 首先我们需要获取当前处在哪个界面上：
AppWidgetManager appWidgetManager;
int widgetId;
Bundle myOptions = appWidgetManager.getAppWidgetOptions (widgetId);
// Get the value of OPTION_APPWIDGET_HOST_CATEGORY
int category = myOptions.getInt(AppWidgetManager.OPTION_APPWIDGET_HOST_CATEGORY, -1);
// If the value is WIDGET_CATEGORY_KEYGUARD, it's a lockscreen widget
boolean isKeyguard = category == AppWidgetProviderInfo.WIDGET_CATEGORY_KEYGUARD;
然后再根据不同的情况选择不同的layout：
int baseLayout = isKeyguard ? R.layout.keyguard_widget_layout : R.layout.widget_layout;
使用集合的widget 我们可以使用RemoteViewsService提供的数据，将一系列数据显示在widget里面，我们需要用到以下的”collection view”: 1 List View，显示一列纵向滚动的数据，比如Gmail小工具 2 Grid View，显示2维数据，比如Bookmarks小工具 3StackView，以卡片盒子的形式显示数据
4AdapterViewFlipper，显示多个view，可以在多个view之间切换。每次只显示一个view
如上所述，这些collection views将显示由远程数据所组成的数据集合.这就意味着我们需要一个Adapter来把数据绑定到视图。 这个Adapter要负责把数据集的单个数据项和单个View对象进行绑定.因为collection views是由adapters在后台提供的, 所以Android framework必须使用另外一种框架来支持在app widgets中使用它们. 在app widget应用中, 我们使用RemoteViewsFactory来代替Adapter , RemoteViewsFactory提供了和Adapter类似的接口.当请求数据集的一个数据项的时候，RemoteViewsFactory将以一个RemoteViews的形式返回数据集的一个数据项.为了在app widget中能使用collection view, 你必须实现一个RemoteViewsService和RemoteViewsFactory RemoteViewsService是一个service，远程的adapter可以通过它请求并获得RemoteViews对象.
实现一个collection view有如下步骤：
1 配置widget的RemoteViewService，为了让Widget正确的从RemoteViewsService获取数据，我们为RemoteViewService配置BIND_REMOTEVIEWS，这种策略确保我们的Widget不会被别的app篡改。RemoteViewService大概是这样：
2 在layout文件中使用collection view：
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent">
<StackView xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/stack_view"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:gravity="center"
android:loopViews="true" />
<TextView xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/empty_view"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:gravity="center"
android:background="@drawable/widget_item_background"
android:textColor="#ffffff"
android:textStyle="bold"
android:text="@string/empty_view_text"
android:textSize="20sp" />
</FrameLayout>
除了这个布局文件，你改要编写另外的布局文件，以用于数据项的View布局。比如，在StackView Widget示例程序中它只有一个用于数据项显示的View布局的文件, widget_item.xml。而在WeatherList Widget示例程序中，它只有两个用于数据项显示的View布局的文件: dark_widget_item.xml和light_widget_item.xml
3 AppWidgetProvider app widgets with collections像一般的app widget一样，你主要代码应该在AppWidgetProvider的onUpdate()方法中。 主要区别在于，在 app widgets with collections中，你必须对RemoteViews调用setRemoteAdapter方法。这个函数能告诉collection view能在哪里取得它的数据.。RemoteViewsService必须能返回一个RemoteViewsFactory对象。当你调用setRemoteAdapter()方法的时候, 你必须传递一个用于启动你的RemoteViewsService的intent和一个App Widget ID用于说明对哪个app widget进行更新.
4 RemoteViewsService
如上面描述那样, 你的RemoteViewsService应该编写一个RemoteViewsFactory，以提供数据项的remote collection view. 具体来说，您需要执行这些步骤： 第一、新建一个RemoteViewsService的子类. RemoteViewsService是个service，通过它remote adapter可以请求并获得RemoteViews. 第二，在你RemoteViewsService的子类中, 添加一个实现了RemoteViewsFactory接口的方法. RemoteViewsFactory为collection view (such as ListView, GridView, and so on)和collection view的数据提供了适配接口。在RemoteViewsFactory中，你要负责为数据集的每个数据项提供一个RemoteViews对象. RemoteViewsFactory相等于Adapter的一个精简版本。 编写RemoteViewsService的主要工作集中在RemoteViewsFactory,关于次将在下文进行介绍
5、RemoteViewsFactory interface 你的RemoteViewsFactory需要为app widget提供数据集的每个数据项其对应的RemoteViews对象 为此, 你需要用app widget数据项的View布局文件和数据集的数据项来合成RemoteViews对象。数据源可以为任何形式，可以是一个简单的数组，也来自于数据库。在StackView Widget示例程序中, 数据源是个WidgetItems数组. RemoteViewsFactory的主要功能就是把数据变成 RemoteViews. 在RemoteViewsFactory中，你主要需要实现onCreate() 和getViewAt()这两个方法 。 当RemoteViewsFactory首次被创建时，onCreate()方法将被调用. 在该函数中，你应该做些初始工作，比如建立针对你的数据源的连接或光标。比如, 在StackView Widget示例程序中的onCreate()方法中， 就初始了一个WidgetItem对象数组. 当你app widget活动的时候, 系统可以通过数组索引号来访问这些WidgetItem对象。
6，设置数据项View的行为 在普通的App Widgets中，我们可以通过setOnClickPendingIntent()来设置View控件Click时，发送的Intent.通过次方法，我们就可以实现当用户点击一个按钮时，就启动一个Activity.但是这种方法对app widget collection的数据集的数据项View并不适用（你可以像Gmail app widget中一样通过setOnClickPendingIntent()来设置global button的click行为来启动一个应用程序, 但是对数据集的数据项View不能使用这种方法）。替代的是首先使用setOnClickFillInIntent()方法为数据集的数据项View统一设置其Pending的Intent模板,然后在RemoteViewsFactory中为数据集的数据项View的Pending的Intent模板的设置填充Intent。这样当数据项View在Click时，发送的Intent将是其Pending的Intent模板和其Pending的Intent模板填充Intent合成的Intent。
7，更新collection view 下图说明了App Widget with Collections如何进行数据更新。它也给我们展示了App Widget代码如何和RemoteViewsFactory进行交互, 和我们App Widget with Collections应该如何请求进行数据更新。 App Widgets with collections的一个重要属性就是可以让用户进行手动更新数据.比如Android 3.0中的Gmail app widget, 提供邮件快照的inbox. 为了显示最新的数据, 你需要让RemoteViewsFactory提取数据并更新collection view的显示. 你可以通过调用AppWidgetManager的notifyAppWidgetViewDataChanged (int appWidgetId, int viewId)方法来请求更新. 调用了该方法之后，系统会对RemoteViewsFactory的onDataSetChanged()方法进行回调, 在这里你可以进行最新数据的提取. 注意:你可以在 onDataSetChanged()回调函数中做一些耗时工作（同步的）的处理。系统将保证这些操作在从RemoteViewsFactory返回新数据的信息或View之前完成。 另外, 你可以在getViewAt()返回中进行耗时操作的处理. 如果getViewAt()超过一定的时限，系统就先用RemoteViewsFactory的getLoadingView()返回的View进行显示，直到getViewAt()完成。
参考文献：
[1]Android中pendingIntent的深入理解,http://blog.csdn.net/yuzhiboyi/article/details/8484771
[2]官方文档，http://wear.techbrood.com/guide/topics/appwidgets/index.html#collections
[3]Android widgets应用学习笔记,http://mobile.51cto.com/widget-290434.htm