Android開發(fā)入門之Appwidget用法分析

更新時間：2016年07月08日 12:30:19 作者：manymore13

這篇文章主要介紹了Android開發(fā)入門之Appwidget用法,較為詳細的分析了App Widget的概念、功能、創(chuàng)建、使用方法與相關(guān)注意事項,需要的朋友可以參考下

本文實例講述了Android Appwidget用法。分享給大家供大家參考，具體如下：

App Widgets 是一個小型應(yīng)用程序的View 他可以嵌入到其他應(yīng)用程序中(如桌面程序) 并且可以得到周期性刷新。

在創(chuàng)建App Widget之前需要了解以下幾個概念

AppWidgetProviderInfo對象

它是對App Widget 元數(shù)據(jù)的一個描述，譬如 AppWidget的布局，刷新頻率，以及 AppWidgetProvider 類這些元數(shù)據(jù)都是定義在XML中。

AppWidgetProvider 類的實現(xiàn)

對于App Widget定義了(回調(diào)接口)一些基本的方法，這些方法都是基于廣播事件(broadcast events ),，通過它，當App Widget更新，創(chuàng)建，無效，卸載時，你可以接收廣播。

View layout

為App Widget定義初始布局，用XML來布局

另外，你可以為App Widget 實現(xiàn)一個配置的Activity，這是一個可選擇的Activity，在用戶添加你的App Widget 準備創(chuàng)建時允許他修改或者配置App Widget 。

下面我們就開始創(chuàng)建一個App Widget

① 在Manifest聲明App Widget

首先，在AndroidManifest.xml中聲明 AppWidgetProvider

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

<receiver>元素需要Android:name 屬性，AppWidgetProvider作為引用
<intent-filter> 元素務(wù)必要包含 <action>元素然后Action中要有android:name 屬性，這個屬性需要指定能接收 ACTION_APPWIDGET_UPDATE 廣播的AppWidgetProvider，也就是ExampleAppWidgetProvider 這個廣播必須唯一必須明確聲明，因為AppWidgetManager會自動的發(fā)送所有其他應(yīng)用程序的廣播給AppWidgetProvider，所以很重要。

②添加AppWidgetProviderInfo元數(shù)據(jù)

AppWidgetProviderInfo為AppWidgeet定義了一些最基本的數(shù)據(jù)，譬如布局的最小尺寸，初始化布局資源，怎樣更新App Widget，以及在創(chuàng)建app Widget時的可配置Activity(可選)

要定義一個AppWidgetProviderInfo對象可以用XML資源文件定義，保存在res/xml/自己的文件名，XML文件中用一個單一的元素<appwidget-provider> 請看下面的例子：

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
  android:minWidth="294dp"
  android:minHeight="72dp"
  android:updatePeriodMillis="86400000"
  android:previewImage="@drawable/preview"
  android:initialLayout="@layout/example_appwidget"
  android:configure="com.example.android.ExampleAppWidgetConfigure"
  android:resizeMode="horizontal|vertical">
</appwidget-provider>

initialLayout：指定App Widget布局資源文件
Configure：在創(chuàng)建App Widget時為他配置屬性的activity
updatePeriodMillis: appwidget更新頻率

③ 創(chuàng)建App Widget 布局

你必須為你的App Widget定義個初始化布局文件，可以將布局文件放在 res/layout/directory。你可以設(shè)計你的App Widget用下面列出來
的View對象，但是在你設(shè)計開始之前，請你熟讀App Widget Design Guidelines.

如果你熟悉XML Layouts ,那么創(chuàng)建一個App Widget將會是簡單的，然而，你必須意識到App Widget布局是基于 RemoteViews ，它并不是支持每一種layout和View widget。

一個RemoteView對象只能支持下面幾種layout布局類：
FrameLayout LinearLayout RelativeLayout

支持下面幾種widget 類：
AnalogClock Button Chronometer ImageButton ImageView ProgressBar TextView ViewFlipper ListView GridView
StackView AdapterViewFlipper

PS：這些類的繼承類也是不被支持的。

下面是我本次寫的demo中的Appwidget

功能很簡單只為初步理解AppWidget ，響應(yīng)Appwidget上按鈕事件

package com.manymorere.appwidget;
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 ExampleAppWidgetProvider extends AppWidgetProvider{
  private static final String ACTION = "com.manymore.appwidget";
  private int id;
  @Override
  public void onDeleted(Context context, int[] appWidgetIds) {
    System.out.println("onDeleted");
    super.onDeleted(context, appWidgetIds);
  }
  @Override
  public void onDisabled(Context context) {
    // TODO Auto-generated method stub
    System.out.println("onDisabled");
    super.onDisabled(context);
  }
  @Override
  public void onEnabled(Context context) {
    // TODO Auto-generated method stub
    System.out.println("onEnabled");
    super.onEnabled(context);
  }
  @Override
  public void onReceive(Context context, Intent intent) {
    System.out.println("onReceive");
    // 自己定義的ACTION
    if(intent.getAction().equals(ACTION))
    {
      RemoteViews remoteView = new RemoteViews(context.getPackageName(),R.layout.appwidget_layout);
      remoteView.setCharSequence(R.id.button, "setText", "22222222222222");
      AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
      ComponentName componentName = new ComponentName(context, ExampleAppWidgetProvider.class);
      appWidgetManager.updateAppWidget(componentName , remoteView);
      System.out.println("收到自定義ACTION");
    }else{
      super.onReceive(context, intent);
    }
  }
  @Override
  public void onUpdate(Context context, AppWidgetManager appWidgetManager,
      int[] appWidgetIds) {
    int N = appWidgetIds.length;
    for(int i = 0; i<N; i++)
    {
      int appWidgetId = appWidgetIds[i];
      Intent intent = new Intent(ACTION);
      PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);
      RemoteViews remoteViews = new RemoteViews(context.getPackageName(),R.layout.appwidget_layout);
      remoteViews.setOnClickPendingIntent(R.id.button, pendingIntent);
      appWidgetManager.updateAppWidget(appWidgetId, remoteViews);
      System.out.println(appWidgetId);
    }
    super.onUpdate(context, appWidgetManager, appWidgetIds);
  }
}

每次添加Appwidget實例都會調(diào)用onUpdate()方法然后會注冊里面的Button Onclick事件，當你點擊該按鈕時會發(fā)送一個broadcast，這個broadcast是自己定義的，然后onReceive方法會收到該broadcast，然后再做出一些反應(yīng)，我這里是把修改了TextView上的text。

由于Appwidget和本身的應(yīng)用，雖然是在一個程序中，但運行時，它們并不是在一個進程中，所以在在調(diào)用方法和修改界面上多少會有點限制，沒有普通的(Activity上對View的一些操作)那么自由，所以想對Appwidget上的View做一些操作，或者更新Appwidget，一般需要用到RemoteViews，AppWidgetManager 同時可能還會用到ComponentName

個人理解：RemoteViews在創(chuàng)建時主要代表一個Appwidget實例中View的一個集合，而ComponentName則代表一個整個Appwidget實例

完整實例代碼點擊此處本站下載。