11

我想感谢我们在(商业)应用程序中使用的所有开源库。我想在我们的关于对话框中显示一个 HTML 页面。我们的构建过程使用 ant,第三方库在 svn 中提交。

您认为生成 HTML 页面的最佳方式是什么?

  • 对 HTML 页面进行硬编码?
  • 将依赖管理切换到 apache-ivy 并编写一些 ant 任务来生成 html
  • 使用 maven-ant-tasks 并编写一些 ant 任务来生成 HTML
  • 仅使用 maven 处理依赖项和 HTML 一次,下载并提交它们。其余的由未更改的 ant-scripts 完成
  • 切换到 maven2 (嘿老板,我想切换到 maven,在 1 个月内构建可能会再次工作......)
  • ...

关于对话框应该显示哪些元素?

  • 图书馆名称
  • 版本
  • 执照
  • 作者
  • 主页
  • 使用指向源存档的链接所做的更改
  • ...

有一些最佳实践建议吗?一些好的例子(应用程序有一个很好的关于对话框显示依赖关系)?

4

3 回答 3

3

蚂蚁任务似乎是最好的方法。我们在我们的一个项目中做了类似的事情。所有开源库都存在于指定的文件夹中。Ant 任务读取这些库、版本等的清单并生成一个 HTML,将其复制到另一个指定的文件夹中,Web 容器从该文件夹中获取它。

于 2008-11-10T14:24:54.970 回答
3

您需要考虑两件不同的事情。

首先,您可能需要识别第三方代码的许可证。这通常与 THIRDPARTYLICENSE 文件有关。Sun Microsystems 经常这样做。例如,查看 OpenOffice.org 的安装目录。有此类文件的 .txt 和 .html 版本的示例。

其次,您可能希望在“关于”框中以简短的方式标识您的依赖项(也请参阅许可证信息文件)。我会确保版本出现在“关于”框中。人们想要快速检查的一件事是指示他们拥有的代码副本是否需要替换或更新,因为您的库依赖项之一具有最近披露的错误或安全漏洞。

因此,我想您希望在“关于”框中包含的另一件事是人们可以找到您的支持站点以及对特定版本用户的任何重要通知(无论您的应用程序中是否有用于检查的规定-更新行)。

于 2008-11-10T19:31:52.133 回答
2

如果库不会经常更改,那么在每次构建时生成页面将是一种浪费。库版本可能会更改,但实际库不会更改。更容易地创建一个 HTML 页面将是最简单的方法,但这是另一个维护头疼的问题。生成一次并将其包含在包中。如果对库进行了一些更改(更新版本、添加新库),该脚本总是可以再次运行。

于 2008-11-10T15:40:00.137 回答