Vaadin 库概述

Vaadin 带有很多 JAR 库文件, 有些库文件是可选的, 有些是可以相互替代的, 具体情况取决于你开发的是服务器端还是客户端应用程序, 取决于你是否使用了 add-on 组件, 也取决于你使用 CSS 还是 Sass 的 theme.

vaadin-server-7.x.x.jar

这是用于开发服务器端 Vaadin 应用程序的主要库文件. 这个库文件依赖于 vaadin-shared 和 vaadin-themes 库文件. 如果你没有用到 add-on 组件和定制化 widget 的话, 一般来说你可以使用预编译的 vaadin-client-compiled 进行服务器端开发.

vaadin-shared-7.x.x.jar

服务器端开发与客户端开发使用到的共通库文件. 一般来说这个库文件总是需要的.

vaadin-client-7.x.x.jar

客户端 Vaadin 框架, 包含基本的 GWT API 和 Vaadin 独有的 widget, 以及其他附加内容. 当使用vaadin-client-compiler 编译客户端模块时, 需要用到这个库文件. 如果你的开发中只使用到服务器端框架和预编译的客户端引擎, 那么这个库文件就是不必用到的. 这个库文件不应该随 Web 应用程序一起发布到运行环境.

vaadin-client-compiler-7.x.x.jar

Vaadin 客户端编译器是一个从 Java 到 JavaScript 的编译器, 可用于创建客户端模块, 如服务器应用程序所需要的客户端引擎(widget 群). 编译器的应用场合, 举例来说, 可以将 add-on 组件编译为应用程序的 widget 群.. 注意, 这个库不应该随 Web 应用程序一起发布到运行环境.

vaadin-client-compiled-7.x.x.jar

这个库是预编译的 Vaadin 客户端引擎(widget 群), 包含Vaadin 内建的基本的 widget. 如果你使用 Vaadin 客户端编译器来编译应用程序的 widget 群, 那么这个库是不必用到的.

vaadin-themes-7.x.x.jar

这个库是 Vaadin 的内建 theme, 包含 SCSS 源文件, 以及预编译的 CSS 文件. 不论是使用基本的 CSS theme , 还是编译 Sass theme, 都需要使用这个库.

vaadin-sass-compiler-1.x.x.jar

Vaadin Sass 编译器负责将 Sass theme 编译为 CSS. 这个库文件依赖于 vaadin-themes-7.x.x.jar, 其中包含 Vaadin 内建 theme 的 Sass 源文件. 在开发模式下, 为了能够实时编译 theme, 需要将这个库文件包含在发布内容中, 但在生产环境下, 发布之前会预编译 theme , 因此应用程序发布时不需要包含这个库文件.

以上各个库文件, 有些会有相互依赖, 而且它们还依赖于安装包的 lib 文件夹内提供的其他库文件, 尤其是lib/vaadin-shared-deps.jar.

库文件的几种安装方法将在后续章节中详细介绍.

注意, vaadin-client-compiler 和 vaadin-client 库文件不应该与 Web 应用程序一起发布, 因此不要把它们放在 Web 应用程序的 WEB-INF/lib 文件夹下. 其他某些库, 比如 vaadin-sass-compiler, 只在开发环境下需要, 在生产环境下发布时也是不需要的.