home *** CD-ROM | disk | FTP | other *** search
/ Java 1.2 How-To / JavaHowTo.iso / 3rdParty / Jtoexe / readme.txt < prev    next >
Encoding:
Text File  |  1998-09-25  |  3.9 KB  |  134 lines
  1. =======================================
  2.            JToExe(TM) V1.0
  3. =======================================
  4.  
  5. Introduction
  6. ============
  7. JToExe packages Java applications into 
  8. Windows executables. It relies on a 
  9. primary class containing the function 
  10. main (String args []). This eliminates
  11. the use of a batch file and makes your 
  12. Java application more professionally 
  13. polished. The JToExe application 
  14. consists of six tab panels, which 
  15. contain the options to be passed 
  16. through to the jre executable. 
  17.  
  18. There are two possible runtime 
  19. scenarios for your application. The 
  20. first is bundling and shipping your 
  21. application with Java Runtime
  22. Environment or JRE. The second a 
  23. specific Java environment exists on the
  24. target machine so you want JToExe to
  25. co-exist with other Java applications.
  26.  
  27. In the first example, you will want to
  28. use relative paths. Your application 
  29. can be moved from directory to 
  30. directory or even from machine to 
  31. machine even if Java is installed on 
  32. the target machine. This option is 
  33. also ideal if you want to install your 
  34. application on a CD-ROM and you are 
  35. not certain what drive will be assigned 
  36. to the CD-ROM.
  37.  
  38. In the second example, the paths to the
  39. Java binaries are known. The paths are
  40. hard coded. The advantage to using this
  41. method is that you will save some disk
  42. space (~2.5MB/application for the JRE
  43. and additional 2MB in case you are 
  44. using Swing). You won't have duplicate 
  45. environments. You can still move the 
  46. application around on your local 
  47. machine as long as your Java 
  48. environment doesn't change.
  49.  
  50. Installation
  51. ============
  52. There are two versions of JToExe to 
  53. download. 
  54.  
  55. 1.) One version including the JToExe 
  56. files, the Java Runtime Environment (JRE)
  57. and Swing (zip with ~5MB). 
  58.  
  59. 2.) One version, which assumes that both,
  60. JRE 1.1 and Swing are already installed 
  61. on the machine. Sun provides Swing as 
  62. zip-file. For that you need to add it 
  63. to the classpath after installation by
  64. hand. JToExe just uses the library 
  65. "swingall.jar"
  66.  
  67. In both cases it should suffice to just
  68. extract the files to a directory of 
  69. your choice and double click on 
  70. "JToExe.exe". JToExe was tested with 
  71. JRE-1.1.6 and Swing-1.0.3. It is 
  72. recommended to have the newest versions
  73. of both, though JToExe should work 
  74. properly with all JRE-1.1.x and 
  75. Swing-1.0.x versions.
  76.  
  77. If you want to download JRE, JDK or 
  78. Swing or need any additional 
  79. information about Java visit 
  80. http://java.sun.com
  81.  
  82. Known Problems:
  83. ===============
  84.  
  85. PATH
  86. ----
  87. If a version of Java is installed on
  88. your machine, Java will use that 
  89. version no matter which of both 
  90. versions you have installed. The reason
  91. for that is, that Java looks up the 
  92. registry key:
  93.  
  94. HKEY_LOCAL_MACHINE\Software\JavaSoft\Java Runtime Environment\1.1\JavaHome
  95. or 
  96. HKEY_LOCAL_MACHINE\Software\JavaSoft\Java Development Kit\1.1\JavaHome
  97.  
  98. In case the JRE or JDK was just erased 
  99. or not de-installed correctly, Java 
  100. will still search for jre.exe in that 
  101. path. IN THAT CASE JAVA WILL EXIT 
  102. WITHOUT NOTICE. If that happens you 
  103. need to reinstall JRE (or JDK). The 
  104. decision to use the Windows Registry 
  105. to locate the binaries was not a very 
  106. lucky one though.
  107.  
  108.  
  109. CLASSPATH
  110. ---------
  111. Java will first search the paths stated
  112. in the classpath environment variable,
  113. than the paths indicated in JToExe 
  114. (Classpath Tab). If an old version of 
  115. rt.jar (Java Runtime) or swingall.jar
  116. (Swing Runtime) is in the path, it will
  117. be used.
  118. ATTENTION:
  119. JToExe needs rt.jar and swingall.jar to run. 
  120. If you Swing and Jre is allready installed on 
  121. your machine you have to take care, that rt.jar 
  122. and swingall.jar is in the classpath as 
  123. JRE does NOT set the classpath for rt.jar and
  124. SWING does NOT set the classpath for swingall.jar!
  125.  
  126.  
  127. Feedback
  128. ========
  129. For commercial question please contact: 
  130. simpson@bravozulu.com
  131.  
  132. For technical questions please contact:
  133. gass@magnet.at
  134.