### INM's Moka Xtra - Release Notes for Version 1.1

> Welcome to Moka Xtra
> What's new since the beta version
> What's included in this package
> System Requirements
> Known limitations
> Installation

Welcome to Moka Xtra

Thank you for purchasing in Integration New Media's Moka Xtra (formerly known as Java Xtra).
If you have not joined the MokaXtra-L discussion list, please click this link:
Join the Moka-L discussion list and subscribe to the list. Members of the old JavaXtra-L list
will be automatically subscribed to MokaXtra-L. This list will be the main vehicle
for sharing ideas between developers, and for transmitting problems, suggestions and
wishes to the Moka Xtra development team.

Be sure to download the latest version of the Moka Xtra User Manual, the revised
"First Steps" demo project, and two new demo projects: "Zip and UnZip Utilities".

What's new since the beta version

- Now supports Mac OS X
- New method: moka_GetLastJavaException() returns the last exception thrown from the JVM.
- New method: moka_GetCurrentJVMInstalled() replaces GetInstalledJVMs().
  The new method returns a string that contains the current default JVM installed on
  the user's computer, or the version of the JVM delivered with the Director projector.
  See the User Manual for details.
- New method: moka_Path(). When passing an absolute path as a parameter to a Java class,
  this method ensures that the path is correctly formatted for the end-user's OS.
- All Moka Xtra method names have been prefixed with "moka_" for easier identification
  in your Lingo code.

What's included in this package

- On Windows: MokaXtra.X32 - the Xtra
- On Mac there are two folders: Classic and OSX - each contains the version of the
  xtra (MokaXtra.XTR file) for the corresponding operating system (Classic being Mac OS 8 or 9).
  If you want to distribute a cross-platform projector both Mac OS X and OS 9.x,
  you need both versions of the Xtra. See the User Manual for more information.
- JClassBrowser.dcr - the Java™ class browser tool for Director 8.5 and MX.
- Folder named "ForDirector7-8", which contains a version of the JClassBrowser
  built with Director 7. This version does not support the copy/paste keyboard shortcuts.

System Requirements

- All Macintosh computers equipped with Mac OS 8.1 and higher, including Mac OS X.
- On Mac: MRJ 2.1 or later installed on the end-user's system The MRJ is included
  with the Mac OS. It is recommended to use MRJ 2.2 because of bugs in version 2.1.
  For versions of Mac OS prior to 8.6, you will probably have to upgrade the
  MRJ, because MRJ 2.1 began shipping with Mac OS 8.6.
- All Windows computers equipped with Windows 9x/NT/2000/XP
- On Windows: Sun™JRE (Java™ Runtime Environment) 1.3.x or 1.4.x installed
  on the end-user's system
- Director version 7, 8, 8.5 or MX.
  Users of Director 7 and 8, read the note below.

Known limitations

- Only one instance of the JVM is created. Once the JVM is started, by instantiating
  Moka Xtra, the only way to destroy its instance is by closing Director. Therefore,
  if you are modifying your Java™ classes at authoring time, you must close and
  restart Director in order for the changes to take effect.
- To make a cross-platform application that runs on Mac OS 8 or 9, you should only
  use classes found in Java™ Platform 1.1 API, in addition to your own custom classes
  (any custom classes used should be based on this version of Java™).
  For a complete listing of the classes available in Java™ Platform 1.1 API, go to Sun's website: http://java.sun.com/products/archive/jdk/1.1/index.html

Installation

1. Make sure Director is not running
2. Create a subfolder within Director's Xtras folder, and name it "Moka Xtra".
   The Xtras folder is located in the same location as the Director application
   (usually something similar to C:\Program Files\Macromedia\Director 8\Xtras on
   Windows or Hard Disk:Applications:Macromedia:Director 8.5:Xtras on the Macintosh).
3. Place the Xtra ("MokaXtra.x32" on Windows; "MokaXtra.XTR" on Mac) into the
   Moka Xtra folder you just created.
4. Move the JClass Browser tool, the file named "JClassBrowser.dcr", into this
   new Moka Xtra folder as well (users of Director 7 or 8, use "JClassBrowser-D7.dcr",
   found in the folder named "ForDirector7-8"). This will ensure that the tool is available
   by clicking Xtras > Moka Xtra > JClassBrowser from Director's menu.
5. Launch Director.
6. To check if the Xtra was installed correctly, type "showxlib" in the Message
   window. You should see "MokaXtra" in the list of Xtras displayed.
7. To check if the JClass Browser tool was installed correctly, you should see it
   in Director's Xtras menu (Xtras > Moka Xtra > JClassBrowser).

   Installation of JVM and Java™ classes

   On Windows, the Java™ Virtual Machine (JRE v1.3 +) must either be installed on the end-user's
   system, or it may be delivered with the Director projector. See the User Manual for details on
   how to distribute your project.

   Any custom Java™ classes needed to run your application must be delivered
   with your project and must be accessible to the application locally. See the User Manual
   for details on accessing custom classes.

To obtain the most recent version of INM's Moka Xtra and supporting material,
please visit our product website at:
http://www.MokaXtra.com

©2003, Integration New Media, Inc.