Changes between Version 17 and Version 18 of DevelopingSymbianAppWithCarbide


Ignore:
Timestamp:
Dec 30, 2007 2:09:20 PM (16 years ago)
Author:
bennylp
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • DevelopingSymbianAppWithCarbide

    v17 v18  
    4141=== Nokia PC Suite === 
    4242 
    43 Install PC Suite, connect your device with the USB cable, and make sure your PC can access your device. Leave PC Suite running with the device connected throughout this tutorial session. 
     43Install PC Suite, connect your device with the USB cable, and make sure your PC can access your device.  
     44 
     45==== Connect Data Cable ==== 
     46 
     47Connect the USB cable to the phone, and on the phone, select '''PC Suite''': 
     48 
     49[[Image(phone_usb.JPG)]] 
     50 
     51If this is the first time you connect your phone to the PC, then it may take some time for Windows to install the USB drivers for the phone. Wait for it to complete and the Nokia PC Suite and PC Sync icons on the task bar tray become green: 
     52 
     53[[Image(pc_suite.JPG)]] 
     54 
     55Leave PC Suite running with the device connected using the USB cable throughout this tutorial session. 
    4456 
    4557=== PJSIP === 
    4658 
    47 Checkout PJSIP from the usual location (see [http://www.pjsip.org/download.htm PJSIP Download page] for details). Fill in your {{{config_site.h}}} with: 
     59Retrieve and configure PJSIP: 
     60 1. For this tutorial, I assume pjsip will be checked out to {{{C:\project\pjproject}}} directory. 
     61 1. Checkout PJSIP from the usual location (see [http://www.pjsip.org/download.htm PJSIP Download page] for details).  
     62 1. Fill in your {{{config_site.h}}} with: 
    4863{{{ 
    4964#include <pj/config_site_sample.h> 
     
    6883[[Image(file_import.JPG)]] 
    6984 
    70 This dialog below will pop up. Select '''Symbian OS Bld.inf file''' from the list, then press '''Next''' button: 
     85This dialog below will pop up. Select '''Symbian OS''' --> '''Symbian OS Bld.inf file''' from the list, then press '''Next''' button: 
    7186 
    7287[[Image(import.JPG)]] 
     
    110125=== Select the Build Configuration === 
    111126 
    112 First select the build target by selecting '''Project''' --> '''Active Build Configuration''' from main menu, or right clicking the ''Bld.inf'' or ''pjproject'' item from ''Symbian Project Navigator'' pane from the bottom left part of the main window.  
     127First select the build target by selecting '''Project''' --> '''Active Build Configuration''' from main menu (or right clicking the ''Bld.inf'' or ''pjproject'' item from ''Symbian Project Navigator'' pane from the bottom left part of the main window).  
    113128 
    114129Select '''Phone Debug (GCCE) [S60_3rd_MR]''' from the menu: 
     
    122137[[Image(build.JPG)]] 
    123138 
    124 Wait for the build process to complete. Once it completes, watch out for any errors in the ''Problems'' pane (at the bottom center). There shouldn't be any errors, although there may be few warnings which I think can be ignored, for now: 
     139Wait for the build process to complete. You may take a peek on what Carbide is doing by clicking on ''Console'' pane/tab in the bottom part of main window. 
     140 
     141Once it completes, watch out for any errors in the ''Problems'' pane (at the bottom center). There shouldn't be any errors, although there may be few warnings which I think can be ignored, for now: 
    125142 
    126143[[Image(build_problems.JPG)]] 
     
    139156=== Set the .pkg File to be Used === 
    140157 
    141 First we'll need to configure the .pkg file to be used to generate the .sis file. PJSIP provides some sample .pkg files which can be used, however there may be few editing needed befor you can use them (this is because the .pkg file contains absolute directory path for your Symbian SDK, which may be different on your installation). 
     158First we'll need to configure the .pkg file to be used to generate the .sis file. PJSIP provides some sample .pkg files which can be used, however there may be few editing needed before you can use them (this is because the .pkg file contains absolute directory path for your Symbian SDK, which may be different on your installation). 
    142159 
    143160Assign the .pkg file to be used by the project by selecting Project Properties: 
     
    147164Then Project Properties dialog will appear. On this dialog: 
    148165 
    149  1. Select ''Carbide Build Configuration'' from the tree. 
    150  1. Make sure that the Active Configuration is set to '''Phone Debug (GCCE) [S60_3rd_MR]''' 
     166 1. Select ''Carbide Build Configuration'' from the tree (left part of the dialog). 
     167 1. Make sure that the Active Configuration is set to '''Phone Debug (GCCE) [S60_3rd_MR]''' (the SDK name will be different, if you use different SDK version) 
    151168 1. Set the ''PKG File'' by clicking ''Browse...'' button, and choose {{{symbian_ua.pkg}}} from PJSIP's {{{build.symbian}}} directory. 
    152169 
     
    159176Press ''OK'' button to save the project configuration. 
    160177 
    161 Now right click '''bld.inf''' and click '''Refresh''': 
     178Now right click '''bld.inf''' (or '''pjproject''') and click '''Refresh''': 
    162179 
    163180[[Image(project_refresh.JPG)]] 
     
    181198Check that: 
    182199 - the SDK path is correct 
    183  - later, if you ever want to create the Release version of the application, you will need to rename '''UDEB''' to '''UREL'''. But we can leave this to '''UDEB''' for now, since we want the Debug version of the application. 
    184  
    185 Once you are done with the modification, save the file. We can close the file editor window now. 
     200 - later, if you ever want to create the Release version of the application, you will need to rename '''UDEB''' to '''UREL'''. But we can leave this to '''UDEB''' for now, since we want the Debug version of the application. Alternatively, you may also create another PKG file for the Release build. 
     201 
     202Once you are done with the modification, save the file. We can close the PKG file editor window now. 
    186203 
    187204 
     
    190207Once PKG has been setup on the project, a SIS file will be created everytime we build the project. So lets build the project now. 
    191208 
    192 Right click ''pjproject'' and select '''Build Target Only''': 
     209Right click '''bld.inf''' or '''pjproject''' from the ''Symbian Project Navigator'' pane, and select '''Build Target Only''': 
    193210 
    194211[[Image(build.JPG)]] 
    195212 
    196 The build process will start. You can take a peek on the '''Console''' tab to see what's being done. Once the build process completes, you should see something like this on the  
    197  
    198 '''Console''' tab: 
     213The build process will start. You can take a peek on the '''Console''' tab to see what's being done. Once the build process completes, you should see something like this on the '''Console''' tab: 
    199214 
    200215{{{ 
     
    207222 
    208223 
    209 Check the '''Problems''' tab again to see if we have any errors (there shouldn't). 
     224Check the '''Problems''' tab again to see if we have any errors (there shouldn't be any). 
    210225 
    211226 
     
    215230== Configuring On-Device Debugging == 
    216231 
    217 === Connect Data Cable === 
    218  
    219 Connect the USB cable to the phone, and on the phone, select '''PC Suite''': 
    220  
    221 [[Image(phone_usb.JPG)]] 
    222  
    223 If this is the first time you connect your phone to the PC, then it may take some time for Windows to install the USB drivers for the phone. Wait for it to complete and the Nokia PC Suite and PC Sync icons on the task bar tray become green: 
    224  
    225 [[Image(pc_suite.JPG)]] 
    226  
     232Make sure the phone is connected to the PC using the data cable. 
    227233 
    228234=== Installing TRK Application on the Phone === 
    229235 
    230 Install TRK support on the phone. The TRK application can be found in {{{C:\Program Files\Nokia\Carbide.c++ v1.2\plugins\com.nokia.carbide.trk.support_1.2.0.29\trk\s60}}} directory. For my phone, the one that works is {{{s60_3_0_app_trk_2_7.sisx}}}. Right click this .sisx file and select '''Install with Nokia Application Installer''': 
     236Install TRK support on the phone. The TRK application can be found in '''{{{C:\Program Files\Nokia\Carbide.c++ v1.2\plugins\com.nokia.carbide.trk.support_1.2.0.29\trk\s60}}}''' directory. For my phone, the one that works is '''{{{s60_3_0_app_trk_2_7.sisx}}}'''. Right click this .sisx file and select '''Install with Nokia Application Installer''': 
    231237 
    232238[[Image(trk_path.JPG)]]