关于Android Widget实例学习教程

关于Android Widget实例学习教程

关于Android Widget实例学习教程是本文要介绍的内容，主要是来了解并学习Android Widget实例的应用，具体内容的实现来看本文详解。应用程序窗口小部件（Widget）是微小的应用程序视图，可以被嵌入到其它应用程序中（比如桌面）并接收周期性的更新。

为了创建一个Widget，需要AppWidgetProviderInfo与AppWidgetProvider。AppWidgetProviderInfo主要为Widget描述metadata，如Widget的布局，更新频率和AppWidgetProvider类，这在xml里面定义。AppWidgetProvider定义基本的方法允许你基于广播事件与Widget进行交互。通过它，当Widget更新，可用，不可用或者删除的时候，你将收到广播。

下面的截屏显示本实例的效果图：

此Widget很简单，就是以闹铃面板为背景，在上面显示字符串。

由于涉及的文件比较多，先看一下文件存放目录图：

注：在res/drawable-ldpi/加入背景资源图片。可以看到res下面有三个文件夹：drawable-hdpi, drawable-ldpi, drawable-mdpi.三个文件夹分别对应不同的屏幕分辨率。

drawable-hdpi里面存放高分辨率的图片，如：WVGA (480x800)，FWVGA (480x854)

drawable-mdpi里面存放中等分辨率的图片，如HVGA (320x480)

drawable-ldpi里面存放低分辨率的图片，如QVGA (240x320)

为了使我们的程序满足不同分辨率的机型，Android在res下面分别建立不同文件夹，我们可以把不同分辨率机型的图片放在不同目录下面。

源代码如下：

首先，申明AppWidgetProvider类在应用的AndroidManifest.xml文件里 ：

   
   
AndroidManifest.xml:   
 
<?xml version="1.0" encoding="utf-8"?>    
<manifest xmlns:android="http://schemas.android.com/apk/res/android"    
      package="com.android.test"    
      android:versionCode="1"    
      android:versionName="1.0">    
    <application android:icon="@drawable/clockgoog_dial" android:label="@string/app_name">    
        <receiver android:name=".TestWidget"    
                  android:label="@string/app_name">    
            <intent-filter>    
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />    
            </intent-filter>    
            <meta-data android:name="android.appwidget.provider"    
                       android:resource="@xml/widget_provider"    
            />    
        </receiver>    
    </application>    
    <uses-sdk android:minSdkVersion="7" />    
</manifest>     
<?xml version="1.0" encoding="utf-8"?> 
<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
      package="com.android.test" 
      android:versionCode="1" 
      android:versionName="1.0"> 
    <application android:icon="@drawable/clockgoog_dial" android:label="@string/app_name"> 
        <receiver android:name=".TestWidget" 
                  android:label="@string/app_name"> 
            <intent-filter> 
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" /> 
            </intent-filter> 
            <meta-data android:name="android.appwidget.provider" 
                 android:resource="@xml/widget_provider" 
            /> 
        </receiver> 
    </application> 
    <uses-sdk android:minSdkVersion="7" /> 
</manifest>   

注：<receiver>元素需要andriod:name属性，它指明被Widget使用的AppWidgetProvider.

<intent-filter>元素必须包含带有android:name属性的<action>元素。这一属性指明AppWigetProvider可接收ACTION_APPWIDGET_UPDATE广播。这是你必须明确声明的唯一广播。AppWidgetManager自动发送Widget广播到AppWidgetProvider。

<meta-data>元素指明AppWidgetProviderInfo资源，需要如下属性：

android:name-指明元数据名称。使用android.appwidget.provider把数据指定为对AppWidgetProviderInfo的描述。
android:resource-指明AppWidgetProviderInfo资源的位置。
其次，增加AppWidgetProviderInfor元数据在res/xml/widget_provider.xml中:

   
   
res/xml/widget_provider.xml:   
 
<?xml version="1.0" encoding="utf-8"?>    
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"    
    android:minWidth="50dip"    
    android:minHeight="50dip"    
    android:updatePeriodMillis="10000"    
    android:initialLayout="@layout/main"/>     
