Flutter用Flutter Launcher Icons改图标报InvalidConfigException如何修复
Flutter Launcher Icons 出现 InvalidConfigException 报错修复方法
这个报错是配置不符合工具校验规则导致的,按以下顺序排查即可解决:
- 首先检查YAML文件缩进格式
YAML语法对缩进要求非常严格,flutter_launcher_icons配置块必须和dev_dependencies、flutter配置块处于同一缩进层级,不能嵌套在其他配置块内部,所有子配置统一用2个空格缩进,绝对不能用Tab键缩进。
正确配置参考:
最高发的缩进错误是把dev_dependencies: flutter_launcher_icons: ^0.13.1 # 替换为你使用的对应版本 # 注意这一行前面没有多余空格,和上面的dev_dependencies同级 flutter_launcher_icons: android: "launcher_icon" ios: true image_path: "assets/icons/app_icon.png" # 替换为你的图标实际路径 min_sdk_android: 21flutter_launcher_icons写到flutter:块的子级,或者子配置缩进多了/少了2个空格,直接触发配置无效异常。 - 核对图标文件路径
配置里image_path填写的路径必须和项目内图标实际存放路径完全一致:- 图标要放在Flutter项目根目录的对应文件夹下,不要放到android、ios子目录内
- 路径不要以
/开头,开头加斜杠会被工具识别为系统绝对路径,直接找不到文件 - 文件名、后缀名要完全匹配,注意区分大小写,不要把
.png写成.jpg,也不要漏写文件名里的字符
- 检查配置字段拼写和值格式
不要拼错配置字段,比如不要把image_path写成imagepath、漏写下划线;布尔类型的配置值比如ios: true不要加引号,字符串类型的值注意补全引号。 - 排查完成后按顺序执行以下命令重新生成:
- 执行
flutter clean清理项目缓存 - 执行
flutter pub get重新拉取依赖 - 执行
flutter pub run flutter_launcher_icons生成图标
- 执行
如果以上步骤做完还是报错,直接把pubspec.yaml里现有的flutter_launcher_icons相关配置全部删除,手动按照参考配置重新输入,不要复制粘贴带富文本格式的内容,避免隐藏格式字符导致配置解析失败。
内容的提问来源于stack exchange,提问作者Taki Rajani
相关产品推荐
相关产品推荐

