Recent Changes - Search:

Installation Notes

How to Install JMaker - Answer these questions for successful installation and use of JMaker

Question?

Answer

Where is the JDK?

To use JMaker you must install the Java Development Kit - JDK.
You can download the JDK at http://java.sun.com in the products and apis link.
Follow the JDK installation instructions.
The JDK will be installed into a directory
Your installation may look like one of these:

  • c:\jdk
  • c:\jdk1.1.8
  • c:\jdk1.4
  • /home/usr/jdk
  • /home/usr/jdk1.4
  • /home/usr/java

Make sure you know where you installed your JDK

Where are the JDK tools?

To run JMaker and to use the JDK you must know where the JDK tools are.
The tools are in the /bin folder of the JDK installation.
Some tools are:

  • java.exe
  • jar.exe
  • appletviewer.exe
  • javac.exe
  • jdb.exe

Your tools may be located in a path like one of these:

  • c:\jdk\bin
  • c:\jdk1.1.8\bin
  • c:\jdk1.4\bin
  • /home/usr/jdk/bin
  • /home/usr/jdk1.4/bin
  • /home/usr/java/bin

Look for the "jar" tool in the bin folder in your JDK installation.

What path are we going to use in this example?

In this example we will use the following path for the JDK installation:
c:\jdk
Remember - Your path may be different - just substitute your path in for "c:\jdk" to do your installation.

Where do I want to put the JMaker files?

This depends on which JDK? 1 or 2?

JDK 1 (1.1.X)
make a classes folder in the JDK path if one does not exist:

c:\jdk\classes
For JDK 2 (1.2, 1.3, 1.4, etc)
make a classes folder in the JDK/jre path if one does not exist:

c:\jdk\jre\classes

Where should the jmaker1.zip or jmaker1.jar file be before I extract files from it?

Copy or move the jmaker1.zip or jmaker1.jar file into the classes folder

For JDK 1
c:\jdk\classes\jmaker1.zip (or jar)

or for JDK 2
c:\jdk\jre\classes\jmaker1.zip (or jar)

How do I extract the JMaker files?

You downloaded one of the jmaker downloads:
jmaker1.zip
or
jmaker1.jar

Either can be extracted using the JDK jar tool.

At the command prompt change directories until you are in your classes folder where the jmaker1.zip or jmaker1.jar file is.

type:
c:\jdk\bin\jar xf jmaker1.zip
or
c:\jdk\bin\jar xf jmaker1.jar
depending on whether you downloaded the zip or jar file.

This command will extract the files from the jmaker1 archive into the classes folder.

If you now have a jmaker1 folder and a jsrc folder then you were successful!

How do I run JMaker1?

at the command prompt type:
c:\jdk\bin\java jmaker1.JMaker1

Case is important! Note carefully what letters are capitalized! The first jmaker1 is all lower case. The second JMaker1 after the period begins with 2 upper-case letters.
Success? I hope so. If not, then review the questions and answers.

Using JMaker - Questions you may have after you get JMaker installed and running...

Where should I put my .java source files?

Your source files are the .java files that you create, compile and run to execute your java programs.

When you install JMaker a "jsrc" (java source) folder is installed beside the jmaker1 folder.
The "jsrc" folder is a good place to start putting your .java files.

At first you can put your java files into the jsrc folder. As your projects get more complex you can create project folders inside the jsrc folder to keep your java files organized.

For example: If you are writing a tic-tac-toe game you could store the tic-tac-toe java files in a "jsrc/ttt" folder (you make the "ttt" folder) to keep the tic-tac-toe files separate from other project files.

Where should I put my compiled .class files?

You use the JDK javac program to compile your source files (.java files) into .class files before you can run your programs.

Where you "compile to" is a very important question for 2 reasons:
1) The java virtual machine (jvm) must be able to find your class files in order to load them to run your programs.

2) You may want to distribute the .class files separate from the .java files.

JMaker makes solving this problem easy.

When you first install JMaker it automatically compiles files to the same location as the jmaker1 folder. This solves question #1 about how the jvm finds class files. If the jvm could find and run the JMaker files then it will also be able to find and run your compiled java applications!

How does JMaker control where my compiled .class files go?

JMaker allows easy control over these options.

Look at the "Alpha" frame that comes up when you run JMaker.
If you closed the "Alpha" frame you can bring it up again by clicking on the JMaker Edit Window's "View" menu "Alpha Frame" option.

At the bottom of the Alpha Frame click on the "Options" tab to display the JMaker project options.

At the top of the Alpha Frame click on the "Basic Tools" tab to show the JDK basic tools options.

Just below the Basic Tools tab click on the "javac" tab to bring up the jvm javac (java compiler) options.

Note how the -d option is set for your computer in the javac options.

Note also that if you have the tool tip window up you can point at the different tabs, buttons and text fields and see a short description in the tool tip window. You can bring up a tool tip window by clicking on the Edit Window's "Help" menu and then click "Tool Tips".

Alpha Frame>Options>Basic Tools>javac

What if I am developing applets? Where does the .html file go?

Applets require that the .class files be located with (relative to) the html file that loads the applet.
It is recommended that you store the java, class and html files in the same folder for applets.

To do this just deselect the "-d" javac option in the Alpha Frame, Options, Basic Tools, javac window.
With the "-d" option turned off your .class files will be put in the same location as its .java file.

For example: If your tic-tac-toe program is an applet then you would put the source files (java files) and class files (compiled java files) and html files in the "jsrc/ttt" folder.

Set the appletview options to use the "shortpath" in the Alpha Frame, Options, Basic Tools, AppletViewer window.

Alpha Frame>Options>Basic Tools>AppletViewer

Can I do it any other way?

Yes, but....
If you are just starting out with java then stick to what works until you gain mastery over the behavior of the JDK and the jvm.

Happy java programming!

Edit - History - Print - Recent Changes - Search
Page last modified on July 19, 2007, at 06:21 PM