7

由于 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上查看此问题的更新版本

4

1 回答 1

1

我写了一个基于 ApexDoc 的工具。这里有一个简短的文章,带有指向 JAR 文件和 GitHub 项目的链接。如果您发现问题,请在我的博客上给我留言。

于 2013-09-01T13:00:41.960 回答