安装pub.dev依赖配置AndroidManifest时出现FileProvider类未找到报错

核心报错根因 #

报错本质是项目未正确加载AndroidX运行环境，导致系统无法解析到androidx.core.content.FileProvider类，常见触发场景包括AndroidX开关未开启、依赖传递失效、Manifest标签书写结构错误三类。

具体操作步骤 #

• 第一步：开启项目级AndroidX开关
  打开android/gradle.properties文件，确认存在两行配置，缺失就手动补上：

  android.useAndroidX=true
  android.enableJetifier=true
  

  这两个开关是项目启用AndroidX兼容的核心配置，关闭状态下所有androidx包路径下的类都无法被系统识别。
• 第二步：显式引入FileProvider所属的依赖库
  打开android/app/build.gradle文件，在dependencies代码块内手动补上androidx.core依赖，避免第三方包依赖传递失效：

  // 可根据项目compileSdk版本匹配对应稳定版
  implementation "androidx.core:core:1.13.1"
  

• 第三步：修正AndroidManifest.xml中的Provider标签结构
  保证FileProvider的所有属性都写在<provider>标签内部，不要出现标签嵌套错误，完整的正确写法如下：

  <provider
      android:name="androidx.core.content.FileProvider"
      android:authorities="${applicationId}.com.shekarmudaliyar.social_share"
      android:exported="false"
      android:grantUriPermissions="true"
      tools:replace="android:authorities">
      <meta-data
          android:name="android.support.FILE_PROVIDER_PATHS"
          android:resource="@xml/filepaths" />
  </provider>
  

• 第四步：完成依赖同步
  依次执行以下命令清理缓存并重新加载依赖：

  flutter clean
  flutter pub get
  

  等待Gradle同步完成后重新构建项目即可。

容易踩的兼容坑 #

• 不要混用旧版support库的FileProvider和AndroidX版本的类，旧库已停止维护，和AndroidX环境共存会直接报类找不到的错误
• 保证项目compileSdk版本不低于33，过低的SDK版本会和新版androidx.core库不兼容，同样会触发类解析失败的问题

注意：meta-data中的android.support.FILE_PROVIDER_PATHS是FileProvider类硬编码的读取键名，不需要特意改成androidx前缀，改了反而会导致路径配置不生效。

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