Android编译mergeDebugResources报Illegal char <:>错误如何解决

• 核心触发点是第三方老旧控件库与新版Android Gradle插件（AGP）资源编译逻辑不兼容。你布局中使用的info.hoang8f.widget.FButton是停止维护多年的老旧控件，它自带的资源文件使用了非标准的命名空间别名写法（也就是你看到的ns1、ns2形式的命名空间声明），新版AGP的资源合并编译器在处理合并后的资源路径时，会将这类异常命名空间标识误识别为路径中的非法冒号字符，直接抛出Illegal char <:>的路径错误。
• 你本地values.xml文件上的命名空间标红不是你手写代码的问题，是IDE索引依赖资源时，被第三方库的异常资源写法带出的连带报错，删除本地文件的命名空间声明自然会触发更多语法错误。
• 配置android.enableJetifier=true后能编译成功，是因为Jetifier会自动将旧版支持库依赖改写为AndroidX依赖，但这个FButton库版本过老，Jetifier无法完全正确改写它的资源和类引用，会出现资源ID错位、类找不到的问题，直接导致应用启动闪退。

按修复彻底程度从高到低排序：

• 最优方案：替换过时的FButton依赖
  直接移除build.gradle中引入的hoang8f:fbutton依赖，这个库已经停更多年，完全没有适配新版AGP和AndroidX，后续还会触发其他兼容问题。你用到的圆角、阴影、自定义按钮色这些功能，Android官方Material库的MaterialButton原生支持，不需要第三方控件：
  1. 确认项目已引入Material依赖（新建AndroidX项目默认自带，没有的话加在app模块的build.gradle中）：

     implementation 'com.google.android.material:material:1.9.0' // 版本匹配当前项目的compileSdk即可
     

  2. 将布局中两个info.hoang8f.widget.FButton标签替换为com.google.android.material.button.MaterialButton，原有cornerRadius、shadowColor、shadowEnabled、buttonColor这些属性不需要修改，MaterialButton原生支持同名属性。
  3. 同步Gradle后重新构建，资源合并报错会直接消失，也不会出现启动闪退问题。
• 临时兼容方案：如果暂时不想替换控件
  1. 将AGP版本降级到7.2.x及以下（对应匹配的Gradle版本为7.3.3），老版本AGP的资源编译器对旧版非标准命名空间写法兼容性更好，不会触发非法路径报错。
  2. 配对开启android.useAndroidX=true和android.enableJetifier=true配置，在项目res/values目录下新建资源文件，手动重新声明FButton中报错的animateCircleAngleTo等attr属性，覆盖依赖中的异常资源文件，避免资源合并时拉取带错误命名空间的依赖资源。
  3. 补充FButton对应的混淆规则，避免安装后出现类找不到的闪退。
• 验证排查方案：先执行./gradlew clean命令清理所有构建缓存，删除项目根目录下的.gradle缓存文件夹后重新同步项目，排除构建缓存损坏导致的偶发资源合并错误——但这个方案只能解决缓存问题，无法处理你当前遇到的依赖版本不兼容的必现错误。

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