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
- Make sure Director is not running
- 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).
- Place the Xtra ("MokaXtra.x32" on Windows; "MokaXtra.XTR"
on Mac) into the
Moka Xtra folder you just created.
- 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.
- Launch Director.
- To check if the Xtra was installed correctly, type "showxlib"
in the Message
window. You should see "MokaXtra" in the list of Xtras displayed.
- 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.