Hemelix

Testing your Carbide C++

Now we have installed Carbide C++ in our PC and we would like to test it if it is working already. We need to make sure before going on, the reason is simple without testing anything nobody can say that something is working properly.

This section guide us to test our carbide installation and at the same time we can run our HelloSymbian example and we shall be familiar with both Carbide and HelloSymbian. We can even go further we can try to make a installation file that can be installed to our device, but to which device? We should have a device based on S60 3.0 platform. You check your model from this link

Let's first check Carbide C++ with our HelloSymbian program

• You can download the HelloSymbian from our tutorial section and unzip and save it to a same drive in which you have installed Carbide C++
• Open your Carbide C++ and select file -> import,
• Select Symbian OS Bld.inf file and next button,
• Browse our HelloSymbian folder (group and select bld.inf) and press next as shown in the following picture,



• Now a window will appear from where we can select SDK (You might have different SDK for example S60 3.0, FP1, FP2 etc) In our case we select S60_3rd_MR Emulator Debug as shown in the following picture (there are some other option for example making software for real HW and so on) Press next and Finally press Finish,



Now the carbide project is ready for compilation. Since this was ready made project so it will compile OK.

• Now go to project menu and select Build Project, this will start compiler, linker and so on and finally our helloSymbian program is ready,

Just to check if we have any error we can check very easily. Select windows ->Show View ->Problem. This will tell us if there were any problem during compilation/linking phase. If we have not modified any of the source code then there should not be any problem and we are ready to run our first HelloSymbian program.

• To run our program select Run -> Run as -> Run Symbian OS application.

Wait for a while, our emulator will start. If you are in idle mode of the emulator press home button on your key board or if you are in Menu already go to Installed folder by arrow key and when Installed is highlighted press enter on your keyboard. Now we can see our Hellosymbian icon. Select the icon and press enter on your keyboard. Now we see Hello Symbian is printed on the screen. Now we are done with our first example.

If we like we can do some change in the code so it will print our name. Click on the right corner of the emulator and close it. Go to project explorer view and select inc folder, open hellosymbian.h file by double clicking on it. Now we find a text _LIT(KTitle, "Hello Symbian"); Now change the Symbian to your name and save the file and build the project. Run it and see that you are welcomed by the emulator. Congratulation ! We are sure that you can manage with Symbian OS, so go ahead with rest of the tutorial. Making application for devices is fun !

Now let's see how we can create Symbian application by wizards provided by Carbide C++

• Open your carbide, close all files and project (if there are any previously used project). Best way to close file by clicking on right corner and to close a project. We can manage without closing it also.

Let's try to familiar with Carbide wizard that will give us an option to create project very much automatically. This is similar to many other IDE. This will give us a very simple project to create. In real life application are very very complex. But this will be our starting point.

• Select File -> New -> Symbian OS project
• Select 3rd-Futured Ed. GUI Application (This can be different depending on your SDK, but select similar one and try if you don't have exactly this item)
• Select next and give a project name (Some thing HelloGui for example)
• Press next (again you may need to select right SDK if you have more in your PC, Click on the + symbol and expand it and select Emulator Debug (WinsCw) and Phone Debug armv5) Press next, next and finally Finish

Now we have a project generated by Carbide. Compile and run as before and play a bit with this just to be familiar. Now you have created your first real GUI application for Symbian devices. You are thinking now it work for emulator and you want to test it to your device? Wait this is not difficult also. Now we can do it without understanding much, in later tutorial we try to understand more details about how this is really working.

• Select hellogui (or something other if you have given other name of your project) in the project explorer,
• Right click on it and select properties (at the bottom of pupup menu),
• Select Carbide C++ and Carbide Build configuration from left window,
• Now you change active configuration to Phone Debug (Armv5) and press OK.

Now you rebuild the project and you see there is a file name with extension .sisx has been created in sis folder. This is the file we can install it to our phone. Take the file and send it to phone by any means (USB, Bluetooth or Infrared) and install it to device. Open the application in your phone and play with your own application.