Flutter项目自定义Android小部件遇类未找到错误求助

我是Flutter新手，尝试在Flutter项目中创建自定义Android小部件，选择小部件时遇到错误：

java.lang.RuntimeException: Unable to instantiate receiver com.example.flutter_ure.ClockWidget

已完成以下检查：

• 创建了继承自AppWidgetProvider的ClockWidget类，路径为android/app/src/main/java/com/example/flutter_ure/ClockWidget.java
• 在AndroidManifest.xml中配置接收器如下：

<receiver
    android:name="com.example.flutter_ure.ClockWidget"
    android:label="Clock"
    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/widget_clock" />
</receiver>

• 确认AndroidManifest.xml中的包名与Flutter项目一致（com.example.flutter_ure）
• ClockWidget.java中已正确导入com.example.flutter_ure.R类

但错误仍存在，无法正常使用自定义小部件，请问问题出在哪？如何解决？

结合项目内容，排查出几个核心问题及对应解决办法：

1. 确保ClockWidget类存在无参构造函数
   Android系统实例化AppWidgetProvider子类时，依赖无参构造函数。如果你的ClockWidget类定义了带参数的构造函数但未保留无参构造，会直接导致实例化失败。添加无参构造：

public class ClockWidget extends AppWidgetProvider {
    // 必须保留的无参构造函数
    public ClockWidget() {}

    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        // 你的小部件更新逻辑
    }
}

2. 检查资源文件编译状态
   若res/xml/widget_clock.xml存在语法错误（比如标签未闭合、属性拼写错误），会导致R类生成异常，间接引发接收器实例化失败。执行以下操作：

• 执行Build > Clean Project，再执行Build > Rebuild Project
• 打开widget_clock.xml，确认所有标签格式正确，比如appwidget-provider的必填属性（minWidth、minHeight、updatePeriodMillis等）是否齐全

3. 验证类的包声明与路径一致性
   确认ClockWidget.java顶部的包声明和文件路径完全匹配：

package com.example.flutter_ure; // 必须和文件所在的包路径完全一致

如果包声明错误，即使文件位置正确，系统也无法定位到该类。

4. 排查Android模块编译配置
   检查android/build.gradle中的compileSdkVersion、targetSdkVersion是否与小部件代码兼容，避免因SDK版本不匹配导致的类加载异常。

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