Android 系列 6.32创建一个简单的应用程序小部件widget

6.32创建一个简单的应用程序小部件

问题

您希望使用户能够更轻松地与您的应用程序交互。

解

创建一个应用程序小部件，它是一个简单的GUI控件，显示在主屏幕上，允许用户轻松地与现有应用程序（活动和/或服务）进行交互。

讨论

在这个食谱中，我们将创建一个小部件来启动更新其可视组件的服务。该小部件称为CurrentMoodWidget，以小部件中的“笑脸文本”的形式呈现用户当前的心情。当用户点击“笑脸图像”按钮时，当前的情绪笑脸变为随机的情绪笑脸。图6-19显示了初始视图，图6-20显示了随机更改后的视图。

图6-19。初始心情小部件

图6-20。当前心情小部件

以下是如何创建这个简单的应用程序小部件：

1.首先创建一个新的Android项目（CurrentMoodWidgetProject）。使用“当前心情”作为应用程序名称和“oreillymedia.cookbook.android.spikes”作为包名称。不要创建活动。将最低SDK版本设置为任何现代（技术上最低API级别为8，对于Android 2.2，引入App Widgets的版本）。

2.添加窗口小部件的字符串定义。将它放在资源文件夹（res / values / string.xml）下，根据以下名称 - 值对：

•widgettext - “当前心情：”

•widgetmoodtext - “:)”

3.添加将显示在小部件按钮中的图像。将这些放在res / drawable结构下（smile_icon.png）。

4.在res / layout下，在项目结构下创建一个新的布局文件，根据以下结构定义widget布局（widgetlayout.xml）：

<TextView android:text="@string/widgettext"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="0.8"
android:layout_gravity="center_vertical"
android:textColor="#000000"></TextView>
<TextView android:text="@string/widgetmoodtext"
android:id="@+id/widgetMood" android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="0.3"
android:layout_gravity="center_vertical"
android:textColor="#000000"></TextView>
<ImageButton android:id="@+id/widgetBtn" android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="0.5" android:src="@drawable/smile_icon"
android:layout_gravity="center_vertical"></ImageButton>

5.提供窗口小部件提供程序设置配置，首先在项目结构下创建res / xml文件夹，然后使用以下参数创建XML文件（widgetproviderinfo.xml）：

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

6.创建响应用户与笑脸图像按钮（CurrentMoodService.java）交互的服务;参见实施例6-38。
实例6-38。 Widget的服务实现

@Override
public int onStartCommand(Intent intent, int flags, int startId) {
super.onStart(intent, startId);
updateMood(intent);
stopSelf(startId);
return START_STICKY;
}
private void updateMood(Intent intent) {
if (intent != null){
String requestedAction = intent.getAction();
if (requestedAction != null && requestedAction.equals(UPDATEMOOD)){
this.currentMood = getRandomMood();
int widgetId = intent.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, 0);
AppWidgetManager appWidgetMan = AppWidgetManager.getInstance(this);
RemoteViews views =new RemoteViews(this.getPackageName(),R.layout.widgetlayout);
views.setTextViewText(R.id.widgetMood, currentMood);
appWidgetMan.updateAppWidget(widgetId, views);
}
}
}

7.实现小部件提供程序类（CurrentMoodWidgetProvider.java）; 参见实施例6-39。

实例6-39。 Widget提供程序类

@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
int[] appWidgetIds) {
super.onUpdate(context, appWidgetManager, appWidgetIds);
for (int i=0; i<appWidgetIds.length; i++) {
int appWidgetId = appWidgetIds[i];
RemoteViews views = new RemoteViews(context.getPackageName(),
R.layout.widgetlayout);
Intent intent = new Intent(context, CurrentMoodService.class);
intent.setAction(CurrentMoodService.UPDATEMOOD);
intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
PendingIntent pendingIntent = PendingIntent.getService(context, 0, intent, 0);
views.setOnClickPendingIntent(R.id.widgetBtn, pendingIntent);
appWidgetManager.updateAppWidget(appWidgetId, views);
}
}

8.最后，在清单文件（AndroidManifest.xml）中声明服务和应用程序窗口小部件提供程序。

<service android:name=".CurrentMoodService">
</service>
<receiver android:name=".CurrentMoodWidgetProvider">
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
</intent-filter>
<meta-data android:name="android.appwidget.provider"
android:resource="@xml/widgetproviderinfo" />
</receiver>