Flutter Home Widget：为所有构建变体指定统一包ID的方法

1. 把AppWidgetProvider类放在主代码集 #

将HomeWidgetExampleProvider类放到src/main/java/com/你的基础包名/目录下，不要放在debug、release或风味专属的代码目录里，确保所有构建变体都会包含这个类。

2. 固定组件的全限定类名 #

在AndroidManifest.xml注册AppWidgetProvider时，直接写基础包名+类名的全限定路径，不要用相对包名：

<receiver android:name="com.你的基础包名.HomeWidgetExampleProvider"
          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/home_widget_info" />
</receiver>

这里的基础包名对应你build.gradle里applicationId的核心部分，不管变体怎么加后缀，这个基础包名保持不变。

3. 用manifest占位符适配变体包名 #

如果你的变体通过applicationIdSuffix修改包名，在build.gradle里给所有变体设置统一的占位符，确保组件名称不受变体包名影响：

android {
    buildTypes {
        debug {
            applicationIdSuffix ".debug"
            manifestPlaceholders = [widgetProvider: "com.你的基础包名.HomeWidgetExampleProvider"]
        }
        release {
            manifestPlaceholders = [widgetProvider: "com.你的基础包名.HomeWidgetExampleProvider"]
        }
    }
    // 产品风味同理配置
    productFlavors {
        flavorA {
            applicationIdSuffix ".flavorA"
            manifestPlaceholders = [widgetProvider: "com.你的基础包名.HomeWidgetExampleProvider"]
        }
    }
}

然后在AndroidManifest.xml里替换成占位符：

<receiver android:name="${widgetProvider}"
          android:exported="true">
    <!-- 其他配置不变 -->
</receiver>

4. Flutter端指定正确的Provider名称 #

调用Home Widget方法时，传入的name参数必须和上面的全限定类名完全一致，不要用变体的包名：

await HomeWidget.updateWidget(
  name: 'com.你的基础包名.HomeWidgetExampleProvider',
  // 其他参数
);

5. 统一Widget配置资源 #

把res/xml/home_widget_info.xml和Widget布局文件放在主资源集src/main/res/下，不要给不同变体单独配置，确保所有变体共用同一套Widget ID和布局。

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