Android中的AppWidget入門教程

更新時間：2015年03月28日 12:39:56 投稿：junjie

這篇文章主要介紹了Android中的AppWidget入門教程,本文起講解了如何創(chuàng)建一個簡單的AppWidget、如何使得AppWidget與客戶端程序交互等內(nèi)容,需要的朋友可以參考下

什么是AppWidget？AppWidget就是我們平常在桌面上見到的那種一個個的小窗口，利用這個小窗口可以給用戶提供一些方便快捷的操作。本篇打算從以下幾個點來介紹AppWidget:

1.如何創(chuàng)建一個簡單的AppWidget
2.如何使得AppWidget與客戶端程序交互

創(chuàng)建簡單的AppWidget

在介紹之前給大家看一下程序運行的最后結(jié)果和項目結(jié)構(gòu)圖，以便大家有個整體的印象。

運行結(jié)果圖：

項目結(jié)構(gòu)圖：

第一步：

首先在res文件夾下新建一個名字為xml的文件夾，然后在xml目錄下創(chuàng)建一個名為appwidget01的xml文件（如上圖所示）。這個appwidget01中的內(nèi)容如下：

復(fù)制代碼代碼如下:

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

  >

</appwidget-provider>

這個xml是用來描述你所要創(chuàng)建的appWidget的一些描述信息的，比如高度、寬度、刷新間隔、布局文件等等。僅僅這個描述文件還不夠，我們看到的appWidget可都是有界面元素的呀，比如說文本，圖片，按鈕等等，這些東西的定義都需要放到layout文件夾下面。這個文件就是上面代碼中寫到的那個appwidgetlayout。

第二步：

在layout文件夾下面新建一個appwidgetlayout.xml文件，在這個文件中描述了appWidget的控件和布局等等信息，就和我們平常創(chuàng)建的一個activity的布局文件沒什么兩樣，因為只是簡單的演示，所以僅用一個文本和一個按鈕。xml的內(nèi)容如下：

復(fù)制代碼代碼如下:

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

    <TextView android:id="@+id/txtapp" android:text="test" android:layout_width="wrap_content" 

        android:layout_height="wrap_content" android:background="#ffffff"></TextView> 

    <Button android:id="@+id/btnSend" android:layout_width="wrap_content" 

    android:layout_height="wrap_content" android:text="Send"></Button> 

</LinearLayout>

第三步：

既然appWidget中存在按鈕等等控件，那么就肯定少不了處理這些控件事件的處理代碼啦。這些代碼被放在一個繼承于AppWidgetProvider的類中，在本例子中我新建了一個AppWidget的類，該類繼承于AppWidgetProvider，以后所有的AppWidget上面的控件事件都會在這個類中處理。看一下類的內(nèi)容：

復(fù)制代碼代碼如下:

public class AppWidget extends AppWidgetProvider

{

    private final String broadCastString = "com.qlf.appWidgetUpdate";

    /**

     * 刪除一個AppWidget時調(diào)用

     * */

    @Override

    public void onDeleted(Context context, int[] appWidgetIds)

    {

        super.onDeleted(context, appWidgetIds);

    }

    /**

     * 最后一個appWidget被刪除時調(diào)用

     * */

    @Override

    public void onDisabled(Context context)

    {

        super.onDisabled(context);

    }

    /**

     * AppWidget的實例第一次被創(chuàng)建時調(diào)用

     * */

    @Override

    public void onEnabled(Context context)

    {

        super.onEnabled(context);

    }

    /**

     * 接受廣播事件

     * */

    @Override

    public void onReceive(Context context, Intent intent)

    {

             super.onReceive(context, intent);

    }

    /**

     * 到達指定的更新時間或者當(dāng)用戶向桌面添加AppWidget時被調(diào)用

     * */

    @Override

    public void onUpdate(Context context, AppWidgetManager appWidgetManager,

            int[] appWidgetIds)

    {

    }

}

各個方法的作用大家一看上面的注釋就明白了。我們暫時不需要實現(xiàn)里面的方法。

第四步：

在AndroidManifest.xml中定義一些創(chuàng)建AppWidget必要的東西，先看代碼：

復(fù)制代碼代碼如下:

<?xml version="1.0" encoding="utf-8"?>

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

    package="com.qlf.widget" android:versionCode="1" android:versionName="1.0">

    <application android:icon="@drawable/icon" android:label="@string/app_name">

        <activity android:name=".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="AppWidget">

            <intent-filter>

                <action android:name="android.appwidget.action.APPWIDGET_UPDATE"></action>

            </intent-filter>

            <meta-data android:name="android.appwidget.provider"

                android:resource="@xml/appwidget01" />

        </receiver>

    </application>

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

</manifest>

可以看到我們在配置文件里面定義了一個receiver，他的名字是上面創(chuàng)建處理控件代碼的那個類，下面那個intent-filter中的action是系統(tǒng)自帶的用于更新所有appwidget的廣播動作。然后meta-data標(biāo)簽是一個描述我們創(chuàng)建appwidget的元數(shù)據(jù)，那個android:name="android.appwidget.provider"是固定的，android:resource="@xml/appwidget01"指定創(chuàng)建的appWidget的描述信息的位置。這樣程序就知道到哪里去初始化這些appWidget啦。

