Andriod开发——widget组件开发

1.引言

1.1 Andriod widget的概念

Android widget 是一种特殊的应用组件，是自定义主屏幕的一个重要的方面。它允许用户将应用的特定功能或信息直接显示在主屏幕上。Widget 可以提供快速访问应用功能、显示实时数据或提供交互式控件，而无需用户打开完整的应用界面，用户可以在其主屏幕面板上移动 widget，并且如果支持，还可以调整 widget 的大小，以根据自己的偏好调整 widget 中的信息量。

1.2 Widget在应用中的作用和优势

• 快速访问：Widget 允许用户快速访问应用的核心功能或信息，而无需打开应用本身。
• 实时信息展示：Widget 可以显示实时数据，如天气预报、日历日程等，用户能够即时获取重要信息。
  
• 交互性：用户可以通过与 Widget 交互来执行特定任务，例如音乐播放微件，ToDo list微件。
  
  
• 个性化体验：Widget 支持自定义配置，用户可以根据自己的喜好和需求调整 Widget 的内容和外观。
• 节省空间：Widget 通常比完整的应用界面更紧凑，能够在主屏幕上占用较少的空间。

2. Widget的基本结构

创建一个widget，主要需要以下基本组件：

• AppWidgetProviderInfo对象
• AppWidgetProvider 类
• 视图布局

2.1 AppWidgetProviderInfo对象

描述微件的元数据，用于定义Widget的属性和行为。例如微件的布局、更新频率和 AppWidgetProvider 类。AppWidgetProviderInfo 是在 XML 中定义的。这个文件通常位于res/xml目录下。

2.2 AppWidgetProvider 类

这是一个广播接收器类，用于定义允许以编程方式与微件连接的基本方法，即用于定义widget的行为。通过它，您会在更新、启用、停用或删除微件时收到广播。
需要在清单中声明 AppWidgetProvider，然后实现它。
AppWidgetProvider 类扩展了 BroadcastReceiver 作为一个辅助类来处理微件广播，实现onUpdate()、onEnabled()、onDisabled()等，以处理Widget的生命周期事件。

2.3 视图布局

在 XML 中为 widget 定义初始布局，并将其保存在项目的 res/layout/ 目录中。
widget的布局基于RemoteViews，在Widget中创建复杂的布局和更新内容，而不会影响主线程的性能。

3.创建一个简单的widget

接下来创建一个TODO LIST应用的Widget进行展示。

3.1 创建一个新的App Widget

Android Studio 可以自动创建一组 AppWidgetProviderInfo、AppWidgetProvider 和 View 布局文件。
依次选择New -> Widget > AppWidget

3.2 创建Todo数据模型和SharedPreferences工具类

ToDo.java:

package com.example.appwidget;

public class Todo {
    private String id;
    private String content;
    private boolean completed;

    public Todo(String id, String content, boolean completed) {
        this.id = id;
        this.content = content;
        this.completed = completed;
    }

    public String getId() { return id; }
    public String getContent() { return content; }
    public boolean isCompleted() { return completed; }
    public void setCompleted(boolean completed) { this.completed = completed; }
} 

使用SharedPreferences实现数据持久化。
TodoPreferences.java:

package com.example.appwidget;

import android.content.Context;
import android.content.SharedPreferences;
import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.util.ArrayList;
import java.util.List;
import java.util.UUID;

public class TodoPreferences {
    private static final String PREF_NAME = "todo_preferences";
    private static final String KEY_TODOS = "todos";
    private final SharedPreferences preferences;
    private final Gson gson;

