Flutter Master通道修改插件后出现弃用API报错与构建失败问题咨询

• 第一波编译错误本质：Flutter Master通道已经正式移除两个废弃API：Theme.of的shadowThemeOnly命名参数、showDialog的child命名参数；你当前依赖的dropdown_search 0.4.4是2021年的停更老版本，还在调用这两个已被删除的API，直接触发编译失败。
• 第二波Gradle构建错误本质：本地Flutter是Master新SDK版本，但拉取的一批插件（firebase系旧版本、apple_sign_in 0.1.0、google_sign_in 4.5.5等）都是匹配Flutter 2.x甚至更早版本线的老依赖，版本不匹配导致构建链路的输出路径和Flutter工具的查找逻辑对不上，就算编译过也找不到生成的APK。

• flutter upgrade仅升级本地Flutter SDK本身，不会主动修改pubspec.yaml中写死的依赖版本号
• flutter pub get仅按照你配置的版本约束拉取符合规则的依赖，不会自动跳转到能兼容当前Master SDK的最新版本——比如你在配置里写了dropdown_search: ^0.4.4，pub get永远只会在0.4.x的版本区间拉包，不会跳到适配新SDK的2.x+版本
• 第三方插件不会反向兼容新SDK中被移除的旧API，适配新SDK的工作需要插件作者发新版本，手动修改版本号到适配版本是标准操作，不属于异常情况。

1. 解决第一波dropdown_search编译报错 #

• 把pubspec.yaml中的dropdown_search版本配置从0.4.4升级到dropdown_search: ^5.0.0，这个版本已经移除了对废弃API的调用，兼容Master通道。
• 不要直接修改全局pub-cache目录里的插件源码——该目录是全局缓存，下次执行pub get就会覆盖所有手动修改的内容，完全无效。

2. 解决第二波Gradle构建报错 #

将所有停更老版本的不兼容插件替换为当前适配Master SDK的最新稳定版本：

• 替换firebase_core: 0.5.0为firebase_core: ^2.15.0
• 替换cloud_firestore: 0.14.1+2为cloud_firestore: ^4.8.0
• 替换firebase_auth: 0.18.0+1为firebase_auth: ^4.7.0
• 替换firebase_storage: 4.0.1为firebase_storage: ^11.2.0
• 替换google_sign_in: 4.5.5为google_sign_in: ^6.1.0
• 替换停更3年的apple_sign_in: 0.1.0为官方维护的sign_in_with_apple: ^5.0.0
• 替换flutter_keyboard_visibility: 3.2.2为flutter_keyboard_visibility: ^5.1.0
• 配置修改完成后，依次执行flutter clean、flutter pub get，再重新构建项目。

3. 解决VS Code找不到pub-cache插件目录的问题 #

• 你的本地pub-cache实际路径已经在报错日志中明确标注：D:\Program Files\flutter\.pub-cache\hosted\pub.dartlang.org\
• 直接用VS Code的「打开文件夹」功能选择上述路径即可访问所有全局缓存的插件文件，不需要从项目工程内逐级跳转。
• 注意：即使能访问到缓存目录，也不推荐直接修改缓存内的插件源码，手动修改的内容会被下次pub get直接覆盖。如果遇到确实没有适配新版本的插件，正确操作是把插件源码拷贝到自己项目的本地目录下，通过本地依赖的方式引入修改，不要动全局缓存。
• 关于同事在IntelliJ中能直接跳转插件文件的原理：IntelliJ是自动建立了pub缓存目录的文件索引，不是因为插件目录在项目工程内；你在VS Code中按住Ctrl点击报错日志里的插件文件路径，IDE会自动打开对应文件，不需要手动逐级查找目录。

Master通道是Flutter的开发预览通道，会不定期移除废弃API，天生不适合依赖大量第三方插件的生产项目，如果不是必须使用Master通道的新特性，建议切换到stable稳定通道，可减少90%的这类兼容问题。

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