Android基础教程之---AppWidget讲解1

什么是AppWidget？AppWidget就是我们平常在桌面上见到的那种一个个的小窗口，利用这个小窗口可以给用户提供一些方便快捷的操作。

创建简单的AppWidget

首先看下运行的效果图：



项目结构文件



AppWidgetProviderInfo对象：为AppWidget提供元数据，包括布局，更新频率等数据。这个对象被定义在xml文档中；

AppWidgetProvider：定义AppWidget基本生命周期函数。

第一步：

首先在res文件夹下新建一个名字为xml的文件夹，然后在xml目录下创建一个名为example_appwidget_info的xml文件。这个example_appwidget_info中的内容如下：

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
android:minWidth="294dp"
android:minHeight="72dp"
android:updatePeriodMillis="86400000"
android:initialLayout="@layout/example_appwidget"
>
</appwidget-provider>

这个xml是用来描述你所要创建的appWidget的一些描述信息的，比如高度、宽度、刷新间隔、布局文件等等。仅仅这个描述文件还不够，我们看到的appWidget可都是有界面元素的呀，比如说文本，图片，按钮等等，这些东西的定义都需要放到layout文件夹下面。这个文件就是上面代码中写到的那个appwidgetlayout。

第二步：

在layout文件夹下面新建一个example_appwidget.xml文件，在这个文件中描述了appWidget的控件和布局等等信息，就和我们平常创建的一个activity的布局文件没什么两样，因为只是简单的演示，所以仅用一个文本和一个按钮。xml的内容如下：

<?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" >

<Button
android:id="@+id/Button01"
android:layout_width="80dp"
android:layout_height="80dp"
android:text="Widget"/>

</LinearLayout>

第三步：

既然appWidget中存在按钮等等控件，那么就肯定少不了处理这些控件事件的处理代码啦。这些代码被放在一个继承于AppWidgetProvider的类中，在本例子中我新建了一个ExampleAppWidgetProvider的类，该类继承于AppWidgetProvider，以后所有的AppWidget上面的控件事件都会在这个类中处理。看一下类的内容：

public class ExampleAppWidgetProvider extends AppWidgetProvider {
//到达指定更新时间或者当用户向桌面添加AppWidget时被调用
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
System.out.println("onUpdate");
super.onUpdate(context, appWidgetManager, appWidgetIds);
}
//删除一个AppWidget时调用
@Override
public void onDeleted(Context context, int[] appWidgetIds) {
System.out.println("onDeleted");
super.onDeleted(context, appWidgetIds);
}
//最后一个AppWidget被删除时调用
@Override
public void onDisabled(Context context) {
System.out.println("onDisabled");
super.onDisabled(context);
}
//Appwidget实例第一次被创建时调用
@Override
public void onEnabled(Context context) {
System.out.println("onEnabled");
super.onEnabled(context);
}
//接收广播事件
@Override
public void onReceive(Context context, Intent intent) {
// TODO Auto-generated method stub
super.onReceive(context, intent);
}
}

在AndroidManifest.xml中定义一些创建AppWidget必要的东西，先看代码：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="sjllef.appwidget01"
android:versionCode="1"
android:versionName="1.0" >

<uses-sdk android:minSdkVersion="8" />

<application
android:icon="@drawable/ic_launcher"
android:label="@string/app_name" >
<activity
android:label="@string/app_name"
android:name=".MainActivity" >
<intent-filter >
<action android:name="android.intent.action.MAIN" />

<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<receiver android:name="ExampleAppWidgetProvider">
<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>
</application>

</manifest>

添加第一个AppWidget被调用的方法



添加第二个AppWidget被调用的方法



从上图可以发现第二次添加时onEnable方法不在调用，仅在第一次调用时创建。

添加第三个的时候



删除一个AppWidget时调用的方法



删除最后一个调用的方法



现在我们把onReceiver方法加上在运行一次看看效果：

添加第一个AppWidget调用的方法



添加第二个AppWidget时调用的方法



删除操作

删除一个AppWidget调用的方法



删除最后一个AppWidget调用的方法



最后来拿创建第一个和删除最后一个做一个对比





自己体会一下吧，想想其中的道理……