A .mmp project definition file specifies the properties of a project in a platform and compiler independent way. The makmake tool converts project definition files into makefiles for particular platforms. The abld.bat tool wraps calls to makmake, and can be more convenient to use than makmake directly.
A project definition file has extension .mmp.
- Each statement occupies a single line.
- Use the C++ style comment syntax for comments.
- A trailing backslash is used to indicate a line continuation. Therefore, specify directories without their trailing backslash, for example: Do SYSTEMINCLUDE \epoc32\include, rather than SYSTEMINCLUDE \epoc32\include\
From v9.0, a GUI application is an exe. This is specified with the targettype statement:
The target filename's extension can be either .app or .exe. This is specified using a target statement:
Specify the UID for the application in a uid statement:
UID 0x100039CE <UID3>
The UID2 value 0x100039CE should be used for all applications. The UID3 value is the unique identifier for the particular application.
Specify the languages that the application is localised for in the .mmp file:
LANG 01 02 03
By default, processes have a stack size of 8K. This can be insufficient for some applications. To increase the size, use an epocstacksize statement:
// set stack to 20K
Specify the application's UI resource file using a start resource statement:
START RESOURCE <appname>.RSS
The resource should be built into the \Resource\Apps directory. This is specified using the TARGETPATH part of the statement.
The header line tells the resource compiler to produce a file \epoc32\include\<appname>.rsg, which defines macro constants through which C++ programs can refer to resource structures.
An application can specify localisable captions and icons to display on the shell using a LOCALISABLE_APP_INFO resource, either in the UI resource file or in a separate resource file.
Specify the application's registration file using another start resource statement:
START RESOURCE <appname>_reg.rss
The registration file must be built to the private system directory \private\10003a3f\apps directory.
Note that for security reasons a registration file cannot be installed directly to this location on a target device. When creating a PKG file (software install package file) for an application, the registration file must be installed to the \private\10003a3f\import\apps\ directory.
A bitmap file containing icons for an application can be specified using a start bitmap statement:
START BITMAP <appname>.mbm
SOURCE <color-depth> <source-bitmap-list>
Icon files, like the UI resource file, should be built into the \Resource\Apps directory.
An example of a real GUI application project file is given below:
UID 0x100039CE 0x10004299
START RESOURCE HelloWorld.RSS
START RESOURCE HelloWorld_reg.rss
START BITMAP HelloWorld.mbm
SOURCE c8,1 icon24.bmp icon2m.bmp icon32.bmp icon3m.bmp
LIBRARY euser.lib apparc.lib cone.lib eikcore.lib