Full size Banner

Putting your developed application to Symbian Phone

Transferring your application to phone

Let's assume you have created an application and have tested the application with PC environment (with emulator) and you want to put the application to your phone so that you can use the application.

We need to transfer the installable application (it is called in Symbian sis file). If you are not familiar with sis file you could take a look in our download pages where you can see some sis files (ready to installed to compatible devices).

To transfer these sis file to phone you need media and it's associated software. For example

  • Bluetooth
  • If you have Bluetooth in your PC and in phone you can transfer it to phone

  • Infrared
  • If you have Infrared in your PC and in phone you can transfer it to phone

  • USB
  • You can transfer the sis file to phone by USB cable

Nokia provides pc suite software for this purposes and if you want to learn about it and how to use it you could take a look to Nokia PC suite site.

But before that let's take a look how we create a sis file. In this tutorial we shall use our hellosymbian project as a working project. You could use your own project for this purposes also.

You noticed that we don't have sis folder in our hellosymbian project. Now let's create a folder name sis in the same level like group folder.

  • Go to the folder in explorer where is your project located
  • Create a new folder name sis, now the folder structure is like this
  • Create a file name hellosymbian.pkg with the following contents, pkg file is used as input to sis builder what are the files we want to include in the sis file. For our simple application we have only two files,
    hellosymbian.exe
    hellosymbian_reg.RSC
  • In pkg file if a line start with ; then that line is ignored (treated as comment)
; HelloSymbian.pkg
;
;Language - standard language definitions
&EN

; standard SIS file header 0x8FFF1002 is the 3rd UID in our mmp file
#{"HelloSymbian"},(0x8FFF1002),1,0,0

;Localised Vendor name
%{"Vendor-EN"}

;Unique Vendor name
:"Hemelix"

;Supports Series 60 v 3.0
[0x101F7961], 0, 0, 0, {"Series60ProductID"}

;Files to install

"C:\Symbian\9.2\S60_3rd_FP1_5\Epoc32\release\gcce\urel\hellosymbian.exe" -"!:\sys\bin\hellosymbian.exe"
"C:\Symbian\9.2\S60_3rd_FP1_5\Epoc32\Data\z\private\10003a3f\apps\hellosymbian_reg.RSC" -"!:\private\10003a3f\import\apps\hellosymbian_reg.RSC"

  • "C:\Symbian\9.2\S60_3rd_FP1_5\" is called EPOCROOT, this variable is defined when we installed the SDK, it can be different in your PC. Normally EPOCROOT is that path where our Epoc32 folder located
  • If we create our application then we can have different pkg file, for example line 20 can be as follows:
    "$(EPOCROOT)Epoc32\release\$(PLATFORM)\$(TARGET)\hellosymbian.exe" -"!:\sys\bin\hellosymbian.exe"
    where EPOCROOT is system variable (path where is our Epoc32 folder located)
    PLATFORM and TARGET can be configured by Carbide tools which can be gcce or armv5 or some thing else
    TARGET can be configured by Carbide tools which can be udeb (for debug version) or urel (for release version)
    For our simple application we have hardcoded these.
  • Select the project hellosymbian in the carbide project explorer view and do right click on mouse, this will open popup menu and select properties (last item) from there
  • This will bring a dialog like this and fill the edit boxes.

  • Select right platform and release by pressing on Manage

  • Select right package file from sis folder and give final sis file name (extension is sisx) and select self sign sis file

  • Press Apply and OK and build the project, now you see that you have a file hellosymbian.sisx in the sis folder
  • Send the hellosymbian.sisx to phone and try to open it, it will ask if we want to install it. Press OK or continue if some inquiry appear.
  • After installation you go to phone's menu and installation folder and find the hellosymbian application.
  • Open the application and see that hello symbian is printed in a console