README : jHomeNet UI library Released : July 16, 2007 Version : 0.3 Written by : Dave Irwin (jhomenet at gmail dot com) _________________________________________________________________________________ OVERVIEW The jHomeNet UI library is a library that provides most of the UI functionality for the jHomeNet suite of tools including the jHomeNet server. This release is considered an alpha release of the software and as such is still under a considerable amount of development. Expect major changes in the API between this and future releases of the jHomenet server. Not all features are implemented in this release. This release also does not contain all the necessary documentation. This release was published in order to provide a preview to users of features in development. The distribution includes the following folder and files: o conf contains configuration files o docs contains documentation including the API o images contains any necessary images o lib contains all the necessary library files o logs contains any log files produced by the jHomenet server o plugins contains any jHomenet server plugins o resources contains any other resource files o src source tree In addition, the current distribution also includes an Apache Ant build file (build.xml) for building the application from the source and a Windows batch files for running the application. _________________________________________________________________________________ GENERAL INFORMATION Refer to the jHomenet Sourceforge project website (http://jhomenet.sourceforge.net/) for general information about the jHomenet suite of applications. To post a comment or a request for help, visit the following website: https://sourceforge.net/forum/?group_id=140953 To report a bug, use the bug submit form found on the Sourceforge website at the following address: https://sourceforge.net/tracker/?func=add&group_id=140953&atid=747884. _________________________________________________________________________________ RUNTIME ENVIRONMENT Several sections of the software has been developed using Sun's JDK 1.6 software development kit features. As such, it's required that Sun's latest 1.5 compatible JRE be installed to run the applications, and Sun's lastest 1.5 compatible SDK be installed to for development. Development of the current version of the jHomenet server has used JDK 1.6. In order to make use of the included build files, a copy of Apache Ant should be installed and properly configured. A copy of Ant can be freely downloaded from the following site: http://ant.apache.org/. Eclipse 3.1 was used for development along with Ant version 1.6.1. _________________________________________________________________________________ SOURCE COMPILING The project comes with an Apache Ant build.xml file for use in compiling the source. To build the Java sources, at the command line type: jhomenet-ui> ant This builds the sources and places the compiled class files in the build\classes folder. The process also copies the necessary configuration, library, and image files to the correct folder within the build\classes root directory. The current distribution does not include pre-compiled binary class files. Note that the jhomenet-ui package is dependent on the jhomenet-commons package. Any changes to the jhomenet-commons package source should result in copying the new jhomenet-commons Jar file to the jhomenet-ui library folder. Fortunately the jhomenet-server package's build.xml Ant build file includes a task that can be used to build and copy all the necessary files for all the jHomeNet packages. Refer to the jhomenet-server readme file for more information.