Packaging Applications

Package Single Version

ZK doesn't support to run 2 different versions in a single web application. Please be sure you package only one single version of ZK JAR into a WAR.

For example, if you include zul:9.6.0 and zkex:9.6.3, then you will see messages when starting a server:

2023-03-02 09:21:44 [INFO ] ConfigParser:116 - Ignore jar:file:/Users/yourName/.m2/repository/org/zkoss/zk/zkex/9.6.3/zkex-9.6.3.jar!/metainfo/zk/config.xml
Cause: ZK version must be 9.6.3 or later, not 9.6.0
...
Your ZK binary is being altered and may not work as expected. Please contact us at info@zkoss.org for assistance.

Package ZK As a Shared Library

This is a not-recommended practice. Since ZK stores its configurations (parsed from zk.xml) as a static object, all your zk applications in the same application server will have the same configurations. If you change a configuration (library property), it will affect all zk applications.

Package as EAR

An EAR file contains one or more JAR and WAR.