The Content of ZK Binary Distribution"

From Documentation
m (→‎/dist/lib: Remove deprecated flag of zkplus)
 
(5 intermediate revisions by 4 users not shown)
Line 22: Line 22:
 
|-
 
|-
 
| zweb.jar
 
| zweb.jar
−
| ZK's Web library that ZK depends on  (<code>org.zkoss.web.*</code>
+
| ZK's Web library that ZK depends on  (<code>org.zkoss.web.*</code>)
 +
| LGPL
 +
| All
 +
|-
 +
| zweb-dsp.jar ('''Deprecated''')
 +
| ZK's Web library (DSP) that ZK depends on  (<code>org.zkoss.web.servlet.dsp.*</code>)
 
| LGPL
 
| LGPL
 
| All
 
| All
Line 28: Line 33:
 
| zk.jar
 
| zk.jar
 
| ZK core functions, such as ZK Loader and Update Engine. (<code>org.zkoss.zk.*</code>)
 
| ZK core functions, such as ZK Loader and Update Engine. (<code>org.zkoss.zk.*</code>)
 +
| LGPL
 +
| All
 +
|-
 +
| zkwebfragment.jar
 +
| ZK web-fragment.xml (Servlet 3.0)
 
| LGPL
 
| LGPL
 
| All
 
| All
Line 48: Line 58:
 
| zkplus.jar
 
| zkplus.jar
 
| ZK extra utilities integrated easily with other frameworks. (<code>org.zkoss.zkplus.*</code>)
 
| ZK extra utilities integrated easily with other frameworks. (<code>org.zkoss.zkplus.*</code>)
 +
| LGPL
 +
| All
 +
|-
 +
| zkplus-legacy.jar ('''Deprecated''')
 +
| ZK old databind before ZK 6. (<code>org.zkoss.zkplus.databind.*</code>)
 
| LGPL
 
| LGPL
 
| All
 
| All
Line 70: Line 85:
 
| Commercial
 
| Commercial
 
| ZK EE only
 
| ZK EE only
 +
|-
 +
| zuti.jar
 +
| Shadow elements
 +
| Commercial
 +
| ZK EE only
 +
|-
 +
| za11y.jar
 +
| ZK web accessibility (A11y) support (WCAG 2.0)
 +
| Commercial
 +
| ZK EE only
 +
|-
 
|}
 
|}
  
Line 77: Line 103:
 
</blockquote>
 
</blockquote>
  
−
====/dist/lib/zkforge====
+
====/dist/lib/theme====
−
:This directory holds the additional components and libraries. It is optional depending on whether you need them.
+
:This directory holds additional ZK themes. It is optional depending on whether you need them.
  
 
:There are three kinds of binary distributions: CE, PE and EE. If not stated explicitly, it is shipped in all distributions.
 
:There are three kinds of binary distributions: CE, PE and EE. If not stated explicitly, it is shipped in all distributions.
Line 86: Line 112:
 
! width="450" | Description  
 
! width="450" | Description  
 
! width="100" | License
 
! width="100" | License
−
! width="100" | Version
 
 
! width="120" | Shipped
 
! width="120" | Shipped
 +
|-
 +
| breeze.jar
 +
| Required if you want to use the Breeze theme.
 +
| LGPL
 +
| All
 +
|-
 +
| iceblue_c.jar
 +
| Required if you want to use the Iceblue Compact theme.
 +
| LGPL
 +
| All
 
|-
 
|-
 
| sapphire.jar
 
| sapphire.jar
−
| Required if you want to use the sapphire theme.
+
| Required if you want to use the Sapphire theme.
 
| LGPL
 
| LGPL
−
| 6.0.0
 
 
| All
 
| All
 
|-
 
|-
 
| silvertail.jar
 
| silvertail.jar
−
| Required if you want to use the silvertail theme.
+
| Required if you want to use the Silvertail theme.
 
| LGPL
 
| LGPL
−
| 6.0.0
 
 
| All
 
| All
 +
|}
 +
 +
<blockquote>
 +
----
 +
<references/>
 +
</blockquote>
 +
 +
 +
====/dist/lib/zkforge====
 +
:This directory holds the additional components and libraries. It is optional depending on whether you need them.
 +
 +
