Android AppWidget分析
简述
Android widget 也称为桌面插件,其是android系统应用开发层面的一部分,是微型的应用程序视图,它可以被嵌入到其它应用程序中(比如桌面)并接收周期性的更新。 Android系统增加了AppWidget 框架,用以支持widget类型应用的开发。
appwidget-provider标签
这个东西是用来定义桌面widget的大小,初始状态等等信息的,它的位置应该放在res/xml文件夹下,具体的xml参数如下:
<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider
android:initialLayout="@layout/example_widget"
android:minWidth="200dp"
android:minHeight="50dp"
android:updatePeriodMillis="2000"
android:resizeMode="horizontal|vertical"
android:widgetCategory="home_screen|keyguard"
xmlns:android="http://schemas.android.com/apk/res/android">
<!--
android:minWidth : 最小宽度
android:minHeight : 最小高度
android:updatePeriodMillis : 更新widget的时间间隔(ms)。在实际测试中,发现设置android:updatePeriodMillis的值为5秒时,不管用!跟踪android源代码,发现:
当android:updatePeriodMillis的值小于30分钟时,会被设置为30分钟。也就意味着,即使将它的值设为5秒,实际上也是30分钟之后才更新。因此,我们若向动态的更新widget的某组件,最好通过service、AlarmManager、Timer等方式;本文采用的是service
android:previewImage : 用于指定预览图片。即搜索到widget时,查看到的图片。若没有设置的话,系统为指定一张默认图片
android:initialLayout : 加载到桌面时对应的布局文件
android:resizeMode : widget可以被拉伸的方向。horizontal表示可以水平拉伸,vertical表示可以竖直拉伸
android:widgetCategory : widget可以被显示的位置。home_screen表示可以将widget添加到桌面,keyguard表示widget可以被添加到锁屏界面。
android:initialKeyguardLayout : 加载到锁屏界面时对应的布局文件
-->
</appwidget-provider>
注意:在构造Widget布局时,App Widget支持的布局和控件非常有限,有如下几个:
//App Widget支持的布局:
FrameLayout、LinearLayout、RelativeLayout、GridLayout
//App Widget支持的控件:
AnalogClock、Button、Chronometer、ImageButton、ImageView、ProgressBar、TextView、ViewFlipper、ListView、GridView、StackView、AdapterViewFlipper
除此之外的所有控件(包括自定义控件)都无法显示,无法显示时,添加出来的widget会显示“加载布局出错”。
实现AppWidgetProvider的子类。
AppWidgetProvider是BroadcastReceiver的子类,这个类处理App Widget广播。AppWidgetProvider只接收于App Widget有关系的广播,比如App Widget在updated, deleted, enabled, and disabled。当这些广播发生的时候,AppWidgetProvider会调用一下回调方法:
-
onUpdate(Context, AppWidgetManager, int[])间隔调用此方法去更新App Widget,间隔时间的设置是在AppWidgetProviderInfo下的updatePeriodMillis属性,同样当用户添加App Widget的时候也被调用。如果你已经声明了一个configuration Activity,用户添加App Widget的时候就不会调用onUpdate,但是在随后的更新中依然会被调用。
-
onDeleted(Context, int[])当App Widget 从App Widget host 中删除的时候调用。
-
onDeleted(Context, int[]) 当App Widget 从A