Mac OS Runtime For Java 2.1.4: Read Me

About Mac OS Runtime for Java 2.1.4

Mac OS Runtime for Java (MRJ) 2.1.4 is an upgrade to MRJ 2.1.3. It fixes two severe bugs that affected Java applications, but not applets.

• In some Java applications, windows would occasionally disappear or become non-functional.
• Quitting a Java application would occasionally cause another application to quit, or a file opened by another application to close. This would happen only when the second application had been launched, or the file opened, after MRJ opened a window.

This release is Bronze certified for running applications built with Oracle Developer 1.6.1 and deployed on Oracle Developer Server using Apple Applet Runner 2.1.4.

Known Issues

• Java Epoch Date: Java's internal clock calculates dates as the time since January 1, 1970. If the system clock on your Macintosh is set to an earlier date, Java applets and applications may hang or exhibit other unusual behavior. Ensure that the current date in your Date &Time Control Panel is at least 1/1/70.  

About Mac OS Runtime for Java 2.1.3

Mac OS Runtime for Java (MRJ) 2.1.3 is an upgrade to MRJ 2.1.2 that addresses several memory and applet security issues. This release is Bronze Certified for use with Oracle Developer 1.6 using Apple Applet Runner 2.1.3. For details on Oracle Bronze Certification, see http://www.apple.com/java/. This version of MRJ installs Apple Applet Runner 2.1.3, a utility for running Java applets outside of a Web browser. Apple Applet Runner is installed in the Mac OS Runtime for Java folder inside your Apple Extras folder. See "About Apple Applet Runner" for more details.
         

About Mac OS Runtime for Java 2.1.2

Mac OS Runtime for Java (MRJ) 2.1.2 is an upgrade to MRJ 2.1.1 that addresses several general Java security problems reported to us by Sun Microsystems, and fixes a number of outstanding developer issues.


About Mac OS Runtime for Java 2.1.1

Mac OS Runtime for Java (MRJ) 2.1.1 is an upgrade to MRJ 2.1 that updates JDK compatibility and addresses a number of outstanding issues from previous releases of MRJ. The major changes include:

• MRJ 2.1.1 is compliant with Sun Microsystem's Java 1.1.7 specification.
• MRJ 2.1.1 (English) can now be installed on all language versions of the Mac OS. See the note "For International Users" below for more information.
• MRJ 2.1.1 now correctly handles loading applets through a proxy server or firewall.
• Applets in the games section on Yahoo now display and work correctly.

             
           
About Mac OS Runtime for Java 2.1

Introduction

Mac OS Runtime for Java (MRJ) 2.1 is Apple's implementation of the Java Virtual Machine (JVM), based on Sun Microsystems' Java 1.1.6 specification. MRJ allows you to run Java applications and applets. (Running applets also requires a Web browser, such as Microsoft Internet Explorer, or an applet viewer such as the Apple Applet Runner.)

MRJ 2.1 makes many improvements over Apple's previous JVM, including greatly increased performance, improved reliability, and support for AppleScript and Sun's JFC/Swing. MRJ 2.1 also runs more applications and applets than earlier versions.

For the latest developments in Java for the Macintosh, see Apple's Java Web site at http://www.apple.com/macosx/features/java/

Configuring Your Web browser

Mac OS versions 8.0 and later come with a copy of Internet Explorer configured to work with MRJ. If you're using a different browser or if you got Internet Explorer from another source, you may need to configure it to use MRJ.

Note: Versions of Netscape Communicator/Navigator up to and including 4.5 use their own internal Java Virtual Machine and cannot be configured to use MRJ. Apple and Netscape are working together to develop a future version of Netscape Communicator/Navigator that will make use of MRJ. For more information on Netscape's browsers, you can monitor their Web site at http://home.netscape.com/computing

To configure Internet Explorer to use MRJ, choose Preferences from the Edit menu. In the Java Options section, make sure Java is enabled and Apple MRJ is selected as the Java Virtual Machine. To make your changes take effect, quit the browser and open it again.

Minimum System Requirements:

• Macintosh computer with a PowerPC processor
• System 7.6.1 or later
• 24 megabytes (MB) of RAM. For better performance, 32 MB of RAM is recommended, with virtual memory turned on and set to at least 33 MB. Installing more than 32 MB of RAM will greatly improve performance and increase the number of Java applets and applications that can run simultaneously.
• at least 20 MB of free disk space
• Using Java applets over the Internet requires Open Transport 1.1 or later and an active Internet connection.
• You may experience improved performance if you have QuickTime 3.0 installed. QuickTime 3.0 is installed with Mac OS 8.5, or you can download it at http://quicktime.apple.com.

             
Files Installed With MRJ 2.1

