Changes between Version 11 and Version 12 of DevelopingSymbianAppWithCarbide


Ignore:
Timestamp:
Dec 29, 2007 1:38:16 PM (11 years ago)
Author:
bennylp
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • DevelopingSymbianAppWithCarbide

    v11 v12  
    33== Introduction == 
    44 
    5 Previously PJSIP did not support Carbide C++ as the development tools for Symbian target, since Carbide did not import PJSIP's MMP files properly. But with the release of Carbide  
    6  
    7 C++ version 1.2, it seems that Carbide is now able to build PJSIP projects properly. And since it seems that Nokia strongly suggests to use Carbide for the development tools  
    8  
    9 instead of !CodeWarrior, it may worth to write some small documentation to help you get started with developing PJSIP applications on Symbian using this tool. 
     5Previously PJSIP did not support Carbide C++ as the development tools for Symbian target, since Carbide did not import PJSIP's MMP files properly. But with the release of Carbide C++ version 1.2, it seems that Carbide is now able to build PJSIP projects properly. And since it seems that Nokia strongly suggests to use Carbide for the development tools instead of !CodeWarrior, it may worth to write some small documentation to help you get started with developing PJSIP applications on Symbian using this tool. 
    106 
    117This document covers the following topics: 
     
    1915 
    2016For this tutorial, we will need: 
    21  - [http://www.forum.nokia.com/info/sw.nokia.com/id/4a7149a5-95a5-4726-913a-3c6f21eb65a5/S60-SDK-0616-3.0-mr.html Symbian S60 3rd Edition Maintenance Release (MR)]. Other SDK  
    22  
    23 versions may work, but I did not test it. 
    24  - [http://www.forum.nokia.com/info/sw.nokia.com/id/dbb8841d-832c-43a6-be13-f78119a2b4cb.html Carbide C++ version 1.2]. You will need the Developer Edition to do on-device  
    25  
    26 debugging (21 days evaluation is available). 
     17 - [http://www.forum.nokia.com/info/sw.nokia.com/id/4a7149a5-95a5-4726-913a-3c6f21eb65a5/S60-SDK-0616-3.0-mr.html Symbian S60 3rd Edition Maintenance Release (MR)]. Other SDK versions may work, but I did not test it. 
     18 - [http://www.forum.nokia.com/info/sw.nokia.com/id/dbb8841d-832c-43a6-be13-f78119a2b4cb.html Carbide C++ version 1.2]. You will need the Developer Edition to do on-device debugging (21 days evaluation is available). 
    2719 - [http://europe.nokia.com/A4144903 Nokia PC Suite] for the connectivity between the device and your PC (I use version 6.85) 
    2820 - Latest PJSIP from SVN trunk 
     
    4234=== Carbide === 
    4335 
    44 Follow the installation instructions in the Carbide C++ documentation. The installation should be straightforward, but don't forget to '''select the Developer's Edition'''  
    45  
    46 (instead of Personal Edition) to get the On-Device debugging/TRK Debugging feature. 
    47  
    48 (There is a 21 days evaluation period for the Developers Edition. If you have installed Carbide before and your evaluation period is over, you may not be able to select the  
    49  
    50 Developers Edition, and you will have to purchase the Developers license) 
     36Follow the installation instructions in the Carbide C++ documentation. The installation should be straightforward, but don't forget to '''select the Developer's Edition''' (instead of Personal Edition) to get the On-Device debugging/TRK Debugging feature. 
     37 
     38(There is a 21 days evaluation period for the Developers Edition. If you have installed Carbide before and your evaluation period is over, you may not be able to select the Developers Edition, and you will have to purchase the Developers license) 
    5139 
    5240 
     
    8876[[Image(import_bld.JPG)]] 
    8977 
    90 Then on the SDK selection dialog, select the build configurations that you want to support. For this tutorial, select WINSCW and GCCE from S60 3rd Edition MR SDK, and press  
    91  
    92 '''Next''' button: 
     78Then on the SDK selection dialog, select the build configurations that you want to support. For this tutorial, select WINSCW and GCCE from S60 3rd Edition MR SDK, and press '''Next''' button: 
    9379 
    9480[[Image(import_sdk.JPG)]] 
     
    124110=== Select the Build Configuration === 
    125111 
    126 First select the build target by selecting '''Project''' --> '''Active Build Configuration''' from main menu, or right clicking the ''Bld.inf'' or ''pjproject'' item from  
    127  
    128 ''Symbian Project Navigator'' pane from the bottom left part of the main window.  
     112First 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.  
    129113 
    130114Select '''Phone Debug (GCCE) [S60_3rd_MR]''' from the menu: 
     
    138122[[Image(build.JPG)]] 
    139123 
    140 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  
    141  
    142 may be few warnings which I think can be ignored, for now: 
     124Wait 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: 
    143125 
    144126[[Image(build_problems.JPG)]] 
     
    157139=== Set the .pkg File to be Used === 
    158140 
    159 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  
    160  
    161 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). 
     141First 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). 
    162142 
    163143Assign the .pkg file to be used by the project by selecting Project Properties: 
     
    166146 
    167147Then this dialog below will appear. On this dialog: 
     148 
     149[[Image(project_properties_menu.JPG)]] 
     150 
    168151 1. Select ''Carbide Build Configuration'' from the tree. 
    169152 1. Make sure that the Active Configuration is set to '''Phone Debug (GCCE) [S60_3rd_MR]''' 
     
    200183Check that: 
    201184 - the SDK path is correct 
    202  - 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  
    203  
    204 we want the Debug version of the application. 
     185 - 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. 
    205186 
    206187Once you are done with the modification, save the file. We can close the file editor window now. 
     
    242223[[Image(phone_usb.JPG)]] 
    243224 
    244 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  
    245  
    246 PC Suite and PC Sync icons on the task bar tray become green: 
     225If 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: 
    247226 
    248227[[Image(pc_suite.JPG)]] 
     
    251230=== Installing TRK Application on the Phone === 
    252231 
    253 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}}}  
    254  
    255 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''': 
     232Install 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''': 
    256233 
    257234[[Image(trk_path.JPG)]] 
     
    348325 
    349326New configuration will appear on the dialog. We need to edit few things: 
    350  1. Rename the configuration name from '''pjproject Phone Debug...''' to '''symbian_ua Phone Debug...''', as seen in the picture below. (Hints: when we have different executable  
    351  
    352 to debug, we will create different configuration). 
     327 1. Rename the configuration name from '''pjproject Phone Debug...''' to '''symbian_ua Phone Debug...''', as seen in the picture below. (Hints: when we have different executable to debug, we will create different configuration). 
    353328 1. Set the ''Executable'' 
    354329 1. Set the ''Remote process to launch'' 
     
    362337==== Configure TRK Connection ==== 
    363338 
    364 Now select '''Connection''' tab. Choose the '''Serial Port''' to the COM port where your phone connection is mapped to, which you have found out from the step above (look at the  
    365  
    366 Device Manager). In my case, it was COM3: 
     339Now select '''Connection''' tab. Choose the '''Serial Port''' to the COM port where your phone connection is mapped to, which you have found out from the step above (look at the Device Manager). In my case, it was COM3: 
    367340 
    368341[[Image(debug_connection.JPG)]] 
     
    387360Still in the '''Debug''' dialog, press the '''Debug''' button. Hold your breath! 
    388361 
    389 Carbide now may rebuild the project (you may take a peek on what it's doing by looking at '''Console''' tab). Once it's done, Carbide will switch to ''Debug Perspective'' and the  
    390  
    391 SIS file will be downloaded to the phone and this window will appear briefly: 
     362Carbide now may rebuild the project (you may take a peek on what it's doing by looking at '''Console''' tab). Once it's done, Carbide will switch to ''Debug Perspective'' and the SIS file will be downloaded to the phone and this window will appear briefly: 
    392363 
    393364[[Image(debug_download.JPG)]] 
     
    423394 
    424395 
     396---- 
     397 
     398== Other Resources == 
     399 
     400Checkout: 
     401 - [http://newlc.com/Carbide-c-Setting-up-On-Target.html Carbide.c++: Setting up On Target Debugging | NewLC] 
     402 
     403 
     404 
     405 
     406 
     407 
     408 
     409