如何制作带可滚动文本的Android桌面小部件？

由于RemoteView不支持ScrollView，以下是几种经过验证的实现思路，覆盖不同场景和版本兼容性：

1. 单行文本滚动：利用TextView的跑马灯效果 #

适合短文本单行滚动，无需额外逻辑，全版本兼容。

布局实现 #

在小部件布局XML中配置TextView：

<TextView
    android:id="@+id/marquee_text"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:text="你的长单行文本内容"
    android:singleLine="true"
    android:ellipsize="marquee"
    android:marqueeRepeatLimit="marquee_forever"
    android:focusable="true"
    android:focusableInTouchMode="true"
    android:scrollHorizontally="true"
    android:padding="8dp"/>

代码激活跑马灯 #

在AppWidgetProvider的onUpdate方法中，设置TextView为选中状态触发滚动：

RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.widget_layout);
// 设置选中状态，让跑马灯生效
views.setBoolean(R.id.marquee_text, "setSelected", true);
appWidgetManager.updateAppWidget(appWidgetId, views);

2. 多行文本滚动：分段切换模拟滚动 #

适合需要显示长文本但无法使用高版本API的场景，通过定时切换文本片段配合动画实现滚动效果。

布局实现（使用ViewFlipper） #

<ViewFlipper
    android:id="@+id/text_flipper"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:autoStart="true"
    android:flipInterval="3000"
    android:inAnimation="@anim/fade_in"
    android:outAnimation="@anim/fade_out"/>

其中fade_in.xml和fade_out.xml为自定义淡入淡出动画，用于切换过渡。

代码动态填充文本块 #

将长文本拆分为适配小部件高度的片段，逐个添加到ViewFlipper：

RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.widget_layout);
views.removeAllViews(R.id.text_flipper);

// 自定义方法：将长文本拆分为适合小部件显示的块
List<String> textBlocks = splitLongTextIntoBlocks(longText, getWidgetHeight(appWidgetId));
for (String block : textBlocks) {
    RemoteViews itemView = new RemoteViews(context.getPackageName(), R.layout.widget_text_item);
    itemView.setTextViewText(R.id.block_text, block);
    views.addView(R.id.text_flipper, itemView);
}

appWidgetManager.updateAppWidget(appWidgetId, views);

需自行实现splitLongTextIntoBlocks方法，根据文本字号、行高和小部件高度计算每个块的内容。

3. 多行文本滚动：利用WebView实现原生滚动 #

通过RemoteView支持的WebView加载HTML内容，实现完整多行滚动体验，兼容绝大多数Android版本。

布局实现 #

<WebView
    android:id="@+id/widget_webview"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:scrollbars="vertical"
    android:padding="8dp"/>

代码加载HTML文本 #

将长文本转换为HTML格式，加载到WebView中：

RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.widget_layout);
// 将换行符替换为HTML换行标签，保留格式
String formattedText = longText.replace("\n", "<br/>");
String htmlContent = String.format(
    "<html><body style='font-size:16px; color:#333;'>%s</body></html>",
    formattedText
);
// 加载HTML内容
views.loadUrl("data:text/html;charset=utf-8," + Uri.encode(htmlContent));

appWidgetManager.updateAppWidget(appWidgetId, views);

注意：部分ROM可能限制小部件使用WebView，需测试兼容性；同时需注意WebView的性能消耗，避免文本过大导致卡顿。

4. Android 12+ 原生方案：使用RecyclerView #

Android 12（API 31）及以上版本的RemoteView支持RecyclerView，可实现原生多行滚动列表体验。

布局实现 #

<androidx.recyclerview.widget.RecyclerView
    android:id="@+id/widget_recycler"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

实现RemoteViewsService #

创建服务提供RecyclerView的数据源：

public class WidgetRecyclerService extends RemoteViewsService {
    @Override
    public RemoteViewsFactory onGetViewFactory(Intent intent) {
        return new WidgetRecyclerFactory(getApplicationContext(), intent);
    }

    class WidgetRecyclerFactory implements RemoteViewsFactory {
        private final Context mContext;
        private List<String> mTextItems;

        public WidgetRecyclerFactory(Context context, Intent intent) {
            mContext = context;
            // 拆分长文本为列表项
            mTextItems = splitLongTextIntoItems(longText);
        }

        @Override
        public void onCreate() {}

        @Override
        public void onDataSetChanged() {}

        @Override
        public void onDestroy() {}

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

        @Override
        public RemoteViews getViewAt(int position) {
            RemoteViews itemView = new RemoteViews(mContext.getPackageName(), R.layout.recycler_item);
            itemView.setTextViewText(R.id.item_text, mTextItems.get(position));
            return itemView;
        }

        @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; }
    }
}

在AppWidgetProvider中绑定服务 #

RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.widget_layout);
Intent serviceIntent = new Intent(context, WidgetRecyclerService.class);
serviceIntent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
// 设置RecyclerView的远程适配器
views.setRemoteAdapter(R.id.widget_recycler, serviceIntent);

appWidgetManager.updateAppWidget(appWidgetId, views);

内容的提问来源于stack exchange，提问作者Gunter