    public TodoPreferences(Context context) {
        preferences = context.getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE);
        gson = new Gson();
    }

    public List<Todo> getTodos() {
        String json = preferences.getString(KEY_TODOS, "[]");
        return gson.fromJson(json, new TypeToken<List<Todo>>(){}.getType());
    }

    public void saveTodos(List<Todo> todos) {
        String json = gson.toJson(todos);
        preferences.edit().putString(KEY_TODOS, json).apply();
    }

    public void addTodo(String content) {
        List<Todo> todos = getTodos();
        todos.add(new Todo(UUID.randomUUID().toString(), content, false));
        saveTodos(todos);
    }

    public void toggleTodo(String id) {
        List<Todo> todos = getTodos();
        for (Todo todo : todos) {
            if (todo.getId().equals(id)) {
                todo.setCompleted(!todo.isCompleted());
                break;
            }
        }
        saveTodos(todos);
    }

    public void deleteTodo(String id) {
        List<Todo> todos = getTodos();
        todos.removeIf(todo -> todo.getId().equals(id));
        saveTodos(todos);
    }
} 

3.3 创建RemoteViewsFactory来提供列表数据

TodoRemoteViewsFactory.java:

package com.example.appwidget;

import android.content.Context;
import android.content.Intent;
import android.widget.RemoteViews;
import android.widget.RemoteViewsService;
import java.util.List;

public class TodoRemoteViewsFactory implements RemoteViewsService.RemoteViewsFactory {
    private Context context;
    private List<Todo> todos;
    private TodoPreferences preferences;

    public TodoRemoteViewsFactory(Context context) {
        this.context = context;
        this.preferences = new TodoPreferences(context);
    }

    @Override
    public void onCreate() {
        // 初始化时不需要加载数据
    }

    @Override
    public void onDataSetChanged() {
        // 当数据更新时重新加载
        todos = preferences.getTodos();
    }

    @Override
    public void onDestroy() {
        todos.clear();
    }

    @Override
    public int getCount() {
        return todos.size();
    }

    @Override
    public RemoteViews getViewAt(int position) {
        if (position < 0 || position >= todos.size()) {
            return null;
        }

        Todo todo = todos.get(position);
        RemoteViews rv = new RemoteViews(context.getPackageName(), R.layout.todo_item);
        rv.setTextViewText(R.id.todo_text, todo.getContent());
        rv.setImageViewResource(R.id.todo_checkbox, 
            todo.isCompleted() ? R.drawable.ic_checkbox_checked : R.drawable.ic_checkbox_unchecked);

        // 设置点击事件的填充Intent
        Intent fillIntent = new Intent();
        fillIntent.putExtra("todo_id", todo.getId());
        rv.setOnClickFillInIntent(R.id.todo_item_container, fillIntent);

        return rv;
    }

    @Override
    public RemoteViews getLoadingView() {
        return null;
    }

    @Override
    public int getViewTypeCount() {
        return 1;
    }

    @Override
    public long getItemId(int position) {
        return position;
    }

    @Override
    public boolean hasStableIds() {
        return true;
    }
} 

3.4 创建RemoteViewsService

TodoRemoteViewsService.java:

package com.example.appwidget;

import android.content.Intent;
import android.widget.RemoteViewsService;

public class TodoRemoteViewsService extends RemoteViewsService {
    @Override
    public RemoteViewsFactory onGetViewFactory(Intent intent) {
        return new TodoRemoteViewsFactory(this.getApplicationContext());
    }
} 

3.5 修改widget布局

todo_list_widget.xml:

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    style="@style/Widget.AppWidget.AppWidget.Container"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:theme="@style/Theme.AppWidget.AppWidgetContainer">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical">

        <TextView
            android:id="@+id/widget_title"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:background="@color/light_blue_600"
            android:padding="8dp"
            android:text="@string/todo_list"
            android:textColor="@color/white"
            android:textSize="18sp"
            android:textStyle="bold" />

        <ListView
            android:id="@+id/todo_list"
            android:layout_width="match_parent"
            android:layout_height="0dp"
            android:layout_weight="1"
            android:divider="@android:color/darker_gray"
            android:dividerHeight="1dp" />

        <TextView
            android:id="@+id/empty_view"
            android:layout_width="match_parent"
            android:layout_height="0dp"
            android:layout_weight="1"
            android:gravity="center"
            android:text="@string/empty_list"
            android:textSize="16sp"
            android:visibility="gone" />

        <ImageButton
            android:id="@+id/add_button"
            android:layout_width="48dp"
            android:layout_height="48dp"
            android:layout_gravity="end|bottom"
            android:layout_margin="8dp"
            android:background="@drawable/circular_button"
            android:src="@android:drawable/ic_input_add"
            android:tint="@color/white" />
    </LinearLayout>