:There are three kinds of binary distributions: CE, PE and EE. If not stated explicitly, it is shipped in all distributions.
 +
 +
{| border='1px'
 +
! width="100" | Filename 
 +
! width="450" | Description
 +
! width="100" | License
 +
! width="120" | Shipped
 
|-
 
|-
−
| ckez.jar
+
| flashchart.jar
−
| Required if you want to use '''ZK CKeditor''' component.
+
| Required if you want to use '''ZK Flashchart''' component.
 
| LGPL
 
| LGPL
−
| 3.6.4.0
 
 
| All
 
| All
 +
|-
 +
| gmapsz.jar
 +
| Required if you want to use '''ZK Google Maps''' component.
 +
| GPL
 +
| ZK EE only
 
|-
 
|-
 
| timelinez.jar
 
| timelinez.jar
 
| Required if you want to use '''ZK Timeline''' component.
 
| Required if you want to use '''ZK Timeline''' component.
−
 
 
| GPL
 
| GPL
−
| 2.3.1_50
+
| ZK PE and EE only
−
|ZK PE and EE only
 
 
|-
 
|-
 
| timeplotz.jar
 
| timeplotz.jar
 
| Required if you want to use '''ZK Timeplot''' component.
 
| Required if you want to use '''ZK Timeplot''' component.
 
| GPL
 
| GPL
−
| 1.1_50
 
−
| ZK EE only
 
−
|-
 
−
| gmapsz.jar
 
−
| Required if you want to use '''ZK Google Maps''' component.
 
−
| GPL
 
−
| 3.0.1
 
 
| ZK EE only
 
| ZK EE only
 
|-
 
|-
Line 129: Line 175:
 
| Required if you want to use '''ZK JSP''' Tags.
 
| Required if you want to use '''ZK JSP''' Tags.
 
| GPL
 
| GPL
−
| 2.2
+
| ZK EE only
−
|  ZK EE only
 
 
|}
 
|}
  
 +
