Question

使用ASDoc为我的Flex项目（使用Flash Builder 4.6构建）生成文档时出错：

[Fatal Error] toplevel.xml:3061:11: Element type "gmail.com" must be followed by either attribute specifications, ">" or "/>".
org.xml.sax.SAXParseException; systemId: path/to/toplevel.xml; lineNumber: 3061; columnNumber: 11; Element type "gmail.com" must be followed by either attribute specifications, ">" or "/>".
    at org.apache.xerces.parsers.DOMParser.parse(Unknown Source)
    at org.apache.xerces.jaxp.DocumentBuilderImpl.parse(Unknown Source)
    at javax.xml.parsers.DocumentBuilder.parse(DocumentBuilder.java:205)
    at flex2.compiler.asdoc.AsDocHelper.createTopLevelClasses(AsDocHelper.java:66)
    at flex2.compiler.asdoc.AsDocAPI.createTopLevelClassesXML(AsDocAPI.java:401)
    at flex2.tools.ASDoc.asdoc(ASDoc.java:94)
    at flex2.tools.ASDoc.main(ASDoc.java:35)
Error: Could not create toplevel.xml: Element type "gmail.com" must be followed by either attribute specifications, ">" or "/>".

它似乎正在尝试在文档中使用我的电子邮件地址，而这是行不通的。我在ASDoc模板目录中找不到与此相关的任何内容，我不知道ASDoc如何知道我的电子邮件地址。顺便说一句，抛出错误后，文件toplevel.xml不可用于检查。

Answer 1

ASDoc生成器给出的错误消息非常误导。发生了什么事在你的评论中，你有一个“非法”的角色。

因为它告诉你错误消息与gmail.com有关，所以我猜这个非法字符是at符号（@）。由于ASDoc生成器没有告诉您哪一行甚至哪个类都包含无效字符，因此您需要深入了解项目中的每个类，直到在ASDoc注释中的某处找到@gmail.com。

找到后，将@字符替换为@，或完全删除违规行。

有关详细信息，请参阅StackOverflow: Include @ in ASDoc comments without any errors?

ASDoc致命错误

1 个答案: