Android －－－ App Widget 開發

概要： 

App Widget應用小控件，用戶能夠經過長按屏幕，而後添加小控件倒桌面，這些小控件通常都是爲了顯示一些信息在桌面上，同時方便用戶經過點擊桌面上的小控件來訪問你的程序。

基礎知識：

開發一個小控件，咱們須要：

AppWidgetProvider

繼承AppWidgetProvider類，並重載一些方法（onUpdate方法尤其重要，後面描述Why），AppWidgetProvider其實也是一個BroadcastReceiver，所以咱們也能夠象撲通的BroadcastReceiver同樣監聽廣播事件。

AppWidgetProviderInfo

在XML文件中，描述AppWidgetProvider的Metadata信息，如聲明AppWidgetProvider類，Layout，更新間隔，配置AppWidget的Activity等。。。

Layout

定義一個App Widget，咱們也須要定義它的Layout文件。在App Widget中，不是全部的Android控件都能放入App Widget的Layout中去的，現階段只有下面一些Layout和控件才能放入App Widget中。

還有在程序中要控制App Widget的控件都經過RemoteViews來控制。

Layout類：LinearLayout， FrameLayout，RelativeLayout

控件類：

AnalogClock,Button,Chronometer,ImageButton,ImageView,ProgressBar

TextView,ViewFlipper,ListView,GridView,StackView,AdapterViewFlipper

若是上述之外的控件或者Layout類被放入App Widget的Layout文件中的話，App Widget將不能在桌面顯示。

開發流程：

Step1.繼承AppWidgetProvider類,並重載下列方法（若有必要的話）

＊應爲用戶能夠在桌面添加多個相同的App Widget，所以系統調用咱們重載的方法時，不少時候都是傳給咱們一個id數組。

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

onUpdate是很是重要的一個方法。當用戶在桌面添加一個App Widget時，或者用戶定義的時鐘updatePeriodMillis響應時，此方法都會被調用。

＊可是若是用戶定義了configuration Activity時，在用戶添加小控件時，onUpdate不會被調用。

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

每個App Widget從桌面刪除時，onDeleted都會被調用。

public void onEnabled(Context context)

用戶初次添加App Widget時，onEnabled會被調用。

public void onDisabled(Context context)

當用戶刪除了全部的App Widget時，onDisabled會被調用

Step2.定義AppWidgetProviderInfo

在res文件夾下建立名爲xml的文件夾，而後添加一xml，Tag爲appwidget－provider，

屏幕通常被分爲，4x4單元，所以咱們定義的miniHeight和miniWidth不要超過4x4單元的大小，每一單元大小爲72x72dp

initialLayout用來聲明Layout文件，updatePeriodMills來定義更新App Widget的時鐘，當不須要更新時設置爲0

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

    android:initialLayout="@layout/example_app_widget_provider"

    android:minHeight="72dp"

    android:minWidth="200dp"

    android:updatePeriodMillis="60000" >

</appwidget-provider>

Step3.定義Manifest

前面已經講過，全部的AppWidgetProvider實際上都是BroadcastReceiver，所以在Manifest裏面申明時使用receiver標籤。meta-data標籤的名字固定爲"android.appwidget.provider"，resource用來聲明AppWidgetProviderInfo xml，intent-filter裏面添加「android.appwidget.action.APPWIDGET_UPDATE」，當咱們定義的時鐘android:updatePeriodMillis響應時，會廣播APPWIDGET_UPDATE，此時咱們的onUpdate會被調用。

        <receiver android:name="...ExampleAppWidgetProvider" >

            <meta-data

                android:name="android.appwidget.provider"

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

            <intent-filter>

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

            </intent-filter>

        </receiver>

源代碼：

<Java>

ExampleAppWidgetProvider.java

package com.jumper.android.demos.appwidget;

import com.jumper.android.demos.R;

import android.app.PendingIntent;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.Context;
import android.content.Intent;
import android.util.Log;
import android.widget.RemoteViews;


