Waba Software Development Kit 1.0
The WabaSDK allows you to develop Waba programs in conjunction with
a Java Development Kit such as Sun's JDK or Microsoft's SDK for Java.
The resulting programs can run on devices containing a Waba
Virtual Machine (WabaVM) and can run as a Java applet or application
on any machine supporting Java. WabaVM's for this release are
available for Windows CE and the PalmPilot.
Changes from previous release
- removed Form dependencies under PalmOS
- allow multiple PalmOS catalogs w/same creator
- released source for bridge classes in SDK
- various internal-only code changes
This release is fully backwards compatible with the Beta 9 release.
The class reference for this release is available
here.
Instructions for using the SDK:
-
You need a Java Development Kit to use this SDK. This could be
Sun's JDK, Microsoft's SDK for Java, Symantec's Visual Cafe, etc.
To create a Waba program, simply add the "classes" directory
contained in this distribution to your CLASSPATH and write your
program using the Waba classes.
Make sure not to use any language
features that are not supported by Waba (exceptions, threads, longs
or doubles) and reference only the Waba classes and the classes
you create in your program.
Do not reference any of the classes that
come as part of your JDK or your program will only run as a Java
applet or application and not on devices that only contain a WabaVM.
Refer to the "doc" directory for the complete Waba API. To remain
portable, the only classes you should use are those contained in
the Waba API.
You start creating a Waba program by subclassing the MainWindow class.
The Scribble example program shows how to create a basic Waba
program. The make.bat program contained in the Scribble directory
shows how to build the program. Under Windows, you can simply execute
"make" to build Scribble.
-
The Scribble example also shows how to run your program as a Java applet.
You can create a .html file, reference the waba.applet.Applet class in
the .html file and pass your MainWindow's name as the appClass parameter.
Refer to the Scribble example's .html file for an example.
-
To run your program on a PalmPilot or Windows CE device, a WabaVM must be
installed on the device. WabaVM's are available from the download page of
www.wabasoft.com.
To install a Waba program on a PalmPilot, you will need to create .prc and .pdb
files. The .prc file is the PalmPilot executable and the .pdb file is
the PalmPilot database containing the class files for the program.
For Windows CE devices, you need to create .lnk and
.wrp files. The .lnk file is the Windows CE launch program and the .wrp
file contains the class files for the program.
You use the "exegen" program to generate .prc and .lnk files and the "warp"
program to generate .pdb and .wrp files.
These programs are located in the "bin" directory and only run under Windows 95
and Windows NT. You can develop your program on any machine with a JDK but
you need to create the warp (.pdb and .wrp) and launch executables (.prc and
.lnk) on a Windows machine.
There are versions of these programs for other
platforms, see the
Top 10
list on Wabasoft's web site for the other versions.
A more detailed explanation of how to use the exegen and warp programs to
generate these files is contained on Wabasoft's web site on the
Writing a Simple Program
page.
-
To install your program on a PalmPilot, simply install the .pdb and .prc
files for the program.
To install your program under Windows CE, simply install the .lnk and .wrp files.
Under Windows CE, you will need to install the .wrp file in the directory that
was specified when the .lnk shortcut file was created with exegen.
Examples
This SDK contains a few example programs:
- AddrScan
scans through the Address book of a PalmPilot
- Controls
displays some of the user-interface controls
- CoreTest
displays some of the core graphic functionality
- ImageSplit
example of image loading and manipulation
- PocketWatch
displays a running pocket watch
- Scribble
lets a user draw on the screen
- Web
displays the text of a web page - requires an Internet connection
License
Copyright (c) 2000 Wabasoft.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
license.txt file containing the GNU General Public License for more details.
Trademark Notice
Java and JDK are trademarks of Sun Microsystems. PalmPilot is a trademark
of 3Com. Microsoft, Windows NT, Windows 95 and Windows CE are trademarks of Microsoft Corporation.
Waba, WabaVM and WabaSDK are trademarks of Wabasoft Corporation.
Copyright (c) 1999 Wabasoft. Waba, WabaVM and WabaSDK are trademarks of
Wabasoft Inc.