經(jīng)過上面四個步驟，我想您已經(jīng)能夠成功在桌面上添加小工具了，效果就是我們最前面發(fā)出的樣子。

AppWidget與程序交互

前面我們只是簡單的介紹了如何創(chuàng)建一個appWidget，但是目前這個appWidget還沒有任何的交互功能。下面我們介紹一下appWidget如何與程序進行交互。首先要介紹一個對象，這個對象在appwidget和程序的交互中很重要，他就是RemoteViews。因為appwidget運行的進程和我們創(chuàng)建的應(yīng)用不在一個進程中，所以我們也就不能像平常引用控件那樣來獲得控件的實例。這個時候RemoteViews出場了，從字面上看他的意思是遠程的視圖，也就是說通過這個東西我們能夠獲得不在同一進程中的對象，這也就為我們編寫appwidget的處理事件提供了幫助。我們使用一下代碼來創(chuàng)建一個RemoteViews :

復(fù)制代碼代碼如下:

RemoteViews remoteViews  = new RemoteViews(context.getPackageName(),R.layout.appwidgetlayout);

remoteViews.setOnClickPendingIntent(R.id.btnSend, pendingIntent);  //為小工具上的按鈕綁定事件

可以看到上面又出現(xiàn)了一個陌生的對象pendingIntent，這個又是用來干嘛的呢？我們知道在一般的程序中綁定按鈕的點擊事件是直接在實現(xiàn)了OnClickListener接口的類中中完成的。不過因為appwidget并不在我們應(yīng)用的進程中，所以當(dāng)然他也訪問不到我們在應(yīng)用中設(shè)置的onclick代碼啦。而PendingIntent就是被用來解決這個問題的。PendingIntent可以看成是一個特殊的Intent，如果我們把Intent看成一封信，那么PendingIntent就是一封被信封包裹起來的信。這封信在remoteViews.setOnClickPendingIntent()中被“郵寄”到了appwidget，當(dāng)appwidget中的按鈕單擊時他知道將這封信打開，并執(zhí)行里面的內(nèi)容。這樣就避免了直接從appwidget中執(zhí)行本地代碼。我們來看看PendingIntent是如何定義的：

復(fù)制代碼代碼如下:

//創(chuàng)建一個Intent對象

Intent intent = new Intent();

intent.setAction(broadCastString);

//這一步相當(dāng)于寫信，說明這個信的作用到底是什么，在這里表示將發(fā)送一個廣播

PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);

有了上面的介紹，我們在創(chuàng)建appwidget的交互應(yīng)用時就簡單不少了。我們剩下要做的工作就是在appwidget在創(chuàng)建的時候調(diào)用上面說到的方法為appwidget中的控件綁定事件，也就是在AppWidget類下的onUpdate方法中完成這個過程。

復(fù)制代碼代碼如下:

/**

* 到達指定的更新時間或者當(dāng)用戶向桌面添加AppWidget時被調(diào)用

* */

@Override

public void onUpdate(Context context, AppWidgetManager appWidgetManager,

        int[] appWidgetIds)

{

        //創(chuàng)建一個Intent對象

        Intent intent = new Intent();

        intent.setAction(broadCastString);

        //設(shè)置pendingIntent的作用

        PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);

        RemoteViews remoteViews  = new RemoteViews(context.getPackageName(),R.layout.appwidgetlayout);

        //綁定事件

        remoteViews.setOnClickPendingIntent(R.id.btnSend, pendingIntent);

        //更新Appwidget

        appWidgetManager.updateAppWidget(appWidgetIds, remoteViews);

}

通過上面的代碼我們就為button按鈕綁定了一個事件，這個事件的作用是發(fā)送一個廣播便于其他應(yīng)用接收、更新信息。這是appwidget發(fā)送廣播，那么appwidget如何接受來自其他程序發(fā)送的廣播呢？這就是public void onReceive(Context context, Intent intent)的功能啦。這個方法會接收來自其他應(yīng)用發(fā)出的廣播，我們只要在這個程序中過濾我們需要的廣播就能響應(yīng)其他應(yīng)用的操作來更新appwidget的信息了。要注意的是，因為appwidget運行的進程和我們創(chuàng)建的應(yīng)用不在一個進程中的限制，所以更新的appwidget的時候也要通過遠程對象來操作，具體代碼如下：

復(fù)制代碼代碼如下:

/**

   * 接受廣播事件

   * */

  @Override

  public void onReceive(Context context, Intent intent)

  {

      if (intent.getAction().equals(broadCastString))

      {               

          //只能通過遠程對象來設(shè)置appwidget中的控件狀態(tài)

          RemoteViews remoteViews  = new RemoteViews(context.getPackageName(),R.layout.appwidgetlayout);

         //通過遠程對象將按鈕的文字設(shè)置為”hihi”

          remoteViews.setTextViewText(R.id.btnSend, "hihi");   

          //獲得appwidget管理實例，用于管理appwidget以便進行更新操作

          AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);

          //相當(dāng)于獲得所有本程序創(chuàng)建的appwidget

          ComponentName componentName = new ComponentName(context,AppWidget.class);

          //更新appwidget

          appWidgetManager.updateAppWidget(componentName, remoteViews);

      }

      super.onReceive(context, intent);

  }