To create a new Palm OS project in the Workbench, select File > New and the application type you want to create, as shown in Figure 2.3.

Figure 2.3  Creating a new project

• Standard Make 68K C/C++ Project

  This is a project for a Palm OS 68K application, written in
  C/C++, that use a Standard Make makefile.

• Managed Make 68K C/C++ Project

  This is a project for a Palm OS 68K application, written in
  C/C++, that uses a Managed Make makefile.

• Standard Make 68K PNO C/C++ Project

  This is a project for a Palm OS 68K application with an ARM-based PNO, written in C/C++, that uses a Standard Make makefile.

• Managed Make 68K PNO C/C++ Project

  This is a project for a Palm OS 68K application with an ARM-based PNO, written in C/C++, that uses a Managed Make makefile.

• Standard Make Protein C/C++ Project

  This is a project for a Palm OS Protein application, written in C/C++, that uses a Standard Make makefile.

• Managed Make Protein C/C++ Project

  This is a project for a Palm OS Protein application, written in C/C++, that uses a Managed Make makefile.

Enter Project Name and Location

When you select your application type, the New Project wizard opens, as shown in Figure 2.4.

Enter a project name and select the location for your project files. (As described in "Using Workspaces," it is recommended that you accept the default location.)

For each page of the wizard, click Next to move to the next page.
Figure 2.5  New Project wizard Palm OS settings

Project Output Type

Select the output type for the project.

Application - A Palm OS application. For information, see Exploring Palm OS: Programming Basics.

Shared Library - An executable module that is compiled and linked separately. For more information, see Exploring Palm OS: System Management, Chapter 6 "Shared Libraries."

Static Library - A collection of object files that you can link into another Palm OS application.

Database (pdb) - A PDB is a record database generally used to store data for an application. For information, see Exploring Palm OS: Palm OS File Formats.

According to the normal Eclipse build paradigm, a project produces only one output file. Creating Database projects gives you a way to add PDB files to an application's debug session by using the Files to install field in the Debug dialog box for the Palm OS Application configuration.

Note that the Database (pdb) selection is supported for standard make projects only.

Output Name without extension

The name for your project and related output files. This field is set to the project name entered in the Name field shown in Figure 2.4.

Database Type

For Palm OS applications (PRC databases), this field has the value appl.

For Palm OS shared libraries, this field has the value libr.

Database Version

The application-specific version of the database layout.

Database Name

The database name stored in the PRC database header. This is normally the name of the application.

Creator ID

Each Palm OS application is uniquely identified by a combination of its name and a four-byte creator ID. Enter the creator ID that you have registered with PalmSource. For information on creator IDs, see Exploring Palm OS: Programming Basics.

Database Settings

Select how you want the database attribute constants set for your database. See Palm OS Programmer's API Reference for more information on the database attribute constants described.

Allow Backup on Sync - Select to set the dmHdrAttrBackup constant.

Hidden - Select to set the dmHdrAttrHidden constant.

Bundle its Databases - Select to set the dmHdrAttrBundle constant.

Prevent Copy - Select to set the dmHdrAttrCopyPrevention constant.

Reset on Install - Select to set the dmHdrAttrResetAfterInstall constant.