Prev: Creating, Installing and Testing the module DLL

Compiling and Linking

A native module must be compiled into a polymorphic DLL file with name module_mm.dll, where module is the name by which the module is known to m. Such a DLL has UID2=0x1000008d. You are free to specify an UID3. If you do, the m runtime environment UID is an option:

UID Platform, signing type

0x1020429a Symbian 2nd Edition

0xa0009885 Symbian 3rd/5th Edition, self signed and DevCert signed

0xe7e0cab8 Symbian 3rd/5th Edition, online signed

Each module must be linked:

for Symbian 2nd Edition, with the Symbian libraries edll.lib and euser.lib, and the m runtime library mRuntime.lib.
for Symbian 3rd/5th Edition, with the Symbian library euser.dso, and the m runtime library mRuntime.dso. The latter comes in two versions for each device type, depending whether you link for a self signed, DevCert signed, or online signed m installation.

The other libraries depend on the Symbian APIs your native module uses.

World Server Example, Continued

World Server Example, Continued

Assuming the standard SDK, a minimum of three files are needed:

The C++ source WorldModule.cpp.
The bld.inf file naming the project file. A minimal file is:
PRJ_MMPFILES World.mmp

The World.mmp file describing the project. An example for Symbian 2nd Edition:

// World native module project for Symbian 2nd TARGET World_mm.dll TARGETTYPE dll UID 0x1000008d 0x1020429a SOURCEPATH . SOURCE WorldModule.cpp USERINCLUDE ..\..\include SYSTEMINCLUDE \epoc32\include LIBRARY edll.lib euser.lib mRuntime.lib LIBRARY worldclient.lib EXPORTUNFROZEN

The same for Symbian 3rd/5th Edition:

// World native module project for Symbian 3rd/5th TARGET World_mm.dll TARGETTYPE dll UID 0x1000008d 0xa0009885 CAPABILITY LocalServices NetworkServices ReadUserData \ UserEnvironment WriteUserData SOURCEPATH . SOURCE WorldModule.cpp USERINCLUDE ..\..\include SYSTEMINCLUDE \epoc32\include LIBRARY euser.lib mRuntime.lib LIBRARY worldclient.lib EXPORTUNFROZEN

The capabilities listed are the minimum set for a self signed m installation. See * () for further information.

Once all the files are in place, just call

bldmake bldfiles abld build armi urel

After these two steps, Epoc32\release\armi\urel of your SDK should contain a file World_mm.dll. This is the native m module!

For Symbian 3rd/5th Edition, you must replace the platform armi by gcce:

abld build gcce urel

And the DLL file should be in Epoc32\release\gcce\urel of your SDK.

Next: Installing

UID	Platform, signing type
`0x1020429a`	Symbian 2nd Edition
`0xa0009885`	Symbian 3rd/5th Edition, self signed and DevCert signed
`0xe7e0cab8`	Symbian 3rd/5th Edition, online signed