* ckez.jar not shipped with the binary distribution since ZK 6.5.1. You could get it from its [https://github.com/zkoss/zkckeditor/releases GitHub repository]
 
<blockquote>
 
<blockquote>
 
----
 
----
Line 147: Line 193:
 
! width="200" | Version
 
! width="200" | Version
 
! width="120" | Shipped
 
! width="120" | Shipped
 +
|-
 +
|
 +
* commons-codec.jar
 +
| Required by zweb module.
 +
| Apache
 +
| 1.8.0
 +
| All
 
|-
 
|-
 
|
 
|
Line 154: Line 207:
 
| Apache
 
| Apache
 
|
 
|
−
*Commons Fileupload 1.2.2
+
* 1.3.3
−
*Commons IO 2.1
+
* 2.4
 +
| All
 +
|-
 +
|
 +
* javassist.jar
 +
| Required by zkbind, zel, and zkmax module.
 +
| MPL / LGPL / Apache
 +
| 3.18.2.GA
 
| All
 
| All
 
|-
 
|-
 
|
 
|
 
* jcommon.jar
 
* jcommon.jar
−
* jfreechar.jar
+
* jfreechart.jar
 
| Required if you want to use ZUL's chart component.
 
| Required if you want to use ZUL's chart component.
 
| LGPL
 
| LGPL
−
|  
+
|
−
*JFreeChart 1.0.14
+
* 1.0.23
−
*JCommon 1.0.17
+
* 1.0.19
 
| ZK PE and EE only
 
| ZK PE and EE only
 +
|-
 +
|
 +
* gson.jar
 +
| Required by zkmax components (Fragment, GoldenLayout) and default JSON converter.
 +
| Apache
 +
| 2.7
 +
| All
 
|-
 
|-
 
|
 
|
 
* jasperreports.jar
 
* jasperreports.jar
 
* itext.jar
 
* itext.jar
−
* jxl.jar
+
* commons-collections4.jar
−
* poi.jar
 
−
* commons-collections.jar
 
 
* commons-logging.jar
 
* commons-logging.jar
−
* commons-digester.jar
 
 
| Required if you want to use the jasperreport component.
 
| Required if you want to use the jasperreport component.
 
| LGPL (jasperreports)
 
| LGPL (jasperreports)
−
|  
+
|
−
*Jasper Reports 4.5.1 (itext: 2.1.7, commons-collections: 3.2.1, commons-logging: 1.1.1, commons-digester: 2.1, jxl: 2.6.12, poi: 3.7)
+
* 6.14.0
−
* Note: poi.jar is required if you want to use Apache POI to generate Microsoft Excel format. And, jxl.jar is required only if you want to use JExcelApi to generate the Microsoft Excel format.
+
* 2.1.7js8
−
|ZK PE and EE only
+
* 4.4
 +
* 1.1.1
 +
| ZK PE and EE only
 
|-
 
|-
 
|
 
|
Line 187: Line 253:
 
| Required if you want scripting in Java interpreter (BeanShell).
 
| Required if you want scripting in Java interpreter (BeanShell).
 
| LGPL
 
| LGPL
−
| BeanShell 2.0b4
+
| 2.0b6
−
|All
+
| All
 
|-
 
|-
 
|
 
|
Line 194: Line 260:
 
| Required if you want to use the captcha component.
 
| Required if you want to use the captcha component.
 
| Apache
 
| Apache
−
| JH Labs Java Image Filters
+
| 2.0.235
−
|ZK PE and EE only
+
| ZK PE and EE only
 +
|-
 +
|
 +
* closure-compiler.jar
 +
| Required only if you want to use the sourcemap support while in debugging [https://tracker.zkoss.org//browse/ZK-3677 ZK-3677].
 +
'''No need for production.''' (See [https://tracker.zkoss.org/browse/ZK-4712 ZK-4712])
 +
| Apache
 +
| v20200426
 +
| All
 +
|-
 +
|
 +
* slf4j-api.jar
 +
| Required by most of the ZK modules as a logging facade.
 +
| MIT
 +
| 1.7.30
 +
| All
 +
|-
 +
|
 +
* zsoup.jar
 +
| Required by zhtml module.
 +
| MIT
 +
| 1.8.2.5
 +
| All
 
|-
 
|-
 
|}
 
|}
Line 203: Line 291:
 
===/dist/src===
 
===/dist/src===
 
This directory holds the source codes in JAR format. These JAR files are used for debugging in IDE, such as Eclipse and NetBeans. You cannot build the binary libraries from these. Rather, download and
 
This directory holds the source codes in JAR format. These JAR files are used for debugging in IDE, such as Eclipse and NetBeans. You cannot build the binary libraries from these. Rather, download and
−
uncompress zk-src-6.0.0.tar.gz.
+
uncompress zk-src-*.tar.gz.
  
 
===/dist/xsd===
 
===/dist/xsd===
Line 216: Line 304:
 
! Version !! Date !! Content
 
! Version !! Date !! Content
 
|-
 
|-
−
| &nbsp;
+
| 9.5.1
−
| &nbsp;
+
| November 2020
−
| &nbsp;
+
| [https://tracker.zkoss.org/browse/ZK-4712 ZK-4712] closure-compiler.jar in binary download package conflicts with gson.jar
 
|}
 
|}
  
 
{{ZKInstallationGuidePageFooter}}
 
{{ZKInstallationGuidePageFooter}}

Latest revision as of 04:26, 30 November 2020


DocumentationZK Installation GuideZK BackgroundThe Content of ZK Binary Distribution
The Content of ZK Binary Distribution



Directory Structure

The content of the ZK binary distribution is as follows.

/doc

This directory holds the documents including release notes and license.

/dist

/dist/lib

This directory holds the ZK libraries
Filename Description License Shipped
zcommon.jar ZK's common library that ZK depends on (org.zkoss.*) LGPL All
zweb.jar ZK's Web library that ZK depends on (org.zkoss.web.*) LGPL All
zweb-dsp.jar (Deprecated) ZK's Web library (DSP) that ZK depends on (org.zkoss.web.servlet.dsp.*) LGPL All
zk.jar ZK core functions, such as ZK Loader and Update Engine. (org.zkoss.zk.*) LGPL All
zkwebfragment.jar ZK web-fragment.xml (Servlet 3.0) LGPL All
zul.jar ZUL components (org.zkoss.zul.*) LGPL All
zhtml.jar ZK HTML (ZHTML) components (org.zkoss.zhtml.*) LGPL All
zkbind.jar ZK Bind, including data binding and MVVM. LGPL All
zkplus.jar ZK extra utilities integrated easily with other frameworks. (org.zkoss.zkplus.*) LGPL All
zkplus-legacy.jar (Deprecated) ZK old databind before ZK 6. (org.zkoss.zkplus.databind.*) LGPL All
zel.jar ZK's implementation of EL 2.2. It is based on Apache Tomcat 7's EL 2.2 implementation. Apache All
zkex.jar ZK professional ZUL components and utilities (org.zkoss.zkex.*) Commercial ZK PE and EE only
zml.jar ZK XML components for generating XML output (org.zkoss.zml.*) Commercial ZK PE and EE only
zkmax.jar ZK enterprise components and utilities (org.zkoss.*) Commercial ZK EE only
zuti.jar Shadow elements Commercial ZK EE only
za11y.jar ZK web accessibility (A11y) support (WCAG 2.0) Commercial ZK EE only

/dist/lib/theme

This directory holds additional ZK themes. It is optional depending on whether you need them.
There are three kinds of binary distributions: CE, PE and EE. If not stated explicitly, it is shipped in all distributions.
Filename Description License Shipped
breeze.jar Required if you want to use the Breeze theme. LGPL All
iceblue_c.jar Required if you want to use the Iceblue Compact theme. LGPL All
sapphire.jar Required if you want to use the Sapphire theme. LGPL All
silvertail.jar Required if you want to use the Silvertail theme. LGPL All


/dist/lib/zkforge

This directory holds the additional components and libraries. It is optional depending on whether you need them.
There are three kinds of binary distributions: CE, PE and EE. If not stated explicitly, it is shipped in all distributions.
Filename Description License Shipped
flashchart.jar Required if you want to use ZK Flashchart component. LGPL All
gmapsz.jar Required if you want to use ZK Google Maps component. GPL ZK EE only
timelinez.jar Required if you want to use ZK Timeline component. GPL ZK PE and EE only
timeplotz.jar Required if you want to use ZK Timeplot component. GPL ZK EE only
zuljsp.jar Required if you want to use ZK JSP Tags. GPL ZK EE only
  • ckez.jar not shipped with the binary distribution since ZK 6.5.1. You could get it from its GitHub repository

/dist/lib/ext

This directory holds the external libraries required to run ZK. Since these libraries are common, you might have already installed them in your Servlet container. These jar files are optional. You can choose whether to copy depending on your requirements.

Filename Description License Version Shipped
  • commons-codec.jar
 Required by zweb module. Apache 1.8.0 All
  • commons-fileupload.jar
  • commons-io.jar
 Required if you want to upload files with them. Apache
  • 1.3.3
  • 2.4
 All
  • javassist.jar
 Required by zkbind, zel, and zkmax module. MPL / LGPL / Apache 3.18.2.GA All
  • jcommon.jar
  • jfreechart.jar
 Required if you want to use ZUL's chart component. LGPL
  • 1.0.23
  • 1.0.19
 ZK PE and EE only
  • gson.jar
 Required by zkmax components (Fragment, GoldenLayout) and default JSON converter. Apache 2.7 All
  • jasperreports.jar
  • itext.jar
  • commons-collections4.jar
  • commons-logging.jar
 Required if you want to use the jasperreport component. LGPL (jasperreports)
  • 6.14.0
  • 2.1.7js8
  • 4.4
  • 1.1.1
 ZK PE and EE only
  • bsh.jar
 Required if you want scripting in Java interpreter (BeanShell). LGPL 2.0b6 All
  • Filters.jar
 Required if you want to use the captcha component. Apache 2.0.235 ZK PE and EE only
  • closure-compiler.jar
 Required only if you want to use the sourcemap support while in debugging ZK-3677.

No need for production. (See ZK-4712)

Apache v20200426 All
  • slf4j-api.jar
 Required by most of the ZK modules as a logging facade. MIT 1.7.30 All
  • zsoup.jar
 Required by zhtml module. MIT 1.8.2.5 All
  • The interpreters for Groovy (groovy.jar), Ruby (jruby.jar), Python (jython.jar), JavaScript (js.jar), MVEL (mvel.jar) and OGNL (ognl.jar) are not shipped with the binary distribution since ZK 6. You could get them from their websites, or from ZK's Git repository.

/dist/src

This directory holds the source codes in JAR format. These JAR files are used for debugging in IDE, such as Eclipse and NetBeans. You cannot build the binary libraries from these. Rather, download and uncompress zk-src-*.tar.gz.

/dist/xsd

This directory holds the XSD files that might be useful to develop ZK applications.

/dist/WEB-INF

This directory holds the sample configuration file (web.xml and portlet.xml) and the TLD files. These TLD files are part of JAR files so they are loaded automatically. We put them here mainly for your reference only.

Version History

Last Update : 2020/11/30


Version Date Content
9.5.1 November 2020 ZK-4712 closure-compiler.jar in binary download package conflicts with gson.jar



Last Update : 2020/11/30

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.


Retrieved from "https://www.zkoss.org/_w/index.php?title=ZK_Installation_Guide/ZK_Background/The_Content_of_ZK_Binary_Distribution&oldid=50878"