3.9.10. 关于软件组件信息

平台提供了注册应用程序中使用的第三方软件组件信息（credits）以及在 UI 中显示这些组件信息的功能。组件信息包括软件组件名称、网站链接和许可文本。

平台提供的应用程序组件包含了自己的描述文件，如 com/haulmont/cuba/credits.xml 、 com/haulmont/reports/credits.xml 等。cuba.creditsConfig应用程序属性可用于指定应用程序的描述文件。

credits.xml 文件的结构如下：

  • items 元素列出了使用的库及其许可文本，许可文本既可以在嵌入的 license 元素中声明，也可以在 license 属性中指定一个指向 licenses 文本的链接。

    可以引用在当前文件中声明的许可，也可以引用在 cuba.creditsConfig 变量中声明的任何其它文件中的许可，前提是这些文件在当前文件之前。

  • licenses 元素列出了用到的通用许可的文本（例如 LGPL）。

可以使用 com/haulmont/cuba/gui/app/core/credits/credits-frame.xml 框架（frame）显示所有第三方软件组件列表，该框架从 cuba. creditsConfig 中定义的文件加载信息。下面是在界面中嵌入这个框架的示例：

  1. <dialogMode width="500" height="400"/>
  2. <layout expand="creditsBox">
  3.   <groupBox id="creditsBox"
  4.             caption="msg://credits"
  5.             width="100%">
  6.       <frame id="credits"
  7.               src="/com/haulmont/cuba/gui/app/core/credits/credits-frame.xml"
  8.               width="100%"
  9.               height="100%"/>
  10.   </groupBox>
  11. </layout>

如果以对话框模式（WindowManager.OpenType.DIALOG）打开包含该框架的界面，则必须指定高度；否则，滚动条可能无法正常工作。请参阅上面示例中的 dialogMode 元素。