Android桌面小部件开发，及注意事项
抓住人生中的一分一秒，胜过虚度中的一月一年!
首先看下效果
demo.gif
背景
在Android手机中，我们经常会看到各种桌面小部件，天气、音乐播放器、时间表盘等，虽然常见，但是我们着手开发的还是较少，其实桌面小部件开发起来很简单，但是还是可能会走一些弯路，下面给大家介绍一下如何实现桌面小部件
分析 官方文档直通车
桌面小部件AppWidget开发，需要使用官方提供的AppWidgetProvider来实现，点卡源码会看到AppWidgetProvider继承的是BroadcastReceiver，其实它就是一个广播，可以理解为通过广播去修改UI
一、新建UI布局
说到小部件，那必然会有UI，首先我们在Xml下建个小部件UI布局，如my_app_widget.xml,内容随便写，但注意事项是：Widget并不支持所有的控件跟布局，而仅仅只是支持Android布局和控件的一个子集
1、支持布局：FrameLayout，LinearLayout，RelativeLayout，GridLayout
2、支持控件：AnalogClock，Button，Chronometer，ImageButton，ImageView，ProgressBar，TextView，ViewFlipper，ListView，GridView，StackView，AdapterViewFlipper
二、定义小部件配置信息
在项目res目录下，新建一个名字为xml目录，然后在res/xml/目录下创建一个配置文件，名称随意如my_app_widget_info.xml
<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
android:initialLayout="@layout/new_app_widget"
android:minHeight="@dimen/dp_80"
android:minWidth="@dimen/dp_400"
android:previewImage="@drawable/ic_zuomian"
android:updatePeriodMillis="864000"
android:widgetCategory="home_screen|keyguard">
<!--android:resizeMode="horizontal|vertical"-->
</appwidget-provider>
针对上述文件中的配置信息来做下介绍。
1、minHeight、minWidth 定义Widget的最小高度和最小宽度（Widget可以通过拉伸来调整尺寸大小）
2、previewImage 定义添加小部件时显示的图标
3、initialLayout 定义了小部件使用的布局。
4、updatePeriodMillis定义小部件自动更新的周期，单位为毫秒。
5、resizeMode 指定了 widget 的调整尺寸的规则。可取的值有: “horizontal”,“vertical”,“none”。”horizontal”意味着widget可以水平拉伸，“vertical”意味着widget可以竖值拉伸，“none”意味着
widget 不能拉伸；默认值是”none”。
6、widgetCategory 指定了 widget 能显示的地方：能否显示在 home Screen 或 lock screen 或 两者都可以。它的取值包括：”home_screen” 和 “keyguard”。Android 4.2 引入。
注意事项：android:previewImage定义的图标，本人测试了下，如果图片放到mipmap中，图片虽是矩形，但是显示出来还是圆形，故如果图片是矩形需要放到drawable中
三、定义小部件类MyAppWidget，继承自AppWidgetProvider
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.Context;
import android.content.Intent;
import android.os.Bundle;
import android.util.Log;
public class MyAppWidget extends AppWidgetProvider {
/**
* 接收窗口小部件点击时发送的广播
*/
@Override
public void onReceive(Context context, Intent intent) {
super.onReceive(context, intent);
}
/**
* 每次窗口小部件被更新都调用一次该方法
*/
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
super.onUpdate(context, appWidgetManager, appWidgetIds);
Log.i("AppWidget", "开始了更新");
RemoteViews rv = new RemoteViews(AppUMS.mContent.getPackageName(), R.layout.my_app_widget);
//这里获得当前的包名，并且用AppWidgetManager来向NewAppWidget.class发送广播。
AppWidgetManager manager = AppWidgetManager.getInstance(AppUMS.mContent);
ComponentName cn = new ComponentName(AppUMS.mContent, NewAppWidget.class);
manager.updateAppWidget(cn, rv);
}
/**
* 每删除一次窗口小部件就调用一次
*/
@Override
public void onDeleted(Context context, int[] appWidgetIds) {
super.onDeleted(context, appWidgetIds);
//context.stopService(new Intent(context, WidgetService.class));
Log.i("AppWidget", "删除成功！");
}
/**
* 当该窗口小部件第一次添加到桌面时调用该方法
*/
@Override
public void onEnabled(Context context) {
super.onEnabled(context);
// Intent mTimerIntent = new Intent(context, WidgetService.class);
// context.startService(mTimerIntent);
Log.i("AppWidget", "创建成功！");
}
/**
* 当最后一个该窗口小部件删除时调用该方法
*/
@Override
public void onDisabled(Context context) {
super.onDisabled(context);
// Intent mTimerIntent = new Intent(context, WidgetService.class);
// context.stopService(mTimerIntent);
Log.i("AppWidget", "删除成功！");
}
/**
* 当小部件大小改变时
*/
@Override
public void onAppWidgetOptionsChanged(Context context, AppWidgetManager appWidgetManager, int appWidgetId, Bundle newOptions) {
super.onAppWidgetOptionsChanged(context, appWidgetManager, appWidgetId, newOptions);
}
/**
* 当小部件从备份恢复时调用该方法
*/
@Override
public void onRestored(Context context, int[] oldWidgetIds, int[] newWidgetIds) {
super.onRestored(context, oldWidgetIds, newWidgetIds);
}
}
四、在AndroidManifest.xml中注册小部件
<!--广播接收参数-->
<receiver android:name=".receiver.MyAppWidget">
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
<action android:name="com.bwkj.qcxbm.widget.UPDATE_ALL" />
</intent-filter>
<meta-data
android:name="android.appwidget.provider"
android:resource="@xml/my_app_widget_info" />
</receiver>
通过上述各种步骤运行完毕即可实现桌面小部件样式，细节问题还需要优化
问题1：如何更新桌面小部件内容信息？
答：其实关键性的是这一步
RemoteViews rv = new RemoteViews(AppUMS.mContent.getPackageName(), R.layout.my_app_widget);``
//这里获得当前的包名，并且用AppWidgetManager来向NewAppWidget.class发送广播。
AppWidgetManager manager = AppWidgetManager.getInstance(AppUMS.mContent);
ComponentName cn = new ComponentName(AppUMS.mContent, NewAppWidget.class);
manager.updateAppWidget(cn, rv);
执行一次这个方法，相当于给桌面小部件发了个更新广播，对应桌面部件也会相应改变，所以我们可以将上述方法封装成一个工具类
问题2：对如何获取并设置布局中控件样式，如颜色，字体大小，内容等
答：RemoteViews没有提供findViewById方法，因为RemoteViews在远程进程中显示，因此无法直接访问里面的View元素，而必须通过RemoteViews所提供的一系列set方法来完成，部分set方法如下所示：
picture.png
问题3：如果app被杀死了，布局该如何设置之前的内容，因为是动态的，暂时缓存的数据都已获取不到
答：我目前是这样操作的，只供参考，将从服务器拉下来的最新数据保存到sp中（请求一次服务器保存一次最新的，更新一次小部件UI），从数据库中拉数据进行显示
有发现的问题提出我将进行继续完善，祝大家开发顺利！
