Android開發之App Widget（二）

什麼是PendingIntent?

PendingIntent對Intent進行了包裝，當出現某種事件後再執行Intent。

RemoteViews的作用

1.RemoteViews對象表示了一系列的View對象

2.RemoteViews所表示的對象運行在另外的進程當中

在App Widget當中使用控件的步驟（注意：本文的例子在上篇博客的基礎上進行修改）

1.在example_appwidget.xml中添加要在AppWidget中顯示的控件。

2.新建TargetActivity作爲點擊AppWidget控件後要啓動的Activity。

3.在ExampleAppWidgetProvider.java中的onUpdate()方法中進行控件監聽器的設置與綁定。（由於AppWidget與應用程序不在同一個進程，AppWidget當中的View運行在Home Screen進程中，所以不能用之前慣用的方法綁定監聽器）

example_appwidget.xml:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical" android:layout_width="match_parent"
    android:layout_height="match_parent">
    <Button
        android:id="@+id/widgetButton"
        android:text="測試用按鈕"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
</LinearLayout>

activity_target.xml:（此爲TargetActivity的佈局文件，TargetActivity類爲空）

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context="com.mycompany.appwidget.TargetActivity">
    
    <TextView
        android:text="測試用Activity"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
</RelativeLayout>

ExampleAppWidgetProvider.java:

package com.mycompany.appwidget;

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

public class ExampleAppWidgetProvider extends AppWidgetProvider{

    //  在到達指定的更新時間之後或者當用戶向桌面添加App Widget時調用
    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        for (int i = 0; i < appWidgetIds.length; i++) {
            System.out.println(appWidgetIds[i]);
            //  創建一個Intent對象
            Intent intent = new Intent(context, TargetActivity.class);

            //  創建一個PendingIntent
            PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);
            RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.example_appwidget);

            //  爲按鈕綁定事件處理器
            //  第一個參數用來指定被綁定處理器的控件的ID
            //  第二個參數用來指定當時間發生時，哪個PendingIntent將會被執行
            remoteViews.setOnClickPendingIntent(R.id.widgetButton, pendingIntent);

            //  更新AppWidget
            //  第一個參數用於指定被更新的AppWidget的ID
            //  第二個參數用於要被更新的控件對象
            appWidgetManager.updateAppWidget(appWidgetIds[i], remoteViews);
        }
        super.onUpdate(context, appWidgetManager, appWidgetIds);
        System.out.println("------>onUpdate");
    }

    //  當App Widget被刪除時調用
    @Override
    public void onDeleted(Context context, int[] appWidgetIds) {
        super.onDeleted(context, appWidgetIds);
        System.out.println("------>onDeleted");
    }

    //  當第一個App Widget的實例第一次被創建時調用
    @Override
    public void onEnabled(Context context) {
        super.onEnabled(context);
        System.out.println("------>onEnabled");
    }

    //  當最後一個App Widget實例被刪除後調用
    @Override
    public void onDisabled(Context context) {
        super.onDisabled(context);
        System.out.println("------>onDisabled");
    }

    //  接收廣播事件
    @Override
    public void onReceive(Context context, Intent intent) {
        super.onReceive(context, intent);
    }
}