Setting Up ZK Charts"
Raymondchao (talk | contribs) |
|||
Line 77: | Line 77: | ||
<servers> | <servers> | ||
<server> | <server> | ||
− | <id>ZK EE</id><!-- Same as the repository name used in your pom.xml --> | + | <id>ZK EE</id> |
− | <!-- Please replace the following with your premium username and password --> | + | <!-- Same as the repository name used in your pom.xml --> |
+ | <!-- Please replace the following with | ||
+ | your premium username and password --> | ||
<username>your account</username> | <username>your account</username> | ||
<password>your password</password> | <password>your password</password> | ||
Line 88: | Line 90: | ||
*Sample of pom.xml for using licensed ZK Charts | *Sample of pom.xml for using licensed ZK Charts | ||
<source lang="xml"> | <source lang="xml"> | ||
− | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" | + | <project xmlns="http://maven.apache.org/POM/4.0.0" |
− | xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> | + | xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" |
+ | xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 | ||
+ | http://maven.apache.org/xsd/maven-4.0.0.xsd"> | ||
<modelVersion>4.0.0</modelVersion> | <modelVersion>4.0.0</modelVersion> | ||
<groupId>zkcharts</groupId> | <groupId>zkcharts</groupId> |
Revision as of 07:09, 9 May 2014
Prerequisites
Installing the Libraries
Depending on your IDE the steps will differ, however the most important part is to include both ZK Charts and ZK’s JAR files in your project. The project should be a ZK Project or a Web Application Project depending on what environment you are using. Then, place the charts jar under WEB-INF/lib folder.
The easiest way to create a compatible project is to use ZK Studio and then include charts.jar as a library
Maven Project
If your project is managed by Maven already, you can adopt ZK Charts easily by simply adding a dependency like the following [1]:
1 <dependency>
2 <groupId>org.zkoss.chart</groupId>
3 <artifactId>zkcharts</artifactId>
4 <version>1.0.0</version>
5 </dependency>
Evaluating users (60-days free evaluation)
Note: ZK Charts evaluation version is put in ZK PE-eval / EE- eval maven repository. Please add the following config if you want to try the evaluation version.
1 <repositories>
2 <repository>
3 <id>ZK PE/EE Evaluation</id>
4 <url>http://mavensync.zkoss.org/eval/</url>
5 </repository>
6 </repositories>
- ↑ If you didn't setup zk maven repository yet, you have to setup zk maven repository as well.
Premium users only
- Notice: Need Login authentication
- If you are our customer, please apply for a premium maven account to use ZK Premium Maven Repository.
<repositories>
<repository>
<id>ZK EE</id>
<url>https://maven.zkoss.org/repo/zk/ee</url>
</repository>
</repositories>
- Login authentication
Please refer to the official documentation of Apache Maven project for storing login authentication credential in the global settings file.
- Location (if not already existed, you can create it manually)
- Maven installation root: $M2_HOME/conf/settings.xml - OR -
- User's Maven root: ${user.home}/.m2/settings.xml
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
http://maven.apache.org/xsd/settings-1.0.0.xsd">
<servers>
<server>
<id>ZK EE</id>
<!-- Same as the repository name used in your pom.xml -->
<!-- Please replace the following with
your premium username and password -->
<username>your account</username>
<password>your password</password>
</server>
</servers>
</settings>
- Sample of pom.xml for using licensed ZK Charts
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>zkcharts</groupId>
<artifactId>sample</artifactId>
<version>0.0.1-SNAPSHOT</version>
<properties>
<!-- please change the version accordingly -->
<zk.version>6.5.2</zk.version>
<commons-io>1.3.1</commons-io>
</properties>
<packaging>war</packaging>
<name>The sample Project</name>
<repositories>
<repository>
<id>ZK CE</id>
<name>ZK CE Repository</name>
<url>http://mavensync.zkoss.org/maven2</url>
</repository>
<repository>
<id>ZK EE</id>
<url>https://maven.zkoss.org/repo/zk/ee</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>org.zkoss.zk</groupId>
<artifactId>zkbind</artifactId>
<version>${zk.version}</version>
</dependency>
<dependency>
<groupId>org.zkoss.zk</groupId>
<artifactId>zul</artifactId>
<version>${zk.version}</version>
</dependency>
<dependency>
<groupId>org.zkoss.zk</groupId>
<artifactId>zkplus</artifactId>
<version>${zk.version}</version>
</dependency>
<dependency>
<groupId>org.zkoss.zk</groupId>
<artifactId>zhtml</artifactId>
<version>${zk.version}</version>
</dependency>
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>${commons-io}</version>
</dependency>
<!-- ZK Charts -->
<dependency>
<groupId>org.zkoss.chart</groupId>
<artifactId>zkcharts</artifactId>
<version>1.0.0</version>
</dependency>
</dependencies>
</project>
< Get Complete Source Code of This Book >