appWidget是显示的桌面上的小窗口程序,通过它可以达到用户与程序之间的交互。
下面我们来看下创建一个appWidget的步骤
一、首先在layout文件夹下创建一个appWidget的布局文件appwidgetlayout.xml, 在这里你可以添加一些需要在appWidget上显示的控件,如下:我只添加一个文本控件
<?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:id="@+id/txtapp" android:layout_width="fill_parent" android:layout_height="wrap_content" android:background="#ffffff" android:text="@string/bnt_name" > </TextView> </LinearLayout>
二、创建一个xml文件配置appWidget的显示属性,在res目录创建一个xml目录,在下面创建一个appwidget.xml文件,其实也可以把这个文件放在layout目录下,为了方便管理,我还是把它放在xml目录下,在这个目录下可以放置任何的xml文件。如下:
<?xml version="1.0" encoding="utf-8"?> <appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android" android:initialLayout="@layout/appwidgetlayout" android:minHeight="72dp" android:minWidth="294dp" android:updatePeriodMillis="86400000" > </appwidget-provider>
三、在AndroidMainfest.xml下要声明一个广播接收器,如
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.appwidgetdemo"
android:versionCode="1"
android:versionName="1.0" >
<uses-sdk
android:minSdkVersion="8"
android:targetSdkVersion="17" />
<application
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >
<activity
android:name="com.example.appwidgetdemo.MainActivity"
android:label="@string/app_name" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<receiver android:name="com.example.appwidgetdemo.appWidgetActivity" >
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE" >
</action>
</intent-filter>
<meta-data
android:name="android.appwidget.provider"
android:resource="@xml/appwidget" />
</receiver>
</application>
</manifest>
四、创建一个类继承AppWidgetProvider
重载以下几个函数,根据需要进行处理
1、public void onDeleted(Context context, int[] appWidgetIds) 删除一个AppWidget时调用
2、public void onDisabled(Context context) 最后一个appWidget被删除时调用
3、public void onEnabled(Context context) AppWidget的实例第一次被创建时调用
4、public void onReceive(Context context, Intent intent) 接收广播事件,可以接收系统的也可以接收自定义的
5、public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) 到达指定的更新时间或者当用户向桌面添加AppWidget时被调用
代码如下:
package com.example.appwidgetdemo; import android.appwidget.AppWidgetManager; import android.appwidget.AppWidgetProvider; import android.content.Context; import android.content.Intent; public class appWidgetActivity extends AppWidgetProvider { /** * 删除一个AppWidget时调用 */ @Override public void onDeleted(Context context, int[] appWidgetIds) { // TODO Auto-generated method stub super.onDeleted(context, appWidgetIds); System.out.println("----------------onDeleted"); } /** * 最后一个appWidget被删除时调用 */ @Override public void onDisabled(Context context) { // TODO Auto-generated method stub super.onDisabled(context); System.out.println("----------------onDisabled"); } /** * AppWidget的实例第一次被创建时调用 */ @Override public void onEnabled(Context context) { // TODO Auto-generated method stub super.onEnabled(context); System.out.println("----------------onEnabled"); } /** * 接受广播事件 */ @Override public void onReceive(Context context, Intent intent) { // TODO Auto-generated method stub super.onReceive(context, intent); System.out.println("----------------onReceive"); } /** * 到达指定的更新时间或者当用户向桌面添加AppWidget时被调用 */ @Override public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) { System.out.println("----------------onUpdate"); // TODO Auto-generated method stub } }
五、运行程序
程序运行后需要通过以下几点才能把appWidget小程序显示出来
1、如果是模拟器按鼠标左键不动会弹出如下窗口
2、点击“窗口小部件”会弹出如下窗口,显示出所有的appWidget窗口
3、选择我们刚才安装的部件,在主界面上显示如下:
至此我们第一个appWidget程序已经完成。
本例源码可以到以下链接下载: