第三章--與Widget的愛恨情仇

版權聲明:本文爲博主原創文章,未經博主允許不得轉載。 https://blog.csdn.net/w_jingjing0428/article/details/52145332

Widget就是平時所說的桌面小部件,可以很方便的在桌面上進行操作,但是本質上它是一個廣播接收器。直接看代碼。

public class TestWidget extends AppWidgetProvider{
    public static final String WIDGET_BUTTON = "widget_button";
    @Override
    //接收廣播
    public void onReceive(Context context, Intent intent) {
        super.onReceive(context, intent);
    }
    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        super.onUpdate(context, appWidgetManager, appWidgetIds);
}

點進AppWidgetProvider,可以看到它是繼承BroadcastReceiver的。onUpdate()在用戶把小部件拖到桌面,創建Widget實例時會調用。onReceive()在接收廣播的時候會被調用。所以在使用Widget的時候應該在AndroidManifest中註冊.。且由於當程序開始的時候就監聽,所以採用靜態註冊。

<receiver android:name=".TestWidget">
            <!--將該BroadcastReceiver當成桌面控件-->
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE"/>
            </intent-filter>
            <!--指定桌面控件的meta-data-->
            <meta-data android:name="android.appwidget.provider"
                android:resource="@layout/widget_setting"/>
        </receiver>
  1. action裏面表示接收系統發來的有關這個app的所有widget的消息。
  2. meta-data 指定了對應的資源文件。name 是指定metadata名,
    resource是指定對應的資源路徑。那我們就把指定的資源文件貼出來。
<appwidget-provider
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:initialLayout="@layout/layout_widget"
    android:minHeight="140dp"
    android:minWidth="140dp"
    android:previewImage="@drawable/smile"
    android:updatePeriodMillis="2000"
    android:widgetCategory="home_screen"
    >

</appwidget-provider>

簡單解釋一下:

  • initialLayout : 加載到桌面時對應的佈局文件
  • minWidth : 最小寬度
  • minHeight : 最小高度
  • previewImage : 預覽圖片
  • updatePeriodMillis : 更新widget的時間間隔(ms)
  • widgetCategory : widget可以被顯示的位置。home_screen表示可以將widget添加到桌面,keyguard表示widget可以被添加到鎖屏界面。

加載在桌面的佈局文件如下:

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


    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textAppearance="?android:attr/textAppearanceLarge"
        android:text="Large Text"
        android:id="@+id/widget_text_View"
        android:layout_gravity="center_horizontal"/>

    <Button
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="New Button"
        android:id="@+id/wighet_button"
        android:layout_gravity="center_horizontal"/>
</LinearLayout>

第一個注意的地方,widget支持的控件有限,基本上包括以下幾種:AnalogClock、Button、Chronometer、ImageButton、ImageView、ProgressBar、TextView、ViewFlipper、ListView、GridView、StackView、AdapterView、Flipper。其他就顯示不出來
前面準備工作做的差不多了,現在就是加載佈局文件了。利用RemoteViews可以直接加載整個佈局文件。在onUpdate()中的代碼如下

    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        super.onUpdate(context, appWidgetManager, appWidgetIds);
        Log.i(TAG, "onUpdate");
        //指定加載的頁面佈局文件
        RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.layout_widget);
        Intent intent = new Intent();
        intent.setClass(context, TestWidget.class);
        intent.setAction(WIDGET_BUTTON);
        PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);    remoteViews.setOnClickPendingIntent(R.id.wighet_button, pendingIntent);
        //
        appWidgetManager.updateAppWidget(appWidgetIds, remoteViews);
    }

爲Button設置點擊事件是remoteViews.setOnClickPendingIntent(R.id.wighet_button, pendingIntent);傳入的第一參數是Button的id,第二個是PendingIntent,,我的理解是不立即執行的意圖。現在是想點擊了Button然後發送廣播,在onReceive()中更新TextView的內容。

    @Override
    //接收廣播
    public void onReceive(Context context, Intent intent) {
        super.onReceive(context, intent);
        Log.i(TAG, "onReceive");
        if (intent != null && TextUtils.equals(intent.getAction(), WIDGET_BUTTON)){
            Log.i(WIDGET_BUTTON, "I am clicked");
            RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.layout_widget);
            //設置文字的內容
            remoteViews.setTextViewText(R.id.widget_text_View, "be clicked");

            AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
            //將AppWidgetProvider的子類實例包裝成ComponentName
            ComponentName componentName = new ComponentName(context, TestWidget.class);

            appWidgetManager.updateAppWidget(componentName, remoteViews);

        }
    }

第二個注意的地方,RemoteViews 絕對不能複用,據說Binder data size limit is 512k,由於傳輸到appWidget進程中的Binder最大數據量是512K,並且RemoteView也不會每次清理, 所以如果每次都使用同一個RemoteView進行傳輸會因爲溢出而報錯。所以必須每次重新建一個RemoteView來傳輸。
這樣一來一去,基本上就實現了一個可以操作的widget。如果想接收其他地方發的廣播,需要在AndroidManifest中註冊,然後在onReceive()中進行相關操作。
此時應該有圖,但是圖不見了,自行腦補一個TextView下有個Button。


當綁定多個Button或者view設置點擊事件的時候,如果只是設置Intent的Action不同,好像不能分辨,就是所有的按鈕都是一個功能,我的做法是將PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);的第二個參數設置的不同,這樣就可以分辨。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章