App Widgets是一个应用程序的小视图,可以嵌入到其他应用程序(如主屏幕)并且能够定期更新。你可以发布一个应用程序的App Widget,而这些视图称为窗口的用户界面。
参照官方文档,一般情况下,创建一个Widget的步骤主要包括如下的几个:
需要修改三个XML,一个class:
1)第一个xml是布局XML文件(如:main.xml),是这个widget的。一般来说如果用这个部件显示时间,那就只在这个布局XML中声明一个textview就OK了。
2)第二个xml是widget_provider.xml,主要是用于声明一个appwidget的。其中,Layout就是指定上面那个main.xml。
3)第三个xml是AndroidManifest.xml,注册broadcastReceiver信息。
4)最后那个class用于做一些业务逻辑操作。让其继承类AppWidgetProvider。AppWidgetProvider中有许多方法,一般情况下我们只是覆写onUpdate(Context,AppWidgetManager,int[])方法。
第一:创建一个xml文件夹,然后声明文件:example_appwidget_info.xml<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
android:initialLayout="@layout/main"
android:minHeight="72dp"
android:minWidth="294dp"
android:updatePeriodMillis="86400000" >
</appwidget-provider>
看参数不难理解,比较重要的是这里
android:initialLayout
="@layout/main"
此句为指定桌面组件的布局文件。其他的参数分别是显式的高度和宽度等信息,需要注意的是:在官方文档的声明中android:previewImage="@drawable/preview",这句在sdk2.2中会报错。
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:orientation="vertical" >
<TextView
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="我就是widget要声明的内容" />
</LinearLayout>
这里主要是演示,因此声明的比较简单。
<receiver android:name="MyWeidgetActivity" >
<intent-filter >
<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
</intent-filter>
<meta-data
android:name="android.appwidget.provider"
android:resource="@xml/example_appwidget_info" />
</receiver>
为什么要声明为receiver类型的呢是不是和广播接受者有关呢?留个悬念,后续会有相关的介绍。
好了,到此就要告一段落了,通过控制台可以发现,此时的信息就变为了
[2012-07-23 00:27:26 - MyWeidget] Performing sync
[2012-07-23 00:27:26 - MyWeidget] Automatic Target Mode: using device '0123456789ABCDEF'
[2012-07-23 00:27:26 - MyWeidget] Uploading MyWeidget.apk onto device '0123456789ABCDEF'
[2012-07-23 00:27:26 - MyWeidget] Installing MyWeidget.apk...
[2012-07-23 00:27:29 - MyWeidget] Success!
[2012-07-23 00:27:29 - MyWeidget] \MyWeidget\bin\MyWeidget.apk installed on device
[2012-07-23 00:27:29 - MyWeidget] Done!
启动成功。