</RelativeLayout>

3.6 创建列表项布局

todo_item.xml:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/todo_item_container"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="horizontal"
    android:padding="8dp">

    <ImageView
        android:id="@+id/todo_checkbox"
        android:layout_width="24dp"
        android:layout_height="24dp"
        android:layout_gravity="center_vertical"
        android:src="@drawable/ic_checkbox_unchecked" />

    <TextView
        android:id="@+id/todo_text"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_gravity="center_vertical"
        android:layout_marginStart="8dp"
        android:layout_weight="1"
        android:textSize="16sp" />

</LinearLayout> 

3.7 修改Widget提供者类

TodoListWidget.java

package com.example.appwidget;

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

/**
 * Implementation of App Widget functionality.
 */
public class TodoListWidget extends AppWidgetProvider {

    public static final String ACTION_REFRESH = "com.example.appwidget.ACTION_REFRESH";
    public static final String ACTION_TOGGLE_TODO = "com.example.appwidget.ACTION_TOGGLE_TODO";
    public static final String EXTRA_TODO_ID = "todo_id";

    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        for (int appWidgetId : appWidgetIds) {
            updateAppWidget(context, appWidgetManager, appWidgetId);
        }
    }

    @Override
    public void onReceive(Context context, Intent intent) {
        super.onReceive(context, intent);
        
        if (ACTION_REFRESH.equals(intent.getAction())) {
            AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
            ComponentName thisWidget = new ComponentName(context, TodoListWidget.class);
            int[] appWidgetIds = appWidgetManager.getAppWidgetIds(thisWidget);
            appWidgetManager.notifyAppWidgetViewDataChanged(appWidgetIds, R.id.todo_list);
        } else if (ACTION_TOGGLE_TODO.equals(intent.getAction())) {
            String todoId = intent.getStringExtra(EXTRA_TODO_ID);
            if (todoId != null) {
                TodoPreferences preferences = new TodoPreferences(context);
                preferences.toggleTodo(todoId);
                // 刷新widget
                Intent refreshIntent = new Intent(context, TodoListWidget.class);
                refreshIntent.setAction(ACTION_REFRESH);
                context.sendBroadcast(refreshIntent);
            }
        }
    }

    static void updateAppWidget(Context context, AppWidgetManager appWidgetManager, int appWidgetId) {
        RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.todo_list_widget);

        // 设置ListView的适配器
        Intent serviceIntent = new Intent(context, TodoRemoteViewsService.class);
        serviceIntent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
        serviceIntent.setData(Uri.parse(serviceIntent.toUri(Intent.URI_INTENT_SCHEME)));
        views.setRemoteAdapter(R.id.todo_list, serviceIntent);

        // 设置空视图
        views.setEmptyView(R.id.todo_list, R.id.empty_view);

        // 设置列表项点击事件
        Intent toggleIntent = new Intent(context, TodoListWidget.class);
        toggleIntent.setAction(ACTION_TOGGLE_TODO);
        PendingIntent togglePendingIntent = PendingIntent.getBroadcast(
            context, 0, toggleIntent, PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_MUTABLE);
        views.setPendingIntentTemplate(R.id.todo_list, togglePendingIntent);

        // 设置添加按钮点击事件
        Intent mainIntent = new Intent(context, MainActivity.class);
        PendingIntent mainPendingIntent = PendingIntent.getActivity(
            context, 0, mainIntent, PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_MUTABLE);
        views.setOnClickPendingIntent(R.id.add_button, mainPendingIntent);

        appWidgetManager.updateAppWidget(appWidgetId, views);
    }

    @Override
    public void onEnabled(Context context) {
        // Enter relevant functionality for when the first widget is created
    }

    @Override
    public void onDisabled(Context context) {
        // Enter relevant functionality for when the last widget is disabled
    }
}

