记录Salesforce.com Apex类文件

Question

由于Salesforce.com Apex语言是"类Java",我想使用javadoc或Doxygen为我们计划在App Exchange上发布的软件包生成API文档.

我在Google Code上找到了一个ApexDoc项目,但它受到严格限制,并使用一个天真的解析器来生成HTML输出.我宁愿利用现有的Doxygen解析器和输出生成器,而不是尝试从头开始重新发明该轮.

所以,我的问题:

1)有没有人能够使用javadoc或Doxygen为他们的Apex类生成API文档？你怎么能这样做的？

2)我想知道编写一个简单的脚本从.cls Apex类文件创建一系列.java文件,添加假import语句以及可能修改某些声明以保持Doxygen满意是多么困难.关于Doxygen(或javadoc)在尝试解析Apex .cls文件时窒息的想法？

令我惊讶的是Salesforce没有提供这样的工具,或者没有为javadoc/Doxygen提供Apex解析器.他们的文档和开发人员工具非常广泛,他们有一个很棒的自动化测试设置.我没有从他们那里找到任何自动生成类的东西.

编辑:请在Salesforce Stack Exchange上查看此问题的更新版本.

Answer 1

我写了一个基于 ApexDoc 的工具。这里有一篇简短的文章，其中包含 JAR 文件和 GitHub 项目的链接。如果您发现问题，请在我的博客上留言。