Additions: Windows Vista
On Windows Vista hightened security requirements mean that some changes to the regsitry permissions are required to build XUI. Run REGEDIT and find the "HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\Java Runtime Environment" key. Right click the key and choose Permissions...
Change the permissions for the key to give yourself full control (or a setting that gives you write access). ∞
Additions: Problems with harness.dir
If you get errors mentioning the harness.dir file, make sure that you have opened the svn/xuisuite/trunk project in NetBeans. The suite ties together the various NetBeans modules and is referenced in the build of those modules. The error occurs if you have opened the individual modules without opening the suite. Problems finding the Eclipse classes
If you are building the NetBeans modules then you may encounter problems compiling if you do do place a modified version of the common.xml file in your program files/netbeans/harness folder. The modification to this file is the following:
Additions: Problems?
If you are having problems compiling, please check that you are using the correct version of the XUI jars for the Java JDK that you use.
If you manage to compile and there are classes missing you will get a ClassNotFound exception. Again check that the correct Jars are included, you can review the contents of the Jars by opening them with a tools such as WinZip.
A XUI application can be compiled either from the command-line or from within and IDE such as NetBeans or Eclipse. The main requirement for compiling a XUI application is that you have the necessary Jars in the classpath.
The choice of Jars depends upon the version of the Java compiler and JDK that you are using. XUI ships with versions of the Jars for various JDKs including 1.1.8, 1.3 and 1.5. The oldest JDK support is included so that XUI applications can run on JVMs for handheld devices such as PDA which only support JDK 1.1 features. JDK 1.3 support is provided for those who cannot use JDK 1.5 support including generics.
The XUI libraries are also compiled in two version, a debug version with lots of logging and diagnostics and a release version with the logging and diagnostics removed. XUI itself is split into a number of Jars. XuiCore.jar contains the basic classes needed by the framework and the AWT widgets, XuiCoreSwing contains the same core classes and the Swing widgets. XuiOptional contains everything else, including advanced components and utilities, including the database access components. In most cases a XUI application will use a version of the XuiCore jar and the XuiOptional jar. You application may not use all the classes in these Jars and you are free to bundle just those classes you need with your application instead of the full Jars, however be sure to read and comply with the license before doing so.
To setup the build in NetBeans you must ensure that the Jars are included in the project. The KalIDEoscope wizard automatically includes a copy of these Jars in the project's lib folder and then references these jars in project's build file. To check that the libraries are included:
Right click on the project folder and choose properties
Under the libraries section check that a version of the XuiCore and XuiOptional jars are listed on the Compile tab.
Under the Run tab, check that the project's pages, lang, and resources folders are included.
Click on the Run or Debug toolbar buttons, just press F5 to compile and run the application.