手把手教你做android widget

手把手教你做android widget

最近要在項目中把Barcode scanner（條碼掃描）做成一個widget（小組件）放到手機案頭。網上查了一些資料，調查了一下，把方法和大家分享。

先講一下什麼是widget。widget就是案頭小組件。　Android本身已經內建了時鐘、音樂播放器、相框和Google搜尋4個
Widget程式，不過這並不能阻止大家開發自己更加美觀，功能更豐富的版本。另外，微部落格、RSS訂閱、股市資訊、天氣預報這些Widget也都有流行
的可能。

那怎麼把widget添加至案頭呢？

長按手機案頭，彈出dialog，選擇widget即進入手機的widget列表。列表中顯示手機中可使用的所有widget，包括我們自己製作的（做完這個例子後，你會發現我們自己製作的widget夜出現在這裡），選中則該widget將出現在案頭。

下面介紹一下widget的製作步驟：

1.申明AppWidgetProvider類在應用的AndroidManifest.xml檔案裡
<receiver android:name="com.Demo_barcodeWidget.BarcodeWidgetProvider"

            android:icon="@drawable/homenav_barcode"

            android:label="Yellowbook Barcode Scanner">

            <intent-filter>

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

            </intent-filter>

            <meta-data android:name="android.appwidget.provider" android:resource="@xml/barcode_widget" />

        </receiver>

• <intent-filter>元素必須包含帶有android:name屬性的<action>元素。這一屬性指明
  AppWigetProvider可接收ACTION_APPWIDGET_UPDATE廣播。這是你必須明確聲明的唯一廣播。
  AppWidgetManager自動發送Widget廣播到AppWidgetProvider。

•  
     <meta-data>元素指明AppWidgetProviderInfo資源，需要如下屬性：android:name-指明元數
  據名稱。使用android.appwidget.provider把資料指定為對AppWidgetProviderInfo的描述。

      android:resource-指明AppWidgetProviderInfo資源的位置。

2.
增加AppWidgetProviderInfor中繼資料在res/xml/widget_provider.xml中:

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"

    android:minWidth="47dip"

    android:minHeight="44dip"

    android:updatePeriodMillis="10000"

    >

</appwidget-provider>

• 這個檔案放在res/xml/檔案夾下，若res中沒有xml檔案夾，則需建立一個。

• 註：AppWidgetProviderInfo
  定義基本的Widget屬性，如最小布局維數，初始的布局資源，更新Widget頻率和在建立時間啟動Activity的配置。在XML資源裡使用單一
  的<appwidget-provider>元素定義AppWidgetProviderInfo對象並且把它儲存在工程的res/xml
  /檔案夾下。

3.
建立Widget布局檔案在res/layout/中：

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

    android:src="@drawable/homenav_barcode" android:id="@+id/barcode_widget_logo"

    android:layout_height="wrap_content" android:layout_width="wrap_content"></ImageView>

• 這是widget在案頭顯示的layout。本例中很簡單，只有一個imageview。
  
• 你
  必須在XML裡為你的Widget定義一個初始的布局檔案，然後儲存在工程的res/layout/目錄下。如果你熟悉在XML中聲明布局，那麼建立
  Widget布局是簡單的。你可以使用View對象設計你的Widget，然而你必須注意Widget基於RemoteViews，它並不支援布局或者
  view控制項中的每一種。

4.建立appWidgetProvider類

package com.Demo_barcodeWidget;

import android.app.PendingIntent;

import android.appwidget.AppWidgetManager;

import android.appwidget.AppWidgetProvider;

import android.content.ComponentName;

import android.content.Context;

import android.content.Intent;

import android.widget.RemoteViews;

public class BarcodeWidgetProvider extends AppWidgetProvider{

    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds){

        RemoteViews mRemoteViews = buildUpdate(context);

        ComponentName thisWidget = new ComponentName(context, BarcodeWidgetProvider.class);

        AppWidgetManager manager = AppWidgetManager.getInstance(context);

        manager.updateAppWidget(thisWidget, mRemoteViews);

    }

    private RemoteViews buildUpdate(Context context) {

        RemoteViews rv = new RemoteViews(context.getPackageName(), R.layout.barcode_scanner_widget);

        Intent i = new Intent(context, Demo_barcodeWidget.class);

        i.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);

        rv.setOnClickPendingIntent(R.id.barcode_widget_logo, PendingIntent.getActivity(context, 0, i, 0));

        return rv;

    }

}

• 繼承於BroadcastReceiver的AppWidgetProvider類是一種很方便處理Widget廣播的類。
  AppWidgetProvider只接收與Widget相關的事件廣播，如當Widget更新，刪除，可用和停用時候。當這些廣播事件發生的時
  候，AppWidgetProvider收到如下的方法調
  用：onUpdated,onDeleted,onEnabled,onDisabled,onReceive。

• 最
  重要的AppWidgetProvider回呼函數是onUpdated，因為當每一個Widget增加的時候它都會被調用（除非你使用配置
  Activity）。如果你的Widget接收任意使用者互動事件，那麼你需要在回呼函數中註冊事件handler。如果你的Widget沒有建立臨時檔案
  或者資料庫，或者執行需要clean－up的工作，那麼onUpdated可能是你需要註冊的唯一回呼函數。
• 這裡使用
  remoteView來實現widget的事件響應（onclick事件）和widget頁面的顯示重新整理（實際上本例很簡單，只是說明widget的製作
  步驟。並沒有顯示什麼資料，而widget得click事件也只是跳轉到程式的main
  activity）。實際上widget功能豐富：別看它們小，卻服務周到，它可以為你報告新聞、幫你買東西、列出你最喜歡的樂隊，還有你最近看的視頻。
  另外，它還是一個殷勤的管家，你不必親自去Flickr或者天氣預報網站，Widget會將資訊主動帶給你。Widget可以以多種形式呈現出來，幻燈
  秀、視頻、地圖、新聞、小遊戲……