Main Page
Cookbook/Overview ImageMeister the jcprops file Licensing Please Vote! Binary Installation & Configuration [ Win · Mac · Nix · OSX ] Changes Public API Source Code Main Page Java [ Common · Win · Mac · Nix ] Native Code [ Common · Win · Mac · Nix ] Manifest Native Code Overviews [ Common · Win · Mac · Nix · Strings ] Macros [ General · Native Macros ] Walkthroughs [ Java only · Java and native ] Building [ Win · Mac · Nix · OSX ] Distribution Issues |
This version has been tested on a RedHat 6.1 Linux system using the www.blackdown.org JDK1.1.8v1 and JRE1.2.2rc4, and the IBM JRE1.1.8.On x86 Linux systems, JConfig will use native code to provide some functionality. On all other Unix systems, JConfig does not yet use native code, just Java.
The shared library 'libjconfiglx0.so' contains the Linux native code. If you're running on Linux, and you have problems related to this library, please post the details to the JConfig Support Forums (see readme.html for the URL). You can remove this library from your LD_LIBRARY_PATH, and JConfig will use the all-Java Unix version of its code.
Only some of the file methods have been implemented so far. This means that ImageMeister and the DiskBrowser sample should generally work. However, some of the functionality illustrated by the Tester sample app is not yet implemented.
A minimal implementation of the FileRegistry.launchURL() method is provided; a future Linux version will provide a more robust implementation.
No special installation is required. It is highly recommended that you
unzip the distribution file into /home/jconfig
. That way, the .sh files might
only require minimal editing.
The ImageMeister application is run using the shell scriptimrun.sh
, which is in the 'imeister' folder. To run ImageMeister, you may need to edit the first few lines of this file to reflect your setup, as described in the next section.For more information on ImageMeister, see imagemeister.html.
Two shell scripts are provided:jconfig/browse.sh - runs the DiskBrowser sample app imeister/imrun.sh - runs the ImageMeister applicationYou'll need to modify these files to match your own setup.
In addition to DiskBrowser, three other samples are provided.
Run these in a similar fashion to running DiskBrowser. See the comments in these files for more information.
com.tolstoy.testjc.FileAttributesTest
: Lets you view and set the attributes for files and folders.com.tolstoy.testjc.TestResFork
: shows how to copy a Mac file's data and resource forks to a new file. Copying the file's attributes is left as an exercise.com.tolstoy.testjc.MakeLink
: shows how to create a Windows shortcut, but could be adapted for the Mac.
Linux
You need to make sure that JConfig.zip is in the classpath, and that 'libjconfiglx0.so' is in the LD_LIBRARY_PATH. Both of these items are in the 'common' directory. For instance, using the blackdown.org JDK1.1.8v1:export SAMHOME=/home/jconfig/samizdat export JAVA_HOME=/usr/local/jdk118 export DISPLAY=:0 export PATH=$SAMHOME/common/:$JAVA_HOME/bin:$PATH export LD_LIBRARY_PATH=$SAMHOME/common:$LD_LIBRARY_PATH export CLASSPATH=.:$SAMHOME/common/JConfig.zip:$JAVA_HOME/lib/classes.zip java com.jconfig.DiskBrowserUnix
On Unix systems other than Linux, JConfig does not yet use native code, making this easier than Mac and Windows. Just make sure that JConfig.zip is in the classpath. You can use a modified version of the script given above.
Currently, the icons for disk objects are displayed using a set of bitmap files. This will change in future versions. If you want to replace the icons with your own, note that the icons ending in 'l' (for large) must be 32 by 32 pixels, and those ending in 's' (for small) must be 16 by 16 pixels. All these must be 8-bit, uncompressed Windows .bmp files.
JConfig determines that it is running on a non-Linux Unix system by checking that "/", "/usr", and "/etc" exist, and are directories. This is not optimal, because these paths may not exist on all Unix systems, and also because it would be possible to setup a Mac with these same paths.
If you have any problems running this on a Unix system, please post a message to the JConfig Support Forums.