Android - 小部件

---

---

小部件是放置在主螢幕上的Android應用程式的小工具或控制元件。小部件非常方便，因為它們允許您將喜愛的應用程式放在主螢幕上以便快速訪問它們。您可能已經看到一些常見的小部件，例如音樂小部件、天氣小部件、時鐘小部件等等。

小部件可以有多種型別，例如資訊小部件、集合小部件、控制小部件和混合小部件。Android 為我們提供了一個完整的框架來開發我們自己的小部件。

小部件 - XML 檔案

要建立應用程式小部件，首先需要的是 AppWidgetProviderInfo 物件，您將在單獨的小部件 XML 檔案中定義它。為此，請右鍵單擊您的專案並建立一個名為 **xml** 的新資料夾。現在右鍵單擊新建立的資料夾並建立一個新的 XML 檔案。XML 檔案的資源型別應設定為 **AppWidgetProvider**。在 xml 檔案中，定義一些屬性，如下所示：

<appwidget-provider 
   xmlns:android="http://schemas.android.com/apk/res/android" 
   android:minWidth="146dp" 
   android:updatePeriodMillis="0" 
   android:minHeight="146dp" 
   android:initialLayout="@layout/activity_main">
</appwidget-provider>

小部件 - 佈局檔案

現在您必須在預設的 XML 檔案中定義小部件的佈局。您可以拖動元件以生成自動 xml。

小部件 - Java 檔案

定義佈局後，現在建立一個新的 JAVA 檔案或使用現有的檔案，並使用 **AppWidgetProvider** 類擴充套件它，並覆蓋其 update 方法，如下所示。

在 update 方法中，您必須定義兩個類的物件，它們是 PendingIntent 和 RemoteViews。其語法如下：

PendingIntent pending = PendingIntent.getActivity(context, 0, intent, 0);
RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.activity_main);

最後，您必須呼叫 AppWidgetManager 類的 updateAppWidget() 方法。其語法如下：

appWidgetManager.updateAppWidget(currentWidgetId,views);		

除了 updateAppWidget 方法外，此類中還定義了其他方法來操作小部件。它們如下：

小部件 - Manifest 檔案

您還必須在清單檔案中宣告 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>

示例

這是一個演示應用程式小部件用法的示例。它建立一個基本的小部件應用程式，將在瀏覽器中開啟當前網站。

要試驗此示例，您需要在執行網際網路的實際裝置上執行它。

以下是修改後的 **MainActivity.java** 的內容。

package com.example.sairamkrishna.myapplication;

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

public class MainActivity extends AppWidgetProvider{
   public void onUpdate(Context context, AppWidgetManager appWidgetManager,int[] appWidgetIds) {
      for(int i=0; i<appWidgetIds.length; i++){
         int currentWidgetId = appWidgetIds[i];
         String url = "https://tutorialspoint.tw";
         
         Intent intent = new Intent(Intent.ACTION_VIEW);
         intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
         intent.setData(Uri.parse(url));
         
         PendingIntent pending = PendingIntent.getActivity(context, 0,intent, 0);
         RemoteViews views = new RemoteViews(context.getPackageName(),R.layout.activity_main);
         
         views.setOnClickPendingIntent(R.id.button, pending);
         appWidgetManager.updateAppWidget(currentWidgetId,views);
         Toast.makeText(context, "widget added", Toast.LENGTH_SHORT).show();
      }
   }
}

以下是修改後的 xml **res/layout/activity_main.xml** 的內容。

<?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:paddingLeft="@dimen/activity_horizontal_margin"
   android:paddingRight="@dimen/activity_horizontal_margin"
   android:paddingTop="@dimen/activity_vertical_margin"
   android:paddingBottom="@dimen/activity_vertical_margin"
   tools:context=".MainActivity"
   android:transitionGroup="true">
   
   <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Tutorials point"
      android:id="@+id/textView"
      android:layout_centerHorizontal="true"
      android:textColor="#ff3412ff"
      android:textSize="35dp" />
      
   <Button
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Widget"
      android:id="@+id/button"
      android:layout_centerHorizontal="true"
      android:layout_marginTop="61dp"
      android:layout_below="@+id/textView" />

</RelativeLayout>

以下是 **res/xml/mywidget.xml** 的內容。

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider 
   xmlns:android="http://schemas.android.com/apk/res/android" 
   android:minWidth="146dp" 
   android:updatePeriodMillis="0" 
   android:minHeight="146dp" 
   android:initialLayout="@layout/activity_main">
</appwidget-provider>

以下是 **res/values/string.xml** 的內容。

<resources>
   <string name="app_name">My Application</string>
</resources>

以下是 **AndroidManifest.xml** 檔案的內容。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
   package="com.example.sairamkrishna.myapplication" >
   
   <application
      android:allowBackup="true"
      android:icon="@mipmap/ic_launcher"
      android:label="@string/app_name"
      android:theme="@style/AppTheme" >
      <receiver android:name=".MainActivity">
      
      <intent-filter>
         <action android:name="android.appwidget.action.APPWIDGET_UPDATE"></action>
      </intent-filter>
      
      <meta-data android:name="android.appwidget.provider"
         android:resource="@xml/mywidget"></meta-data>
      
      </receiver>
   
   </application>
</manifest>

讓我們嘗試執行您的應用程式。我假設您已將實際的 Android 移動裝置連線到您的計算機。要從 Android Studio 執行應用程式，請開啟專案的一個活動檔案，然後單擊工具欄中的執行 圖示。在啟動應用程式之前，Android Studio 將顯示以下視窗，供您選擇要在其中執行 Android 應用程式的選項。

選擇您的移動裝置作為選項，然後檢查您的移動裝置，它將顯示您的預設螢幕：

轉到您的視窗小部件部分，並將您建立的小部件新增到桌面或主螢幕。它看起來像這樣：

現在只需點擊出現的小部件按鈕即可啟動瀏覽器。但在此之前，請確保您已連線到網際網路。按下按鈕後，將出現以下螢幕：

注意：只需更改 java 檔案中的 url，您的視窗小部件就會在瀏覽器中開啟您想要的網站。