3.8 更新AndroidManifest.xml

修改todo_list_widget_info.xml:

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:description="@string/app_widget_description"
    android:initialKeyguardLayout="@layout/todo_list_widget"
    android:initialLayout="@layout/todo_list_widget"
    android:minWidth="180dp"
    android:minHeight="110dp"
    android:previewImage="@drawable/example_appwidget_preview"
    android:previewLayout="@layout/todo_list_widget"
    android:resizeMode="horizontal|vertical"
    android:targetCellWidth="3"
    android:targetCellHeight="2"
    android:updatePeriodMillis="1800000"
    android:widgetCategory="home_screen" />

在AndroidManifest.xml中注册新的Service：

<service
            android:name=".TodoRemoteViewsService"
            android:permission="android.permission.BIND_REMOTEVIEWS" />

3.9 完善主应用以实现TODO List功能

• 创建一个布局文件用于主界面

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

    <com.google.android.material.appbar.AppBarLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content">

        <androidx.appcompat.widget.Toolbar
            android:id="@+id/toolbar"
            android:layout_width="match_parent"
            android:layout_height="?attr/actionBarSize"
            android:background="?attr/colorPrimary"
            android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar" />

    </com.google.android.material.appbar.AppBarLayout>

    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/todo_list"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1" />

    <com.google.android.material.floatingactionbutton.FloatingActionButton
        android:id="@+id/fab_add"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="end|bottom"
        android:layout_margin="16dp"
        android:src="@android:drawable/ic_input_add" />

</LinearLayout>

• 创建一个列表项布局

<?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="wrap_content"
    android:orientation="horizontal"
    android:padding="16dp">

    <CheckBox
        android:id="@+id/checkbox"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_vertical" />

    <TextView
        android:id="@+id/text_todo"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_gravity="center_vertical"
        android:layout_marginStart="16dp"
        android:layout_weight="1"
        android:textSize="16sp" />

    <ImageButton
        android:id="@+id/button_delete"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_vertical"
        android:background="?attr/selectableItemBackgroundBorderless"
        android:padding="8dp"
        android:src="@android:drawable/ic_menu_delete" />

</LinearLayout> 

• 创建一个对话框布局用于添加新任务

<?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="wrap_content"
    android:orientation="vertical"
    android:padding="16dp">

    <EditText
        android:id="@+id/edit_todo"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="@string/hint_add_todo"
        android:inputType="text"
        android:maxLines="1" />

</LinearLayout> 

• 创建RecyclerView的适配器

package com.example.appwidget;

import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.CheckBox;
import android.widget.ImageButton;
import android.widget.TextView;
import androidx.recyclerview.widget.RecyclerView;
import java.util.List;

public class TodoAdapter extends RecyclerView.Adapter<TodoAdapter.ViewHolder> {
    private List<Todo> todos;
    private TodoPreferences preferences;

    public TodoAdapter(List<Todo> todos, TodoPreferences preferences) {
        this.todos = todos;
        this.preferences = preferences;
    }

