關(guān)于Android Widget實(shí)例學(xué)習(xí)教程是本文要介紹的內(nèi)容，主要是來了解并學(xué)習(xí)Android Widget實(shí)例的應(yīng)用，具體內(nèi)容的實(shí)現(xiàn)來看本文詳解。應(yīng)用程序窗口小部件（Widget）是微小的應(yīng)用程序視圖，可以被嵌入到其它應(yīng)用程序中（比如桌面）并接收周期性的更新。

為了創(chuàng)建一個(gè)Widget，需要AppWidgetProviderInfo與AppWidgetProvider。AppWidgetProviderInfo主要為Widget描述metadata，如Widget的布局，更新頻率和AppWidgetProvider類，這在xml里面定義。AppWidgetProvider定義基本的方法允許你基于廣播事件與Widget進(jìn)行交互。通過它，當(dāng)Widget更新，可用，不可用或者刪除的時(shí)候，你將收到廣播。

下面的截屏顯示本實(shí)例的效果圖：

此Widget很簡(jiǎn)單，就是以鬧鈴面板為背景，在上面顯示字符串。

由于涉及的文件比較多，先看一下文件存放目錄圖：

注：在res/drawable-ldpi/加入背景資源圖片?？梢钥吹絩es下面有三個(gè)文件夾：drawable-hdpi, drawable-ldpi, drawable-mdpi.三個(gè)文件夾分別對(duì)應(yīng)不同的屏幕分辨率。

drawable-hdpi里面存放高分辨率的圖片，如：WVGA (480x800)，F(xiàn)WVGA (480x854)

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

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

為了使我們的程序滿足不同分辨率的機(jī)型，Android在res下面分別建立不同文件夾，我們可以把不同分辨率機(jī)型的圖片放在不同目錄下面。

源代碼如下：

首先，申明AppWidgetProvider類在應(yīng)用的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自動(dòng)發(fā)送Widget廣播到AppWidgetProvider。

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

android:name-指明元數(shù)據(jù)名稱。使用android.appwidget.provider把數(shù)據(jù)指定為對(duì)AppWidgetProviderInfo的描述。
android:resource-指明AppWidgetProviderInfo資源的位置。
其次，增加AppWidgetProviderInfor元數(shù)據(jù)在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屬性，如最小布局維數(shù)，初始的布局資源，更新Widget頻率和在創(chuàng)建時(shí)間啟動(dòng)Activity的配置。在XML資源里使用單一的<appwidget-provider>元素定義AppWidgetProviderInfo對(duì)象并且把它保存在工程的res/xml/文件夾下。

然后，創(chuàng)建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定義一個(gè)初始的布局文件，然后保存在工程的res/layout/目錄下。如果你熟悉在XML中聲明布局，那么創(chuàng)建Widget布局是簡(jiǎn)單的。你可以使用View對(duì)象設(shè)計(jì)你的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相關(guān)的事件廣播，如當(dāng)Widget更新，刪除，可用和不可用的時(shí)候。當(dāng)這些廣播事件發(fā)生的時(shí)候，AppWidgetProvider收到如下的方法調(diào)用：onUpdated,onDeleted,onEnabled,onDisabled,onReceive。

最重要的AppWidgetProvider回調(diào)函數(shù)是onUpdated，因?yàn)楫?dāng)每一個(gè)Widget增加的時(shí)候它都會(huì)被調(diào)用（除非你使用配置Activity）。如果你的Widget接收任意用戶交互事件，那么你需要在回調(diào)函數(shù)中注冊(cè)事件handler。如果你的Widget沒有創(chuàng)建臨時(shí)文件或者數(shù)據(jù)庫，或者執(zhí)行需要clean－up的工作，那么onUpdated可能是你需要注冊(cè)的唯一回調(diào)函數(shù)。

小結(jié)：關(guān)于Android Widget實(shí)例學(xué)習(xí)教程的內(nèi)容介紹完了，希望通過Android Widget實(shí)例內(nèi)容的學(xué)習(xí)能對(duì)你有所幫助。