wabasoft waba software development kit  
Reference
API Reference
SDK Programs
General
How-to Papers
Specifications
Wabasoft Home

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:

  1. 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.

  2. 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.

  3. 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.

  4. 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.