    @Override
    public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        View view = LayoutInflater.from(parent.getContext())
                .inflate(R.layout.item_todo, parent, false);
        return new ViewHolder(view);
    }

    @Override
    public void onBindViewHolder(ViewHolder holder, int position) {
        Todo todo = todos.get(position);
        holder.textTodo.setText(todo.getContent());
        holder.checkbox.setChecked(todo.isCompleted());
        
        holder.checkbox.setOnClickListener(v -> {
            preferences.toggleTodo(todo.getId());
            refreshData();
        });
        
        holder.buttonDelete.setOnClickListener(v -> {
            preferences.deleteTodo(todo.getId());
            refreshData();
        });
    }

    @Override
    public int getItemCount() {
        return todos.size();
    }

    public void refreshData() {
        todos = preferences.getTodos();
        notifyDataSetChanged();
    }

    static class ViewHolder extends RecyclerView.ViewHolder {
        CheckBox checkbox;
        TextView textTodo;
        ImageButton buttonDelete;

        ViewHolder(View view) {
            super(view);
            checkbox = view.findViewById(R.id.checkbox);
            textTodo = view.findViewById(R.id.text_todo);
            buttonDelete = view.findViewById(R.id.button_delete);
        }
    }
} 

• 修改MainActivity

package com.example.appwidget;

import android.app.AlertDialog;
import android.appwidget.AppWidgetManager;
import android.content.ComponentName;
import android.content.Intent;
import android.os.Bundle;
import android.view.LayoutInflater;
import android.view.View;
import android.widget.EditText;
import androidx.appcompat.app.AppCompatActivity;
import androidx.appcompat.widget.Toolbar;
import androidx.recyclerview.widget.LinearLayoutManager;
import androidx.recyclerview.widget.RecyclerView;
import com.google.android.material.floatingactionbutton.FloatingActionButton;

public class MainActivity extends AppCompatActivity {
    private TodoPreferences preferences;
    private TodoAdapter adapter;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        Toolbar toolbar = findViewById(R.id.toolbar);
        setSupportActionBar(toolbar);
        
        preferences = new TodoPreferences(this);
        
        RecyclerView recyclerView = findViewById(R.id.todo_list);
        recyclerView.setLayoutManager(new LinearLayoutManager(this));
        adapter = new TodoAdapter(preferences.getTodos(), preferences);
        recyclerView.setAdapter(adapter);

        FloatingActionButton fab = findViewById(R.id.fab_add);
        fab.setOnClickListener(v -> showAddTodoDialog());
    }

    private void showAddTodoDialog() {
        View dialogView = LayoutInflater.from(this)
                .inflate(R.layout.dialog_add_todo, null);
        EditText editTodo = dialogView.findViewById(R.id.edit_todo);

        new AlertDialog.Builder(this)
                .setTitle(R.string.add_todo)
                .setView(dialogView)
                .setPositiveButton(android.R.string.ok, (dialog, which) -> {
                    String content = editTodo.getText().toString().trim();
                    if (!content.isEmpty()) {
                        preferences.addTodo(content);
                        adapter.refreshData();
                        refreshWidget();
                    }
                })
                .setNegativeButton(android.R.string.cancel, null)
                .show();
    }

    private void refreshWidget() {
        Intent intent = new Intent(this, TodoListWidget.class);
        intent.setAction(TodoListWidget.ACTION_REFRESH);
        sendBroadcast(intent);
    }
}

3.10 运行效果

• 通过长按应用图标添加widget，在主屏幕显示TODO列表
  
  
• 支持调整大小以及切换任务完成状态
  
• 添加按钮打开主应用，支持添加、删除任务，实现了刷新机制
  

4.Widget开发的新纪元——Jetpack Glance

4.1 Glance简介

Jetpack Glance是Google推出的新一代Widget开发框架，它使用Kotlin和类似Jetpack Compose的声明式UI语法，极大地简化了Android Widget的开发过程。

主要特点：

• 声明式UI设计
• 简化的状态管理
• 更好的开发体验
• 与Jetpack Compose兼容
• 更少的模板代码

4.2 基础实现

• 添加依赖

dependencies {
    // ... existing dependencies ...
    implementation("androidx.glance:glance-appwidget:1.0.0")
    implementation("androidx.glance:glance-material3:1.0.0")
}

• 创建基础Widget

package com.example.appwidget3

