You are viewing an old version (v. 8) of this page.
<< View previous version | view page history | view next version >>
This chapter contains instructions to help you get up and running quickly with ICEpdf. We start by outlining the prerequisites for a standard configuration using a Java Platform, Standard Edition, and Apache Ant to help you build the product from source.
Next we outline runtime configuration settings to best meet the needs of your application requirements and deployment environments:
- Configuration of optional modules at runtime, such as support for the Acrobat Standard Security, optimized font substitution, embedded font support, [Java Advanced Imaging (JAI) library]and [SVG support].
- Numerous configuration properties may be adjusted using pre-defined system properties to alter the behavior of ICEpdf for your application, such as cache sizes and behaviors, render quality, settings, etc.
If you would like more information on the reference implementation and example applications, refer to [Reference Implementations].
Prerequisites
ICEpdf is a standard Java 2 application, and as such, the only prerequisite to working with ICEpdf is that you must be familiar with Java 2 development. For more information on the Java Platform, Standard Edition (J2SE), refer to http://java.sun.com/javase/index.jsp.
To run the ICEpdf example and reference applications, you will need to download and install the following:
- Java 2 Platform, Standard Edition, version 1.5 or higher
- Apache Ant
The following sections provide detailed instructions for downloading the software to set up an environment where you can run the ICEpdf example and reference applications.
Java 2 Platform, Standard Edition
To run ICEpdf, ICEpdf reference implementations or examples, you will need to install a version of the Java Platform JDK, Standard Edition, version 1.5 or higher.
If you already have Java installed on your system, verify your version by typing the following on the command line:
java -version
To upgrade or install the latest release of the J2SE, visit the Sun web site:
http://java.sun.com/javase/downloads/
Installers and instructions are provided for the various systems that Sun supports. The reference and example application can run on any version of Windows, Unix, Linux, and Mac OS X capable of running J2SE version 1.5 or higher.
Ant
The ICEpdf core, reference applications and examples rely on Ant to build the source code. You will need Ant version 1.6.3 or higher for the build files provided in this ICEpdf release.
If you already have a version of Ant installed, you can verify that you have a recommended version by typing the following on the command line:
ant -version
To upgrade your current version or install a new version of Ant, visit the following location:
If you are not familiar with Ant, detailed instructions for downloading and installing Ant for your environment are available from this location: