在 Android 桌面小部件（Widget）开发中，处理用户交互并同步更新界面是核心需求。下面介绍一种通过 Service 组件响应按钮点击、实现计数器递减的方案。

核心机制

Widget 运行在系统进程中，无法直接响应普通 View 的点击事件。需借助 PendingIntent 将操作转发到具备执行条件的组件（如 Service），在 Service 中完成业务逻辑后再刷新 RemoteViews。

配置声明

AndroidManifest.xml 中需注册 AppWidgetProvider 接收器，并为 Service 配置自定义 Action 以便匹配点击事件：

<?xml version="1.0" encoding="utf-8"? >
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.counter_widget" >

    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name" >

        <receiver android:name=".CounterWidget" android:label="COUNTER_WIDGET" >
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
            </intent-filter>
            <meta-data
                android:name="android.appwidget.provider"
                android:resource="@xml/counter_widget_info" />
        </receiver>

        <service android:name=".CounterWidget$UpdateService" >
            <intent-filter>
                <action android:name="com.example.action.DECREMENT_COUNT" />
            </intent-filter>
        </service>

    </application>
</manifest>

实现代码

package com.example.counter_widget;

import android.app.PendingIntent;
import android.app.Service;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.os.IBinder;
import android.widget.RemoteViews;

public class CounterWidget extends AppWidgetProvider {

    private static final String ACTION_DECREMENT = "com.example.action.DECREMENT_COUNT";
    private static volatile int counterValue = 100;

    @Override
    public void onUpdate(Context ctx, AppWidgetManager mgr, int[] widgetIds) {
        ctx.startService(new Intent(ctx, UpdateService.class));
    }

    public static class UpdateService extends Service {

        @Override
        public int onStartCommand(Intent intent, int flags, int startId) {
            handleIntent(intent);
            return START_NOT_STICKY;
        }

        private void handleIntent(Intent intent) {
            ComponentName widgetComponent = new ComponentName(this, CounterWidget.class);
            AppWidgetManager widgetManager = AppWidgetManager.getInstance(this);
            RemoteViews views = new RemoteViews(getPackageName(), R.layout.widget_layout);

            if (intent != null && ACTION_DECREMENT.equals(intent.getAction())) {
                counterValue--;
            }

            views.setTextViewText(R.id.tv_counter, String.valueOf(counterValue));

            Intent decrementIntent = new Intent();
            decrementIntent.setAction(ACTION_DECREMENT);
            PendingIntent pendingIntent = PendingIntent.getService(
                    this, 0, decrementIntent, PendingIntent.FLAG_UPDATE_CURRENT);

            views.setOnClickPendingIntent(R.id.btn_decrement, pendingIntent);
            widgetManager.updateAppWidget(widgetComponent, views);
        }

        @Override
        public IBinder onBind(Intent intent) {
            return null;
        }
    }
}

关键点说明

1. PendingIntent 的构建策略

通过 PendingIntent.getService() 将点击操作封装为可延迟执行的任务。每次更新 Widget 时都需重新绑定点击事件，否则系统缓存可能导致行为异常。

2. Action 匹配与状态判定

Service 首次启动时 intent 为 null（或由系统触发），此时仅执行初始化；用户点击后 intent 携带自定义 Action，进入分支执行递减逻辑。务必做空值和 Action 双重校验。

3. 布局文件参考

widget_layout.xml 采用垂直线性布局，上方为显示计数的 TextView，下方为触发递减的 Button：

<?xml version="1.0" encoding="utf-8"? >
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="16dp"
    android:background="@drawable/widget_background" >

    <TextView
        android:id="@+id/tv_counter"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textSize="48sp"
        android:textStyle="bold"
        android:layout_gravity="center_horizontal" />

    <Button
        android:id="@+id/btn_decrement"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="减少"
        android:layout_gravity="center_horizontal"
        android:layout_marginTop="12dp" />

</LinearLayout>

优化建议

当前方案使用静态变量保存计数，应用进程被杀后会丢失数据。生产环境中建议改用 SharedPreferences 持久化存储，并在 onUpdate 时恢复最新值：

// 读取持久化数据替代静态变量
SharedPreferences prefs = getSharedPreferences("widget_data", Context.MODE_PRIVATE);
counterValue = prefs.getInt("count", 100);

// 递减后保存
prefs.edit().putInt("count", counterValue).apply();