Flutter项目使用.Android文件夹的原因及SDK更新问题咨询

一、使用隐藏式平台文件夹的原因与优势 #

• 版本管理隔离：默认的android/ios文件夹会被Git默认追踪，改成前缀带.的隐藏文件夹后，能借助.gitignore的默认规则自动排除，避免提交平台端的自动生成文件、本地调试修改或第三方依赖缓存，适合团队仅聚焦Flutter业务代码迭代的场景。
• 根目录视觉整洁：隐藏平台文件夹后，项目根目录仅展示lib、pubspec.yaml等核心业务相关文件，减少无关文件对开发注意力的干扰。
• 自定义构建流程适配：部分团队会搭建自定义Flutter构建脚本，用隐藏文件夹可与默认平台目录做环境区分，比如保留默认目录做本地调试，用隐藏目录执行正式打包或CI/CD流程。

二、改回常规文件夹后系统仍查找旧目录的解决方案 #

1. 修改项目核心配置文件 #

• 打开项目根目录的.flutter-plugins和.flutter-plugins-dependencies文件，全局替换所有.Android为android、.iOS为ios。
• 检查pubspec.yaml，若存在自定义平台目录配置（如下方示例），删除directory字段或修改为常规路径：

  flutter:
    android:
      directory: .Android
  

2. 清理缓存与构建产物 #

• 执行Flutter清理命令：

  flutter clean
  flutter pub get
  

• 手动删除项目根目录的build文件夹，以及android目录下的.gradle文件夹、ios目录下的Pods和DerivedData文件夹。

3. 更新IDE配置 #

• Android Studio/IntelliJ：打开「File > Project Structure」，检查模块路径与SDK配置是否指向新的android文件夹，执行「File > Sync Project with Gradle Files」同步配置。
• VS Code：删除.vscode/settings.json中关于平台目录的自定义配置，重启编辑器后重新加载项目。

4. 验证Flutter环境配置 #

• 执行flutter doctor检查环境配置是否正常，确保已更新到目标SDK版本。
• 确认本地无自定义Flutter环境变量指定旧平台目录路径。

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