UltraLite User's Guide
  Developing Applications for the Palm Computing Platform
    Developing UltraLite applications with Metrowerks CodeWarrior

Creating UltraLite projects in CodeWarrior

This section describes how to use the UltraLite Plug-in for CodeWarrior.

To create an UltraLite project in CodeWarrior

1. Start CodeWarrior.

2. Create a new project.

   From the CodeWarrior menu, choose File > New. A tabbed dialog appears.

   On the Projects dialog, choose one of the available choices, and choose a name and location for the project. Click OK.

3. Choose an UltraLite stationery.

   The UltraLite plug-in adds two choices to the stationery list, one for C++ API applications and one for embedded SQL applications.

   Choose the development model you want to use and click OK to create the project.

   This stationery is standard C stationery for embedded SQL, and standard C++ stationery for the C++ API, and contains almost-empty source files.

4. Configure the target settings for your project.

   On your project window (.mcp), choose the Targets tab, and click the Settings icon on the toolbar. The Project Settings window opens.

   In the tree on the left pane, choose Target > UltraLite preprocessor. You can enter the settings for your project, such as which reference database to use.

When you build your project by pressing F7, the following preprocessing steps are carried out:

• For embedded SQL applications, sqlpp and ulgen utilities are invoked automatically to convert any .sqc files into .c or .cpp files and to generate the database code.

• For C++ API applications, ulgen is invoked to generate the UltraLite API files and the database code.

Also, the paths to required UltraLite files, such as headers and runtime library, are automatically added to the search paths.