AppWidget 就是HomeScreen上显示的小部件，提供直观的交互操作。通过在HomeScreen中长按，在弹出的对话框中选择Widget部件来进行创建，长按部件后并拖动到垃圾箱里进行删除。同一个Widget部件可以同时创建多个。
AppWidget的实现主要涉及到以下类：
- AppWidgetProvider
- RemoteViews
- AppWidgetManager
布局
首先需要提供一个定义了Widget界面布局的XML文件，需要注意的是使用的组件必须是RemoteViews所支持的，目前原生API中支持的组件如下：
FrameLayout/LinearLayout/RelativeLayout/AnalogClock/Button/Chronmeter/ImageButton/ImageView/ProgressBar/TextView
注意：如果使用了除此之外的组件，则在Widget创建时会导致android.view.InflateExceptionn异常。
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
android:background="@drawable/rectangle" >
<TextView
android:layout_width="match_parent"
android:layout_height="match_parent"
android:id="@+id/tv"
android:text="lalala"/>
</LinearLayout>
属性
需要提供一个xml文件来定义Widget的基本属性，放置到res/xml/..目录下。操作：
- 在res/目录下创建xml/目录
- 创建xml文件（名字可任意），选择类型为AppWidgetProvider
- 在弹出的便捷界面进行参数设置
主要设置的参数如下:
minWidth: 定义Wdiget组件的宽度
minHeight: 定义Wdiget组件的高度
updatePeriodMillis: 更新的时间周期
initialLayout: Widget的布局文件
configure: 如果需要在启动前先启动一个Activity进行设置，在这里给出Activity的完整类名(后面会说到，与一般Activity的实现有些许差别)
<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
android:initialLayout="@layout/time_appwidget"
android:minHeight="72dp"
android:minWidth="294dp"
android:updatePeriodMillis="0" >
</appwidget-provider>
周期
xml都定义好后，接下来就是创建一个继承自AppWidgetProvider的子类，AppWidgetProvider实际上就是一个BroadcastReceiver，里面提供了以下函数：
onReceive(Context, Intent)
onUpdate(Context , AppWidgetManager, int[] appWidgetIds)
onEnabled(Context)
onDeleted(Context, int[] appWidgetIds)
onDisabled(Context)
可通过重写以上函数来监听Widget状态的变化并进行相应的处理。
onReceive –> onEnabled —— 第一个widget被显示 –> onReceive –> onUpdate —— 刷新界面
- 启动 - 带confiuration Activity
onReceive –> onUpdate
<无状态变化>
onReceive –> onUpdate
onReceive –> onDeleted —— widget被删除 –> onReceive –> onDisabled —— 最后一个widget被移除
onReceive –> onEnabled –> onReceive –> onUpdate –> onReceive –> onDeleted –> onReceive –> onDisabled
配置
<receiver android:name=".WidgetsStudy" >
<intent-filter >
<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
</intent-filter>
<meta-data android:name="android.appwidget.provider"
android:resource="@xml/appwidget_info"/>
</receiver>
<service android:name=".TimeService"></service>
代码
在服务中更新Widget中的内容：
public class TimeService extends Service {
private Timer timer;
@Override
public IBinder onBind(Intent intent) {
// TODO 自动生成的方法存根
return null;
}
@Override
public void onCreate() {
timer = new Timer();
timer.scheduleAtFixedRate(new TimeUpdateTask(), 0, 1000);
super.onCreate();
}
private final class TimeUpdateTask extends TimerTask {
@Override
public void run() {
SimpleDateFormat dateFormat = new SimpleDateFormat(
"yyyy-MM-dd HH:mm:ss");
String time = dateFormat.format(new Date());
RemoteViews rom = new RemoteViews(getPackageName(),
R.layout.time_appwidget);
rom.setTextViewText(R.id.tv, time);
AppWidgetManager awm = AppWidgetManager
.getInstance(getApplicationContext());
awm.updateAppWidget(new ComponentName(getApplicationContext(),
WidgetsStudy.class), rom);
}
}
@Override
public void onDestroy() {
timer.cancel();
timer = null;
super.onDestroy();
}
}
AppWidgetProvider中：
public class WidgetsStudy extends AppWidgetProvider {
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
int[] appWidgetIds) {
super.onUpdate(context, appWidgetManager, appWidgetIds);
}
@Override
public void onDeleted(Context context, int[] appWidgetIds) {
// TODO 自动生成的方法存根
super.onDeleted(context, appWidgetIds);
}
@Override
public void onEnabled(Context context) {
context.startService(new Intent(context, TimeService.class));
super.onEnabled(context);
}
@Override
public void onDisabled(Context context) {
context.stopService(new Intent(context, TimeService.class));
super.onDisabled(context);
}
}
我是天王盖地虎的分割线
本文转自我爱物联网博客园博客，原文链接：http://www.cnblogs.com/yydcdut/p/3841141.html，如需转载请自行联系原作者
