Mobiiliohjelmointi/Mobile programming

Exercise 1

1. Create a Project

 

a)      Start carbide. Choose a workspace (OBS: workspace should be in same drive as symbian SDK, usually C:)

b)      From the file menu, select File->New->Project

c)      A ‘New Project ‘ wizard should pop up. Select Symbian OS-> Symbian OS C++ Project. Then hit next

d)      The next pop-up will ask for a project type. Select S60 3rd Edition ->S60 3rd GUI application. Hit next.

e)      Enter a unique project name and hit next.

f)        Select the S60 SDK and hit next.

g)      Next you will see some fields with Basic Settings. These include the UID, copyright notice, your name and some text. Fill in as appropriate. Hit next.

h)      The final screen shows you the project directories. Do not make any changes for now. Hit Finish. Congrats! You have now created a Symbian project.

 

2. Build a Project

 

a) To Build your new project, find the C/C++ Projects window (normally top left). Select your project. You can build the project by

a) Right clicking the project and select Build Project.

b) Select from the menu bar Project->Build Project.

c) The key combination Ctrl-B will also build the project.         

b)         To run the project from the menu bar, select Run-Run As->Run Symbian OS Application.

c) This will start the emulator. It might take a few minutes for the emulator to start. You can find your application MENU -> INSTALLED -> your application name

 

3. Debugging.

a) To insert breakpoints, right click on the extreme left of the line and select ‘toggle Breakpoint’.

b) To start the Debugger, select run->Debug As-> Symbian OS Application.

c) IN debugging mode, additional breakpoints can be inserted  by, go to a relevant line and selecting run->toggle Line Break. Alternatively, select the keyboard combination Ctrl-Shift-B, or right click on the extreme left of the line and select toggle Breakpoint. c) Now run the debugger again. Run ->restart.

 

4. Modify the project (add a new class)

            a) Select File->new->Symbian OS C++ Class

            b) Select your project and hit next.

            c) Select Simple Symbian Style C++ Class. Hit next.

            d) Give your class a name. Hit next. (This is a Heap based class, so remember to put a C before the name!).

            e) check out your new class. The *.cpp file should be found under the ‘src’ directory, and the header file under ‘inc’ directory.

 

5. Find methods and try to figure out what those do
            a) View's Draw
            b) AppUi's HandleCommandL
            c) Search the file, where message "Hello World" is defined and change the text.

 

6. Build a .sisx file

a.       Select Project->Properties.

b.      From the list on the left hand side, select Carbide Build Configurations Under active configuration, select Phone release(GCCE) [S60_3rd_FP1]

                Build project. Under sis-folder you should be able to find sisx - file. You might need to refresh the project (right click -> refresh).

c.        yourproject.sisx can be downloaded to your phone using Bluetooth, or Pc Suite. Double-clicking the sisx - file in Carbide starts the pc-suite application if it is  installed.

 

 

 

 

Installation of SDK & Carbide.

The software development environment used in this course is based on Carbide.c++ ver. 1.2.2 and the S60 SDK.

Before download, you will need to register with the Nokia forum web site first http://www.forum.nokia.com/  

Carbide can be downloaded here:

You must install a number other packages as well, instructions can be found in the link above. The exercises are based on the S60 SDK, which can be found here. For people who have phones that are not S60 based, you will need to download different SDK’s.