public class ExampleAppWidgetProvider extends AppWidgetProvider {


private final static String lOG_TAG = ExampleAppWidgetProvider.class.getName();
public final static String SUBMIT_ACTION = "com.jumper.android.demos.appwidget.SUBMIT";
@Override
public void onDeleted(Context context, int[] appWidgetIds) {
super.onDeleted(context, appWidgetIds);
}


@Override
public void onDisabled(Context context) {
super.onDisabled(context);
}


@Override
public void onEnabled(Context context) {
super.onEnabled(context);
}


@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
super.onUpdate(context, appWidgetManager, appWidgetIds);
Log.v(lOG_TAG, "onUpdate=" + appWidgetIds.length);
int length = appWidgetIds.length;
for(int i=0; i<length; i++) {
updateWidget(context, appWidgetManager, appWidgetIds[i]);
}
}

private void updateWidget(Context context, AppWidgetManager appwidgetmanager, int appwidgetid) {
Log.v(lOG_TAG, "updateWidget ID=" + appwidgetid);
Intent intent = new Intent();
intent.setAction(SUBMIT_ACTION);
intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appwidgetid);

PendingIntent pendingintent = PendingIntent.getBroadcast(context, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT);
RemoteViews removteviews = new RemoteViews(context.getPackageName(), R.layout.example_app_widget_provider);
removteviews.setOnClickPendingIntent(R.id.app_widget_submit, pendingintent);

appwidgetmanager.updateAppWidget(appwidgetid, removteviews);
}


}

ExampleAppWidgetReceiver.java

package com.jumper.android.demos.appwidget;

import com.jumper.android.demos.R;

import android.app.PendingIntent;
import android.appwidget.AppWidgetManager;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.util.Log;
import android.widget.RemoteViews;


public class ExampleAppWidgetReceiver extends BroadcastReceiver {
private final String lOG_TAG = this.getClass().getName();
@Override
public void onReceive(Context context, Intent intent) {
String action = intent.getAction();
Log.v(lOG_TAG, "onReceive=" + action);
if(action.equals(ExampleAppWidgetProvider.SUBMIT_ACTION)) {
int appwidgetid = intent.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, 0);
Log.v(lOG_TAG, "ID=" + appwidgetid);
updateWidget(context, AppWidgetManager.getInstance(context), appwidgetid);

}
}
private void updateWidget(Context context, AppWidgetManager appwidgetmanager, int appwidgetid) {
Log.v(lOG_TAG, "updateWidget ID=" + appwidgetid);
RemoteViews removteviews = new RemoteViews(context.getPackageName(), R.layout.example_app_widget_provider);
removteviews.setTextViewText(R.id.app_widget_output, "WidgetID:" + appwidgetid + " " + System.currentTimeMillis());
appwidgetmanager.updateAppWidget(appwidgetid, removteviews);
}
}

<AppWidgetProviderInfo>Xml

app_widget_provider_info.xml

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

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

    android:initialLayout="@layout/example_app_widget_provider"

    android:minHeight="72dp"

    android:minWidth="286dp"

    android:updatePeriodMillis="60000" >

</appwidget-provider>

<Layout>

example_app_widget_provider.xml

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

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

    android:layout_width="160dp"

    android:layout_height="80dp"

    android:orientation="vertical" >

    <LinearLayout

        android:layout_width="match_parent"

        android:layout_height="wrap_content"

        android:gravity="center"

        >

    <TextView

        android:id="@+id/app_widget_output"

        android:layout_width="wrap_content"

        android:layout_height="wrap_content"

        android:layout_marginLeft="10.0dip"

        android:text="Medium Text"

        android:textAppearance="?android:attr/textAppearanceMedium" />

        <ImageView

            android:id="@+id/app_widget_submit"

            android:layout_width="wrap_content"

            android:layout_height="wrap_content"

            android:layout_marginLeft="5.0dip"

            android:src="@drawable/ic_menu_market_search" />

    </LinearLayout>

</LinearLayout>

<Manifest>

        <receiver android:name="com.jumper.android.demos.appwidget.ExampleAppWidgetProvider" >

            <meta-data

                android:name="android.appwidget.provider"

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

            <intent-filter>

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

            </intent-filter>

        </receiver>

        <receiver android:name="com.jumper.android.demos.appwidget.ExampleAppWidgetReceiver" >

            <intent-filter>

                <action android:name="com.jumper.android.demos.appwidget.SUBMIT" />

                <action android:name="android.intent.ACTION_TIMEZONE_CHANGED" />

                <action android:name="android.intent.ACTION_TIME" />

            </intent-filter>

        </receiver>