In the Extensions folder (inside the System Folder):

• MRJ Libraries folder, containing MRJ Lib, MRJ Symantec JITC, the MRJClasses folder and the lib folder
• MRJ Enabler extension (installed only on computers using Mac OS 8.1 or earlier)
• Text Encoding Converter 1.4.2
• Appearance Extension 1.0.3 (installed only on computers using Mac OS 7.6.1)

             
In the System Folder:

• A Text Encodings folder containing version 1.4.2 of the encodings

             
In the Control Panels folder (inside the System Folder):

• Appearance control panel 1.0.3 (installed only on computers using Mac OS 7.6.1)

             
In the Preferences folder (inside the System Folder):

• Appearance Preferences 1.0.3 (installed only on computers using Mac OS 7.6.1)

             
In the Apple Extras folder

• Mac OS Runtime for Java folder

             
           
For International Users

The MRJ 2.1 Installer installs U.S. English versions of the Text Encoding Converter 1.4.2 and associated text encodings. On most computers, these files replace older versions of the same files. However, on some computers sold outside the United States (such as computers sold in France), the filenames of the existing Text Encoding Converter and associated text encodings have been changed. On these computers, the MRJ Installer cannot recognize and replace the older files and does not install the Text Encoding software.

If you have a non-U.S. computer with Text Encoding 1.3 or later installed, MRJ works but may experience some text handling errors that don't occur on other computers.

If you have an earlier version of the Text Encoding software installed, an alert message appears during installation and tells you that your system software must be updated before MRJ can be installed.

Known Issues

• Secure Sockets: MRJ 2.1 does not support the Secure Sockets Layer interface (SSL), which allows applets to access Web pages via "https."
• Appearance Manager 1.0: If your system is using Appearance Manager 1.0 (which comes with Mac OS 8), you may see dialog boxes without borders or other visual inconsistencies. You should upgrade to Mac OS 8.1 or later. A free upgrade from 8.0 to 8.1 is available at Apple Software Updates Web site at http://www.apple.com/swupdates.
• Games and modifier keys: Some game applets use the Shift, Alt, and Control keys as game controllers. In some cases, these controls will not work as expected.
• Apple Studio Display: If you have an Apple Studio Display (flat-panel monitor) and Mac OS 8.1 or earlier installed, you may see cosmetic inconsistencies in the Monitors & Sound control panel. You should update your Apple Displays software, available from the Apple Software Updates Web site at http://www.apple.com/swupdates.
• Yahoo games: Multi-user Yahoo games do not work correctly using Internet Explorer and MRJ 2.1. Apple, Microsoft, and Yahoo are working together to resolve this problem.
• Low memory: When Java applications are running out of memory, MRJ may put up a blank window with no information in it and appear to crash. If this occurs, you can sometimes quit by selecting "Quit" from the Apple Menu (there is no Edit menu since Java did not start up properly). If several applications are running at the same time, quit unused applications to free up memory, or increase the amount of virtual memory in the Memory control panel, and then try the application again. If this problem persists, you may need to add additional physical RAM.
• Printing: If you use your browser's Print command to print a Web page that contains an applet, the page will contain a blank area where the applet should be. If available, use the applet's Print menu to print the page.

           
Miscellaneous notes

• Java developers: MRJ is a runtime environment and does not include development tools. If you are interested in Java development, you need a Java development environment and the MRJ Software Development Kit (MRJ SDK). For more information, see the MRJ developer page at http://developer.apple.com/java/.
• Apple Applet Runner: The Apple Applet Runner is now only available on the MRJ SDK. Apple Applet Runner 2.0, (which came with MRJ 2.0) is compatible with MRJ 2.1. For the latest version of Apple Applet Runner, download the MRJ SDK from the MRJ developer Web site at http://developer.apple.com/java/.
• Swing: MRJ 2.1 is compatible with both Swing 1.0.3 and Swing 1.1. For more information or a copy of the Swing software, see the Sun Microsystems Web site at http://java.sun.com/. To run Swing-based applets and applications, place the "swingall.jar" file in the MRJClasses folder, in the MRJ Libraries folder in the Extensions folder (inside the System Folder).

            
Warning: Java technology is not fault tolerant and is not designed, manufactured, or intended for use or resale for online control of equipment in nuclear facilities, aircraft navigation or communication systems, or air traffic control computers in which the failure of the Java technology or Mac OS Runtime for Java could lead directly to death, personal injury, or severe physical or environmental damage.