Introduction to Borland C++ Mobile Edition 1.1

By: Anders Ohlsson

Abstract: A short and sweet introduction on how to build some sample mobile applications

Before you start

Make sure you have downloaded and installed the software. The software consists of a few major parts, including the Symbian SDK and the Borland C++ Mobile Edition plugin version 1.1. Please note that you'll also need Borland C++Builder update 4 (it's included in the installer).

One way of making sure it's installed properly is to check the About boxes in C++Builder (yes, there will be two of them if you have the mobile stuff installed).

Writing our first Hello World application

When you select File, New, Other you'll notice a new Mobile tab. It should look like this:

Double click on the "New Mobile Application". Set the project type to "Basic HelloWorld Application" and set the project and directory names to something that makes sense - in my example it's "MyFirstApp". The directory of your application will be the root of the SDK unless otherwise specified.

Once you hit OK in the "New Series 60 Project Wizard" you'll get a bunch of files generated for you. The project manager should look similar to mine:

Let's go ahead and build the application. The IDE will ask you to save all the files to disk. Once properly built, your compiler status window should look like this:

Take a peak at the message window below your editor. You should see a bunch of stuff in there. In my case I got about 40-50 lines of status data.

When you hit OK, the emulator should pop up on your screen. It will act just like a cell phone (including the startup time). When it's booted up, it should look like this:

Use the mouse and the cell phone keys to navigate to Other, MyFirstApp. Hit OK. The app should run and look like this:

Importing a mobile application

Next, we'll import an existing demo that comes with the SDK. There's a graphics application that has some bouncing balls that is kind of cool to show off.

First, select File, New, Other, Mobile, Import Mobile Application like this:

Then, locate the Graphics demo in the directory structure of the SDK samples. You should browse to Graphics/group/bld.inf and open it. On my system the full path to this file is C:\Nokia_Symbian\6.1\Series60\Series60Ex\Graphics\group\bld.inf.

When the Graphics demo has been imported, the project manager should look similar to this:

After you build and run the application in the emulator, you'll have to select one of the choices from the menu off the left selection button. In my case I picked "No off screen bmps".

Happy mobile hacking! ;)

Server Response from: ETNASC03