构建Xamarin Android AAR绑定库时出现BINDINGSGENERATOR语法错误

报错原因 #

这个BINDINGSGENERATOR语法错误是Xamarin绑定生成器解析GeckoView的javadoc注释时触发的：GeckoView的javadoc中使用了大量自定义标签、非标准HTML语法，旧版本的Xamarin绑定工具链无法识别这类内容，会直接抛出解析错误。

可用解决方法 #

快速解决（无需修改文件）

直接修改geckoview-nightly-xxx-javadoc.jar的生成操作属性，从JavaDocJar改为「无」，跳过javadoc解析流程即可。
跳过javadoc解析不会影响绑定库的正常功能，仅会导致生成的C#接口没有配套的注释说明，不影响运行时调用。

需要保留注释的解决方法

1. 解压javadoc.jar包，根据报错提示的行号找到对应存在语法问题的注释文件
2. 删除Xamarin生成器不识别的自定义标签，或者将特殊内容用{@literal}标签包裹转义
3. 重新打包为jar文件替换项目中原文件，再重新生成解决方案即可

规避同类问题的优化方案

你当前使用的Xamarin.Android SDK版本较低，高版本的绑定工具链对javadoc的兼容能力有明显优化，可以升级Visual Studio到最新正式版，或者迁移到.NET 6+的Android绑定项目后重试，也能解决大部分解析错误。
如果后续生成时出现类名冲突、方法签名不匹配的报错，可以在项目Transforms目录下的Metadata.xml中添加对应节点的移除、重命名规则，适配GeckoView的特殊接口定义即可。

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