Building PODS for Palm OS devices

On the Palm operating system, you implement a POD as a Palm OS system library. Thus, the POD is dynamically linked with the M-Business Client application, rather than statically linked. How you create a system library project depends on the tools you are using.

  • For Metrowerks CodeWarrior IDE, go to your project's Settings panel. In the 68K Target panel's Project Type list, choose Library, with Palm OS Library as the option.

  • For GNU tools, compile with the -shared option.

In either case, make sure you do the following:

  • Link with the podsstartuppalm.o object module and make sure this module is first in the link list, or include podsstartuppalm.c as the first file in your project.

  • Specify any creator ID name you like and a type of "pods".

    Note

    If you want your POD to be deleted when M-Business Client is deleted on the Palm, the creator ID must be "AvGo". If it is any other value, the POD remains on the Palm even if M-Business Client is removed. If a POD has a creator ID other than "AvGo", the POD can be removed individually from the Palm using Delete in the Applications list.

The PODS distribution provides some sample files that you can copy and edit to make sure that you have correctly set up your project. If you are using Metrowerks CodeWarrior, copy and edit helloworld.mcp. If you are using GNU tools, copy and edit the provided Makefile. For instructions on accessing the sample files, see Downloading and working with the PODS sample files.

Note

When developing for Palm OS, be sure to include the line below in your prefix files: #define __palmos__ Notice that there are two underscores before, and two more after palmos in this line. For examples, see PODS Code Samples.


Coding without globals on Palm OS
Other ways of avoiding globals