Flutter多Flavor配置下添加桌面组件遇Unresolved reference: R错误

核心原因 #

你只给单个Flavor配置桌面组件，但R类是与当前编译的Flavor绑定的——当编译未配置组件的Flavor时，对应的R类不会包含widget相关资源，直接引用就会报错；另外，Widget代码的存放位置如果未与目标Flavor绑定，也会导致跨Flavor的资源引用问题。

具体修复步骤 #

1. 将Widget代码迁移到目标Flavor专属目录 #

• 在Android项目的app/src下，创建目标Flavor对应的代码目录（比如你的Flavor叫pro，就新建src/pro/kotlin/[你的包名]/widget）
• 把MyAppWidgetProvider.kt、widget布局文件widget_layout.xml、appwidget配置文件appwidget_info.xml全部移到这个Flavor专属目录下
• 确保非目标Flavor的目录（比如src/free）里没有这些Widget相关文件

2. 修正MyAppWidgetProvider.kt的包名导入 #

检查文件顶部的包名声明，确保和目标Flavor的应用包名完全一致，避免因包名不匹配导致的R类引用错误。

3. 配置build.gradle，仅为目标Flavor注册Widget组件 #

在app/build.gradle的android块中，针对不同Flavor设置组件注册占位符：

flavorDimensions "appType"
productFlavors {
    pro {
        dimension "appType"
        applicationId "com.your.app.pro"
        // 为pro flavor配置Widget接收器信息
        manifestPlaceholders += [
            widgetReceiver: ".widget.MyAppWidgetProvider",
            enableWidget: "true"
        ]
    }
    free {
        dimension "appType"
        applicationId "com.your.app.free"
        // free flavor不注册Widget
        manifestPlaceholders += [
            widgetReceiver: "",
            enableWidget: "false"
        ]
    }
}

defaultConfig {
    // 设置默认占位符，防止编译报错
    manifestPlaceholders += [
        widgetReceiver: "",
        enableWidget: "false"
    ]
}

然后修改AndroidManifest.xml，用占位符动态注册Widget组件：

<application>
    <!-- 其他原有配置 -->
    <receiver
        android:name="${widgetReceiver}"
        android:exported="true"
        android:enabled="${enableWidget}">
        <intent-filter>
            <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
        </intent-filter>
        <meta-data
            android:name="android.appwidget.provider"
            android:resource="@xml/appwidget_info" />
    </receiver>
</application>

4. 清理后指定目标Flavor编译 #

• 执行flutter clean
• 进入Android目录执行./gradlew clean
• 用目标Flavor编译项目，比如flutter run --flavor pro

5. 检查资源文件正确性 #

确认widget_layout.xml里确实存在appwidget_text这个ID，文件名和路径没有拼写错误，避免因资源本身不存在导致的R引用问题。

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