android入門之App Widget(二)

本章節將涉及到兩個類，PendingIntent和RemoteViews。

PendingIntent：

PendingIntent類是封裝了Intent，表示將一個封裝了的Intent從一個對象傳給另外一個對象，當另一個對象收到某個事件之後，觸發Intent執行。假如這個另一個對象收到PendingIntent而沒有對對應的時間去觸發它，它將不會執行。（好比：甲寫了一條妙計給乙，叫乙遇到困難的時候拿出來用，當乙真遇到了困難的時候，這條妙計可派上用場，當乙不會遇到困難的時候，這條妙計將不會派上用場，PendingIntent就相當於這條妙計）。

建立PendingIntent的三種方法：

1、public static PendingIntent getActivity(Context context, int requestCode,
            Intent intent, int flags)

2、public static PendingIntent getBroadcast(Context context, int requestCode,
            Intent intent, int flags)

3、public static PendingIntent getService(Context context, int requestCode,
            Intent intent, int flags)

 

RemoteViews：
1、RemoteViews對象表示了一系列的view對象

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

接著上一個例子，為App Widget中添加button，在example_appwidget.xml檔案裡面添加：

<Button
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="測試按鈕"
    android:id="@+id/button"
/>

為Button綁定處理器：
注意：由於App Widget和我們的應用程式運行在不同的進程當中（App Widget當中的View運行在HomeScreen進程當中），所以無法按照之前慣用的方法綁定監聽器。
RemoteViews.setOnClickPendingIntent(int viewId, PendingIntent pendingIntent)

例子：在android入門之App Widget(二) 為App widget添加一個Button，實現功能，當點擊Button時，將跳轉到另外一個Activity裡面去。

在res/layout中添加三個xml檔案：

分別為：

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="fill_parent"
    android:layout_height="fill_parent"
    >
<TextView 
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:text="firstWidgetText"
    android:id="@+id/widgetTextld"
    android:background="#0000FF"
    />
<Button
 android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="測試按鈕"
    android:id="@+id/button"
/>
</LinearLayout>

 

othermain.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
<TextView 
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:text="@string/other"
    />
</LinearLayout>

main.xml：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
<TextView 
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:text="@string/hello"
    />
</LinearLayout>

在res/xml目錄下添加example_appwidget_info.xml

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
 android:minWidth="294dp"
 android:minHeight="72dp"
 android:updatePeriodMillis="86400000"
 android:initialLayout="@layout/example_appwidget"
>
</appwidget-provider>

在androidManifest.xml檔案application節點之間添加如下代碼：

<activity android:name=".OtherActivity"/><!-- 註冊 OtherActivity-->

<receiver android:name=".AppWidgetProviderTest">
   <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"></meta-data>
  </receiver>

 

設定檔就配置到這裡就可以了。下面是java代碼：

建立一個AppWidgetProviderTest類繼承AppWidgetProvider類，內容如下：

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 AppWidgetProviderTest extends AppWidgetProvider {

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

 // 當App widget被刪除時，會調用該方法
 @Override
 public void onDeleted(Context context, int[] appWidgetIds) {
  System.out.println("onDeleted");
  super.onDeleted(context, appWidgetIds);
 }

 // 當一個App widget得執行個體第一次被建立時，會調用該方法
 @Override
 public void onEnabled(Context context) {
  System.out.println("onEnabled");
  super.onEnabled(context);
 }

 // 當最後一個App widget執行個體被刪除後，會調用該方法
 @Override
 public void onDisabled(Context context) {
  System.out.println("onDisabled");
  super.onDisabled(context);
 }

 // 在到達指定的更新時間之後或者當使用者案頭添加App widget時會調用該方法
 @Override
 public void onUpdate(Context context, AppWidgetManager appWidgetManager,
   int[] appWidgetIds) {
  System.out.println("onUpdate");

  for (int i = 0; i < appWidgetIds.length; i++) {
   System.out.println(appWidgetIds[i]);
   // 建立一個Intent對象
   Intent intent = new Intent(context, OtherActivity.class);
   // 建立一個PendingIntent
   PendingIntent pendingIntent = PendingIntent.getActivity(context, 0,
     intent, 0);
   RemoteViews remoteViews = new RemoteViews(context.getPackageName(),
     R.layout.example_appwidget);
   // 為按鈕綁定時間處理器
   remoteViews.setOnClickPendingIntent(R.id.button, pendingIntent);
   appWidgetManager.updateAppWidget(appWidgetIds[i], remoteViews);
  }
  super.onUpdate(context, appWidgetManager, appWidgetIds);
 }
}

 

再建立一個Activity類，名字為：OtherActivity.java，這個activity什麼都不做，

import android.app.Activity;
import android.os.Bundle;

public class OtherActivity extends Activity {
 
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.othermain);
    }
}

到這裡，系統就可以運行了，建立了一個App Widget。