Android -- Widget
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状态的变化并进行相应的处理。
- 启动 - 无confiure Activity
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，如需转载请自行联系原作者
