README PersonalJava(TM) Runtime Environment for Windows CE Version 1.0 CONTENTS -------- * Introduction * Installation * Notes - Processors Supported - Windows CE OS Version - Compatibility - Application Execution - Command Line Options - Setting the CLASSPATH - Executable JAR files - Optional Packages - License Restrictions - Sample Applications - Performance Benchmarking * Tests * System Requirements * Sun Java(TM) Web Pages * Contact Email Address INTRODUCTION ------------ Thank you for downloading this release of the PersonalJava(TM) runtime environment for Windows CE. This implementation became available in May 2000. INSTALLATION ------------ * Handheld PC / Palm PC: 1. Ensure sufficient storage (~2.5MB) is available on the target device before downloading. 2. Download the appropriate CAB file for your processor. 3. Copy the CAB file to the "Start Menu" on the target device. 4. Begin installation by selecting the file from the "Start" menu when downloaded to target device. 5. After successful installation, ensure sufficient memory is available on target device to allow applications to execute. Refer to the copyright and license for legal terms of use. * Installation Help Ensure that the entire zip file has been downloaded. The CAB file runs on the device itself once selected - no other applications are necessary. A CAB file targeted for a specific processor will not run on a device with a different processor. This implementation will not run on Windows CE 2.0. * Uninstallation of Beta 1 The uninstallation of the Beta 1 implementation will result in a warning that the following files: \Program Files\Java\Java Tests\ Welcome\Duke.gif and \Program Files\Java\README_BIN.txt are READ-ONLY and the uninstallation will not proceed. Delete the README_BIN.txt file and remove the tests directory "\Program Files\ Java\Java Tests" manually. Rerun the uninstaller and then manually remove the Java(TM) directory for a complete uninstall. NOTES ----- * Processors Supported At this time, only the MIPS (R4000 Compatible) and the SH3 processors are supported. Please check the download page and FAQ for additional processor support. You need to download and install the appropriate CAB file for your processor. * Windows CE OS Version This version is not targeted for Windows CE 2.0 and there are no plans to release a version supporting Windows CE 2.0. We investigated this platform early on and found it was missing some of the I/O functions that the PersonalJava runtime environment needed. Furthermore, we saw that the market was moving to 2.11 and that the added cost in terms of development and support would not be worth it. * Compatibility This implementation of PersonalJava runtime environment is based on JDK(TM) 1.1.x. Hence, some code written for Java 2 Platform Standard Edition may not run on this implementation. * Application Execution The PersonalJava runtime environment is executed through the file "pjava.exe". All ".class" and ".jar" files are associated with the PersonalJava runtime environment. This implementation can run standard applications, executable JAR files and applets. Standard applications and executable jar files are executed by the command line or by clicking on the class itself. Applets contained in html pages are executed though the command line. Examples are given below. * Command Line Options Along with the standard options the following options can be used on the command line on the HPC: -file Allows the user to enter a file of type ".class", ".jar", or ".html" on the command line. The PersonalJava runtime environment will execute any one of these file extensions : ".class" ".jar" (an application archived into a jar file) ".html" (a HTML page containing a Java applet) Examples: "\Program Files\Java\bin\pjava.exe" -file Test.class This command will invoke the PersonalJava runtime environment to run the application with the main method residing in the class "Test". "\Program Files\Java\bin\pjava.exe" -file Test.jar This command will invoke the PersonalJava runtime environment to run the application, which is archived in the jar file "Test". "\Program Files\Java\bin\pjava.exe" -file Test.html This command will invoke the PersonalJava appletviewer to run the applet in the html page "Test". -setcwd Allows the user to set the "current working directory" by using the "-setcwd" option on the command line. This is needed, for example, when running an applet where the "current working directory" is set to the directory where the html and applet classes reside. Example: "\Program Files\Java\bin\pjava.exe" -setcwd \Temp -file test The html page and the classes necessary for the applet are located in the directory \Temp. The standard command line options : -help print out these options -version print out the build version -v -verbose turn on verbose mode -verbosegc print a message when garbage collection occurs -noclassgc disable class garbage collection -ss set the maximum native stack size for any thread -oss set the maximum stack size for any thread -ms set the initial heap size -mx set the maximum heap size -classpath list directories in which to look for classes * Setting the CLASSPATH For the Handheld PC Pro: The classpath can be set on the command line as follows: "\Program Files\Java\pjava.exe" -classpath "\Temp\OtherClasses.jar; \Classes" -file Test The classpath is set to include the Java class files necessary for the application. Here, the OtherClasses.jar file is located in the directory \Temp and the directory \Classes is included in the classpath also. Note: The quotes are necessary. For the Palm PC: A remote registry editor is required (one comes with the MS Windows CE Toolkit for Visual C++ 6.0). Change the following: HKEY_CLASSES_ROOT Java Class File Shell Open Command "\Program Files\Java\bin\ pjava.exe" -file "%1" to "\Program Files\Java\bin\pjava.exe" -classpath "\Temp\OtherClasses.jar; \Classes" -file "%1" The classpath is set to include the Java class files necessary for the application. Here, the OtherClasses.jar file is located in the directory \Temp and the directory \Classes is included in the classpath also. * Executable JAR files The jar files manifest file requires a Main-Class header, indicating which class is the application's entry point. The executable JAR file is then started in the standard manner as with other applications. Further information on modifying the manifest file: JAR Files as Applications - 1.2 platform only http://java.sun.com/docs/books/ tutorial/jar/basics/run.html If the application is contained within one jar file, no other changes are needed. If the application is contained within more than one jar file, the classpath needs to be modified to include all the jar files required for the application (see above). * Optional Packages The following packages are fully implemented as specified in the 1.1.3 PersonalJava specification (http://java.sun.com/products/personaljava) in this version: java.awt java.io java.math java.rmi java.sql java.util.zip The optional package java.security is not implemented. Java Native Interface support is included. This implementation includes java.sql, hence JDBC(TM) API will work. * License Restrictions Please contact the feedback alias personaljava-wince@Sun.COM for further details regarding license restrictions on deployment of this implementation. * Sample Applications As this port supports most of the AWT many simple 'hello world' examples should work. Try some of the examples from the online tutorials. TESTS ----- A test directory (\Program Files\ Java\Java Tests) is included in this software bundle with a number of examples to demonstrate correct installation and operation of the PersonalJava runtime environment on the device. These tests can be accessed through the "Start Menu" under "Programs -> Java -> Java Tests" (English Locale). They include Welcome, and GUI Test. SYSTEM REQUIREMENTS ------------------- The PersonalJava runtime environment for Windows CE software is available on these platforms: * Windows CE Version 2.11 on Handheld PC / Palm PC. * Supported Processor (currently either MIPS or SH3). * 16 megabytes RAM recommended minimum - with ~6MB free to install and run the PersonalJava runtime environment. SUN JAVA WEB PAGES ------------------ For additional information, refer to these Sun Microsystems pages on the World Wide Web: http://java.sun.com/products/ personaljava/ PersonalJava Technology including the 1.1.3 PersonalJava(TM) Specification. http://java.sun.com/products/ personaljava/javacheck.html JavaCheck(TM) - Platform Compatibility Insurance for your Applications and Applets http://java.sun.com/ The Java Software web site, with the latest information on Java technology, product information, news, and features. http://java.sun.com/docs Java Platform Documentation provides access to white papers, the Java Tutorial and other documents. http://developer.java.sun.com/ The Java Developer Connection(SM) web site. (Free registration required.) Additional technical information, news, and features; user forums; support information, and much more. http://java.sun.com/products/ Java Technology Products & API CONTACT EMAIL ADDRESS --------------------- * Please send comments and feedback to: personaljava-wince@sun.com The PersonalJava(TM) Runtime Environment for Windows CE is a product of Sun Microsystems, Inc. Copyright (c) 1997-2000, Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California 94303-4900 USA. All rights reserved.