Overview

This quick start guide will describe how to:

  • Download the source code and dependent JAR files
  • Build the source code into class files and into a JAR
  • Run the example code
  • Make minor modifications to the code

See the User Guide for a detailed description of the code, how to extend it, and determining the best approach for extending FreezeDry based on your needs.

Downloading

You have several options for using FreezeDry. You can

  • Download the source code from the GitHub
  • Download the jar files containing the library, source code, and the java docs.

git

The git repo has everything you'll need to build and run the test FreezeDry code. It also contains a sample log4j XML configuration file, and the mavan pom files. For this version, I've also included the Ant build.xml file used to build the previous FreezeDry version. The Ant build.xml can be used to create a single JAR containing the dependencies, or a single JAR without the dependencies.

Downloading JAR

A JAR file contains the FreezeDry distribution.

Building Freezedry Distribution

Requirements

FreezeDry relies on features made available in Java version 7.

Building

Once downloaded, change to the distribution's directory, and type


                mvn clean install
            

Maven Dependency

FreezeDry jars are on maven central built as OSGi bundles. To use them in your code as plain jars or as bundles, add the following to maven (or similar to gradle):


                    <dependency>
                        <groupId>com.closure-sys</groupId>
                        <artifactId>freezedry</artifactId>
                        <version>x.y.z</version>
                    </dependency>
                

where x.y.z is the version number.

Testing

There are two types of tests available: unit tests and integration tests. Unit tests can be run using:


                mvn clean test
            

and integration tests, which run select tests in an OSGi container, can be run using:


                mvn clean verify
            

By default, freezedry uses Apache's felix OSGi container, but if you prefer equinox you can add the maven profile as such


                mvn clean varify -Pequinox
            

Issuing the command


                mvn clean install
            

will run both unit and integration tests (use the maven profile for equinox).

That's it.