diff -r 80ef3a206772 -r 48780e181b38 Symbian3/SDK/Source/GUID-F79EE68F-FFC3-541E-AE3A-D7203034DA43.dita --- a/Symbian3/SDK/Source/GUID-F79EE68F-FFC3-541E-AE3A-D7203034DA43.dita Fri Jul 16 17:23:46 2010 +0100 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,99 +0,0 @@ - - - - - -mmp -project specification -

This page describes the MMP for a typical GUI application.

-

TARGETTYPE

-

From v9.0, a GUI application is an exe. This is specified with the targettype statement:

-TARGETTYPE exe -

The target filename's extension can be either .app or .exe. This is specified -using a target statement:

-TARGET <appname>.exe -

UID

-

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.

-

Stack size

-

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 -epocstacksize 0x5000 -

UI resource

-

Specify the application's UI resource file using a start -resource statement:

-START RESOURCE <appname>.RSS -HEADER -TARGETPATH \Resource\Apps -END -

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.

-

Caption/icon resource

-

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.

-

Registration file

-

Specify the application's registration file using another start -resource statement:

-START RESOURCE <appname>_reg.rss -TARGETPATH \private\10003a3f\apps -END -

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.

-

For more information, see Application -registration information.

-

Icons

-

A bitmap file containing icons for an application can be specified using -a start bitmap statement:

-START BITMAP <appname>.mbm -TARGETPATH \Resource\Apps -SOURCE <color-depth> <source-bitmap-list> -END -

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:

TARGET HelloWorld.exe -TARGETTYPE exe -UID 0x100039CE 0x10004299 -VENDORID 0x70000001 -epocstacksize 0x5000 - -SOURCEPATH . -SOURCE HelloWorld_Main.cpp -SOURCE HelloWorld_Application.cpp -SOURCE HelloWorld_Document.cpp -SOURCE HelloWorld_AppUi.cpp -SOURCE HelloWorld_AppView.cpp -USERINCLUDE . -SYSTEMINCLUDE \epoc32\include - -START RESOURCE HelloWorld.RSS -HEADER -TARGETPATH \Resource\Apps -end - -START RESOURCE HelloWorld_reg.rss -TARGETPATH \private\10003a3f\apps -END - -START BITMAP HelloWorld.mbm -TARGETPATH \Resource\Apps -SOURCE c8,1 icon24.bmp icon2m.bmp icon32.bmp icon3m.bmp icon48.bmp icon4m.bmp -END - -LIBRARY euser.lib apparc.lib cone.lib eikcore.lib - \ No newline at end of file