Android ListView类型桌面Widget无法填充、启动器崩溃问题排查求助

问题根因排查 #

你代码里存在几个典型的Widget列表实现错误，都是导致启动器崩溃、内容不加载的直接原因：

1. 列表项布局配置错误：widget_list_item_view.xml的根布局高度设为match_parent，会导致单个列表项直接占满整个Widget的高度，多条目渲染时触发启动器的布局异常崩溃；同时水平布局下第二个TextView设置layout_width="match_parent"会直接挤掉第三个TextView的展示空间，也会引发测量异常。
2. MyListWidgetService未在AndroidManifest.xml中声明对应权限：RemoteViewsService必须声明android.permission.BIND_REMOTEVIEWS权限，否则系统无法识别该服务，导致列表无法绑定适配器。
3. 绑定适配器的Intent未携带Widget ID：调用setRemoteAdapter时传入的Intent需要附带当前Widget的ID，避免多个Widget实例冲突。
4. getLoadingView返回null：部分启动器没有内置默认加载视图，返回null会直接触发空指针崩溃。

修正方案 #

1. 修正列表项布局widget_list_item_view.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    <!-- 把高度改成wrap_content或者固定值 -->
    android:layout_height="wrap_content"
    android:orientation="horizontal"
    android:paddingVertical="@dimen/padding">

    <TextView
        android:id="@+id/widgetItemA"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginStart="@dimen/padding" />

    <TextView
        android:id="@+id/widgetItemB"
        android:layout_width="0dp"
        android:layout_weight="1"
        android:layout_height="wrap_content"
        android:layout_marginHorizontal="@dimen/padding" />

    <TextView
        android:id="@+id/widgetItemC"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginEnd="@dimen/padding" />
</LinearLayout>

2. 修正MyWidgetProvider的onUpdate逻辑

@Override
public void onUpdate (Context context,
                      AppWidgetManager appWidgetManager,
                      int[] appWidgetIds) {
    for (int appWidgetId : appWidgetIds) {
        Log.d("LOG", "Updating widget " + appWidgetId);
        Intent intent = new Intent(context, MyListWidgetService.class);
        // 携带Widget ID
        intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
        RemoteViews rv = new RemoteViews(context.getPackageName(),
                                         R.layout.appwidget);
        rv.setRemoteAdapter(R.id.widgetListView, intent);
        // 可选：在appwidget.xml里加一个空状态TextView，id设为empty_view，配置空状态占位
        rv.setEmptyView(R.id.widgetListView, R.id.empty_view);
        
        appWidgetManager.updateAppWidget(appWidgetId, rv);
        // 通知列表数据刷新
        appWidgetManager.notifyAppWidgetViewDataChanged(appWidgetId, R.id.widgetListView);
    }
    super.onUpdate(context, appWidgetManager, appWidgetIds);
}

3. 给MyListWidgetService补全清单声明

在AndroidManifest.xml的application节点下添加：

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

4. 修正getLoadingView返回值

返回基础加载视图避免空指针：

public RemoteViews getLoadingView() {
    return new RemoteViews(mContext.getPackageName(), android.R.layout.simple_list_item_1);
}

额外调试方向 #

如果修改后还有问题，可以按以下步骤排查：

• 全局过滤系统日志的AndroidRuntime标签，启动器崩溃的异常信息不会打印在你应用的进程日志里，全局过滤才能看到完整崩溃栈
• 检查res/xml下的Widget provider配置文件，有没有正确声明minHeight、minWidth等属性，尺寸设置不合理也会导致渲染异常
• 实体机如果是小米、华为等定制ROM，检查有没有给应用开启「桌面快捷方式/Widget」相关权限，部分ROM默认禁止第三方应用的Widget显示

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