import androidx.compose.runtime.Composable
import androidx.glance.GlanceModifier
import androidx.glance.appwidget.GlanceAppWidget
import androidx.glance.appwidget.GlanceAppWidgetReceiver
import androidx.glance.layout.Column
import androidx.glance.layout.fillMaxSize
import androidx.glance.text.Text

class SimpleAppWidget : GlanceAppWidget() {
    @Composable
    override fun Content() {
        Column(
            modifier = GlanceModifier.fillMaxSize()
        ) {
            Text(text = "Hello from Glance Widget!")
        }
    }
}dgetReceiver : GlanceAppWidgetReceiver() {
   override val glanceAppWidget: GlanceAppWidget = SimpleAppWidget()

• 创建布局文件 glance_default_loading_layout.xml

<?xml version="1.0" encoding="utf-8"?>
FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   android:padding="8dp">
    <ProgressBar
       android:layout_width="24dp"
       android:layout_height="24dp"
       android:layout_gravity="center" />
</FrameLayout>

• 在AndroidManifest.xml中注册Widget

<manifest>
    <application>
        <!-- ... existing content ... -->
        <receiver
            android:name=".SimpleAppWidgetReceiver"
            android:exported="true">
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
            </intent-filter>
            <meta-data
                android:name="android.appwidget.provider"
                android:resource="@xml/simple_app_widget_info" />
        </receiver>
    </application>
</manifest>

• 创建Widget配置文件 simple_app_widget_info.xml

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="180dp"
    android:minHeight="50dp"
    android:updatePeriodMillis="1800000"
    android:initialLayout="@layout/glance_default_loading_layout"
    android:resizeMode="horizontal|vertical"
    android:widgetCategory="home_screen">
</appwidget-provider>

4.3 状态管理

• 定义状态

data class WeatherWidgetState(
    val temperature: Int = 0,
    val condition: String = "",
    val lastUpdated: Long = System.currentTimeMillis()
)

• 实现状态更新

class WeatherWidget : GlanceAppWidget() {
    val weatherState = GlanceStateDefinition<WeatherWidgetState>()
    
    @Composable
    override fun Content() {
        val state = currentState<WeatherWidgetState>()
        
        Column {
            Text("温度: ${state.temperature}°C")
            Text("天气: ${state.condition}")
            Text("更新时间: ${formatTime(state.lastUpdated)}")
        }
    }
}

4.4 交互处理

• 点击事件

@Composable
fun InteractiveWidgetContent() {
    Column {
        Button(
            text = "刷新",
            onClick = actionStartActivity<MainActivity>()
        )
        
        Button(
            text = "设置",
            onClick = actionStartActivity<SettingsActivity>()
        )
    }
}

• 定期更新

class WidgetUpdateWorker(
    context: Context,
    params: WorkerParameters
) : CoroutineWorker(context, params) {
    
    override suspend fun doWork(): Result {
        // 更新widget数据
        val newState = fetchWeatherData()
        WeatherWidget().updateState(context) { 
            newState 
        }
        return Result.success()
    }
}

4.5 高级功能

• 响应式布局

@Composable
fun ResponsiveWidgetContent() {
    val sizeMode = LocalSize.current
    
    when (sizeMode) {
        GlanceSize.Small -> SmallWidgetLayout()
        GlanceSize.Medium -> MediumWidgetLayout()
        GlanceSize.Large -> LargeWidgetLayout()
    }
}

• 主题适配

@Composable
fun ThemedWidgetContent() {
    val colorScheme = GlanceTheme.colors
    
    Column(
        modifier = GlanceModifier
            .background(colorScheme.background)
    ) {
        Text(
            text = "主题适配示例",
            style = TextStyle(
                color = colorScheme.onBackground
            )
        )
    }
}

---

参考链接：Android Developer–应用widget简介

作者：骆婧颖
原文链接：https://blog.csdn.net/weixin_74107597/article/details/144560360?spm=1001.2014.3001.5501