Main Page | Class List | File List | Class Members

Mimer C++ API for Symbian OS

9.2.5b

Introduction

Mimer SQL Mobile is a programming and data management platform for mobile devices. Programming languages and environments supported includes C, C++, .Net, and Java. This document is about Mimer and the C++ programming language on Symbian OS.

This API designed with the Symbian OS programmer in mind to provide a tight integration to the Symbian OS C++ environment. The API is identical no matter if Series 60, UIQ or any other Symbian OS environments are used.

Symbian OS SDK installation

Provided Mimer Symbian components are selected when installing Mimer SQL Mobile, an epoc32 file tree is placed in the Mimer installation directory. This file tree contains all programming components required to develop C or C++ applications with Mimer SQL under Symbian OS. To install these files into the Symbian OS SDK, just copy this tree into the EPOCROOT directory. For example, where {MIMROOT} denotes the Mimer installation directory.

 xcopy /E {MIMROOT}\EPOC32 %EPOCROOT%\EPOC32

Once the files are copied, applications using the Mimer C++ API may be compiled for WINSCW, THUMB and ARMI platforms.

Compiling and linking Mimer C++ applications

To link applications to use the Mimer C++ API, the library MIMCPPAPI.LIB need to be included in the link list. The below excerpt from a makmake project file provides an example linking configuration.

 TARGET HelloMimer.app
 TARGETTYPE app
 UID 0x100039CE 0x10004299
 TARGETPATH \system\apps\HelloMimer
 SOURCE HelloMimer.cpp
 SYSTEMINCLUDE \epoc32\include
 LIBRARY mimcppapi.lib
 LIBRARY euser.lib apparc.lib cone.lib eikcore.lib

Device installation

The C++ API dynamic link library is included with the server binary installation, and no further component installations are required. When installed, the MIMCPPAPI.DLL library is placed in the \system\libs folder on the device.

Application packaging

Before the application is packaged the database files need to be generated for mobile deployment. More information about this can be found in the "Working with Mimer SQL Mobile" section of the Mimer SQL Mobile Documentation kit. When the databank files has been generated, the entire application may be packaged using the makesis tool.

The following package file provides an example on how to incorporate the required Mimer components in the application installation file. This example will only work on the UIQ platform. The Mimer installation file MimerSQLCliSymbianArm is found in the Mimer SQL Mobile installation directory (for example c:\program files\mimer sql 9.2\ on your development PC). The mimer_db.sis installation file appears in the databank generation directory during the database files generation step described in the "Working with Mimer SQL Mobile" section.

 &EN
 #{"HelloMimer"},(0x100039CE),1,0,0
 (0x101F617B), 2, 0, 0, {"UIQ20ProductID"}
 "HelloMimer.app"-"!:\system\apps\HelloMimer\HelloMimer.app"
 @"MimerSQLSymbianArm.sis",(0x101FEC99)
 @"mimer_db.sis",(0x101FEC98)
 (0x101FEC97), 9, 2, 5, {"Mimer SQL libraries"}

The last line is important since it will make the installation system count references on shared resources. Users trying to uninstall Mimer SQL components manually will be warned that your application relies on these components and thus may stop working.

Example applications

Example applications are not included with the Mimer SQL Mobile installation. Look for example applications on the Mimer SQL Developer site, http://developer.mimer.com .