5 Installing Carousel
Carousel can be installed in a number of ways depending on the intended usage. At its simplest Carousel can be downloaded and used as is. At the other end of the scale Carousel requires a number of installations to access all features.
Downloading Carousel
Carousel can be downloaded from the Xoetrope website at https://xoetrope.com . To download you need to register using a valid e-mail address. Once you have successfully registered you will be sent an e-mail with directions to the download site where you can download the version of Carousel that you need.
As a registered user you will be able to download updates to Carousel on a regular basis as new features are added or enhanced. Typically a Carousel licence allows such downloads for a period of one year. Along with previous downloads we will allow access to a number of earlier versions of the software.
Carousel components
Carousel is a Java platform and therefore requires a recent Java development kit. You need to have a recent JDK (1.5) to run all the features, notably the NetBeans plug-ins. Otherwise, if you do not plan to use the editors you can use just about any JDK you like.
Table 5-1 - Carousel modules
|
|
|
|
|
Carousel can be used with just about any Java development environment. All you need do to begin working with Carousel is add the carousel.jar module to your project's classpath. To use Carousel in this way simple download the jar file and installed it somewhere that can be accessed by your development environment.
|
|
|
The Carousel editor is based on the NetBeans platform and is delivered as plug-in for the NetBeans IDE. Installation of this module is described in detail below.
|
|
|
XLintQuote is a wizard type tool for creation of quotation, sales and ordering applications.
|
|
|
This is a tool for creation and management of survey and questionnaire applications and applets. With a little imagination this module can be used for other types of questionnaires including e-learning, tests and quiz.
|
|
|
The project manager library adds a set of classes to assist in project based applications. Projects for creation of product selection, ordering, documentation and so forth can be supported by this library. The module also contains a wizard to assist in the configuration of such projects.
|
XUI components
Carousel is an extension of the open source XUI platform. Carousel includes XUI and the KalIDEoscope but it is also possible to download XUI directly from SourceForge (http://xui.sourceforge.net). On the files area you can obtain a number of variants of the XUI platform and these are described below. The files are delivered in two variants, one containing non-debug version of the class files and the second compiled with full debug information and include all logging and diagnostic features switched on:
Table 5-2 - Carousel modules
|
|
|
|
|
This Jar contains all the class files needed for core XUI development using the AWT widget set.
|
|
|
This Jar contains all the class files needed for core XUI development using the Swing widget set.
|
|
|
Extensions to the core including database bindings and more.
|
|
|
The complete set of class files and resources including the standalone (non NetBeans editor) and support for both Swing and AWT widget sets .
|
|
|
Miscellaneous resources for the standalone editor.
|
|
|
The complete source code, where is the version number.
|
The XUI Jars are compiled for a number of JDKs and accordingly have slightly different feature sets, for example only the JDK 1.5 versions feature the Synth Look and Feel as that feature was introduced as part of the Java platform with JDK 1.5. The fullest feature is the JDK 1.5 version and the version with the least features is the JDK 1.1.8 version (which runs on virtually all JVMs).
Installing NetBeans
Carousel includes a NetBeans plug-in for rapid development. Most of the features of Carousel are used and accessed via this plug-in and it is therefore most likely that you will also require a version of NetBeans. At the time of writing the target version of NetBeans is version 4.1. Java version 1.5 (JDK 1.5) is also required to run this version of Carousel
NetBeans can be downloaded from http://www.netbeans.org.
The NetBeans site also contains extensive documentation of installing and using the IDE.
Loading Carousel
Once Carousel has been downloaded. The NetBeans plug-in is delivered as a NetBeans module file with the .nbm extension. To load the module you must first start NetBeans. Once started go to the Update Center on the tools menu.
Then choose the ' Install Manually Downloaded Modules (.nbm files) ' option. Select the two NetBeans modules: kalideoscope.nbm and Carousel.nbm . The first of these is the module for the open source KalIDEoscope and the second is the module for Carousel's add-on features.
When the NetBeans module has been successfully installed the Carousel menu item will appear on the main menu.
Installing the samples
A number of samples are available on the Xoetrope website. The samples files are simple zip archives of complete projects. To begin working with the samples you can simple download the archive and unzip the archive. The samples provided with Carousel are listed below:
Table 5-3 - Sample applications
|
|
|
|
|
The classic introduction.
|
|
|
A simple example showing how to navigate within an application.
|
|
|
An example showing how translations can be setup and used.
|
|
|
A very basic calculator showing how to link in Java code to add custom logic to an application.
|
|
|
Some simple forms showing the key concepts of data binding and validation.
|
|
|
A more complete example showing how to build a working example. This example is also used as a tutorial on how to use Carousel .
|
In addition to the samples listed above the source code for the case studies included in this guide can also be downloaded. New samples are occasionally added to the website and it is probably worth checking for updates (https://xoetrope.com). The Xoetrope website also features numerous technical articles describing new and key features.
If you were logged in you could rate this article or add a comment.
;)
;)
;)