Android Studio中Flutter应用无法运行，gradle报错及shared_preference_android求助

什么是shared_preference_android？ #

它是Flutter官方插件shared_preferences的Android平台专属实现包。shared_preferences是用来在跨平台Flutter应用中存储轻量级键值对数据的插件，而shared_preference_android专门负责在Android设备上完成实际的存储逻辑，是依赖shared_preferences时自动引入的底层依赖包。

解决Gradle报错的步骤 #

• 先执行标准清理命令：在项目根目录运行flutter clean，接着运行flutter pub get，这比手动删除build文件夹更彻底。
• 检查pubspec.yaml中shared_preferences的版本，若版本过旧或和当前Flutter SDK不兼容，建议指定一个稳定版本（可查看pub.dev上的最新稳定版），或者执行flutter pub upgrade shared_preferences更新到兼容版本。
• 清理Gradle全局缓存：删除用户目录下的.gradle/caches文件夹（Windows路径：C:\Users\<你的用户名>\.gradle\caches；Mac/Linux路径：~/.gradle/caches），同时删除项目内android/build文件夹。
• 重新同步Gradle：在Android Studio中点击顶部菜单栏File -> Sync Project with Gradle Files，或者在项目根目录执行cd android && ./gradlew clean（Mac/Linux），Windows则执行cd android && gradlew clean，完成后回到根目录运行flutter run。
• 若仍未解决，检查Gradle版本兼容性：在android/build.gradle文件中，确保com.android.tools.build:gradle的版本和Flutter SDK匹配（比如Flutter 3.10+建议用gradle插件7.4+），同时在android/gradle/wrapper/gradle-wrapper.properties中对应修改distributionUrl的Gradle版本号。
• 国内用户可尝试切换Maven镜像：在android/build.gradle的repositories块中添加阿里云镜像：

  maven { url 'https://maven.aliyun.com/repository/google' }
  maven { url 'https://maven.aliyun.com/repository/jcenter' }
  maven { url 'https://maven.aliyun.com/nexus/content/groups/public' }
  

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