Android 简明教程

Android - Widgets

小组件是放置在主屏幕上安卓应用程序的一个小工具或控件。有了小组件，您可以将自己喜爱的应用程序放在主屏幕上，以便快速访问，因此小组件非常方便。您可能已经看到过一些常见的小组件，如音乐小组件、天气小组件、时钟小组件等。

小组件可能类型繁多，诸如信息小组件、收集小组件、控制小组件和混合小组件。安卓为我们提供一个完整的框架来开发我们自己的小组件。

Widget - XML file

要创建一个应用程序小组件，首先您需要的是 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>

Widget - Layout file

现在，您必须在默认 XML 文件中定义小组件的布局。您可以拖放组件以生成自动 xml。

Widget - Java file

在定义布局后，现在创建一个新的 JAVA 文件或使用现有文件，并使用 AppWidgetProvider 类对其进行扩展，并按如下所示覆盖其更新方法。

在更新方法中，您必须定义两个类的对象，即 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 方法，此类中还定义了其他方法以操作小组件。它们如下所示：

Sr.No

Method & Description

1

onDeleted(Context context, int[] appWidgetIds) 在 AppWidgetProvider 的一个实例被删除时调用此方法。

2

onDisabled(Context context) 在 AppWidgetProvider 的最后一个实例被删除时调用此方法。

3

onEnabled(Context context) 在 AppWidgetProvider 的一个实例被创建时调用此方法。

4

onReceive(Context context, Intent intent) 用于调度对该类的各种方法的调用。

Widget - Manifest file

您还必须在清单文件中声明 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>

Example

以下是一个示例，演示应用程序小组件的使用。它创建了一个基本的小组件应用程序，其将在浏览器中打开当前网站。

要使用此示例，您需要在运行因特网的实际设备上运行此示例。

Steps

Description

1

你将使用 Android Studio 在包 com.example.sairamkrishna.myapplication 下创建 Android 应用程序。

2

修改 src/MainActivity.java 文件以添加小组件代码。

3

修改 res/layout/activity_main 以添加各自的 XML 组件

4

在 res/xml/mywidget.xml 下创建一个新文件夹和 XML 文件以添加各自的 XML 组件。

5

修改 AndroidManifest.xml 以添加必要的权限。

6

运行该应用程序，选择一个正在运行的安卓设备，并在该设备上安装应用程序并验证结果。

下面是已修改的 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://www.tutorialspoint.com";

         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>

让我们尝试运行应用程序。我想你已经将你的安卓移动设备连接到你的电脑上了。从安卓工作室运行该应用，打开你的项目活动文件之一，并点击工具栏上的运行图标。在启动应用程序之前，安卓工作室将显示以下窗口来选择运行安卓应用程序的位置。

choose device

选择您的移动设备作为选项，然后检查您的移动设备，它将显示您的默认屏幕 −

widget1

转到小组件区域，将你创建的小组件添加到桌面或主屏幕。它将看起来类似于以下内容 –

widget1

现在只需点击出现的按钮小组件即可启动浏览器。但在这样做之前，请确保你已连接到互联网。按下该按钮后，将出现以下屏幕 –

widget2

注意：只需更改 Java 文件中的 url，你的小组件将在浏览器中打开你想要的网站。