<?xml version="1.0" encoding="utf-8"?> 
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android" 
 android:minWidth="50dip" 
 android:minHeight="50dip" 
 android:updatePeriodMillis="10000" 
 android:initialLayout="@layout/main"/>   

注：AppWidgetProviderInfo定义基本的Widget属性，如最小布局维数，初始的布局资源，更新Widget频率和在创建时间启动Activity的配置。在XML资源里使用单一的<appwidget-provider>元素定义AppWidgetProviderInfo对象并且把它保存在工程的res/xml/文件夹下。

然后，创建Widget布局文件在res/layout/main.xml中：

   
   
res/layout/main.xml:   
 
<?xml version="1.0" encoding="utf-8"?>    
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"    
    android:orientation="vertical"    
    android:layout_width="fill_parent"    
    android:layout_height="fill_parent"    
    android:background="@drawable/clockgoog_dial">    
        
    <TextView      
        android:id="@+id/textview"    
        android:layout_width="fill_parent"     
        android:layout_height="wrap_content"     
        android:text="@string/hello"    
        android:textSize="10px"    
        android:textColor="#ff0000"/>    
</LinearLayout>    
<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
    android:orientation="vertical" 
    android:layout_width="fill_parent" 
    android:layout_height="fill_parent" 
    android:background="@drawable/clockgoog_dial"> 
      
 <TextView    
  android:id="@+id/textview" 
     android:layout_width="fill_parent"   
     android:layout_height="wrap_content"   
     android:text="@string/hello" 
   android:textSize="10px" 
     android:textColor="#ff0000"/> 
</LinearLayout> 

注：你必须在XML里为你的Widget定义一个初始的布局文件，然后保存在工程的res/layout/目录下。如果你熟悉在XML中声明布局，那么创建Widget布局是简单的。你可以使用View对象设计你的Widget，然而你必须注意Widget基于RemoteViews，它并不支持布局或者view控件中的每一种。

最后，使用AppWidgetProvider类在TestWidget.java中：

   
   
package com.android.test;    
import android.appwidget.AppWidgetManager;    
import android.appwidget.AppWidgetProvider;    
import android.content.Context;    
public class TestWidget extends AppWidgetProvider {    
    /** Called when the activity is first created. */    
    @Override    
    public void onUpdate(Context context, AppWidgetManager appWidgetManager,    
            int[] appWidgetIds) {    
        super.onUpdate(context, appWidgetManager, appWidgetIds);    
    }    
}    
package com.android.test;  
import android.appwidget.AppWidgetManager;  
import android.appwidget.AppWidgetProvider;  
import android.content.Context;  
public class TestWidget extends AppWidgetProvider {  
    /** Called when the activity is first created. */  
 @Override  
 public void onUpdate(Context context, AppWidgetManager appWidgetManager,  
   int[] appWidgetIds) {  
  super.onUpdate(context, appWidgetManager, appWidgetIds);  
 }  
}  

注：继承于BroadcastReceiver的AppWidgetProvider类是一种很方便处理Widget广播的类。AppWidgetProvider只接收与Widget相关的事件广播，如当Widget更新，删除，可用和不可用的时候。当这些广播事件发生的时候，AppWidgetProvider收到如下的方法调用：onUpdated,onDeleted,onEnabled,onDisabled,onReceive。

最重要的AppWidgetProvider回调函数是onUpdated，因为当每一个Widget增加的时候它都会被调用（除非你使用配置Activity）。如果你的Widget接收任意用户交互事件，那么你需要在回调函数中注册事件handler。如果你的Widget没有创建临时文件或者数据库，或者执行需要clean－up的工作，那么onUpdated可能是你需要注册的唯一回调函数。

小结：关于Android Widget实例学习教程的内容介绍完了，希望通过Android Widget实例内容的学习能对你有所帮助。

【编辑推荐】

1. Android Widget开发详解
2. 详解Android Widget组件RelativeLayout实例
3. Android Widget设计指南
4. Android Widget开发学习教程（二）
5. 详解Android Widget创建过程
6. 解析Android Widget中文API中TabWidget