Symbian Build System (SBSv2)

# HG changeset patch # User fturovic # Date 1281037279 18000 # Node ID 490bb9a68e6b5f9253915a631866c6478704f281 # Parent 2771fd853ac28615e91de9c07ca3f03ced823b9e draft of sbsv2 concept and related index, trk, and TOC changes diff -r 2771fd853ac2 -r 490bb9a68e6b core/com.nokia.carbide.cpp.doc.user/html/concepts/concepts.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/concepts.htm Thu Aug 05 14:24:42 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/concepts.htm Thu Aug 05 14:41:19 2010 -0500 @@ -36,6 +36,7 @@

diff -r 2771fd853ac2 -r 490bb9a68e6b core/com.nokia.carbide.cpp.doc.user/html/concepts/sbsv2.htm --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/sbsv2.htm Thu Aug 05 14:41:19 2010 -0500 @@ -0,0 +1,47 @@ + + + + + + +Symbian Build System (SBSv2) + + + +

Symbian Build System (SBSv2)

Carbide.c++ v3.x fully supports the Symbian Build System (SBSv2) for building Symbian executables. Codenamed RAPTOR, SBSv2 is also designed to overcome several limitations in GNU Make, including:

modularity and code re-use
separation of interface and implementation
extensibility
testability

In addition, SBSv2:

is supported on the Windows and Linux operating systems
is more scalable than previous systems
supports incremental and parallel builds
offers more flexibility in build configurations
offers an overall 20% speed improvement

SBSv2 also supports the use of build variants. A variant is basically something which modifies a build. For example, a variant could be the standard ARMv5 build with Demand Paging functions enabled. Already defined variants are found in the Build > SBSv2 preference panel.

NOTE Carbide no longer supports the ABLD system. Use Carbide.c++ v2.7 instead if you require SBSv1 support.

Preferences for configuring SBSv2 is found by clicking Window > Preferences > Carbide.c++:

Build > SBSv2 – control general build options like clean, test components, dependency tracking, concurrent build jobs, build behavior, and emulator options
Build Configuration Filtering – controls which platforms are visible when creating new projects or build configurations.
Symbian SDKs – control which installed SDKs are available to projects during project creation or importing.

Every project also has a set of SBSv2 properties to customize:

Properties for project > Carbide.c++ > Project Settings – specifies whether all components or selected subcomponents listed in a build information file (bld.inf) should be built for the currently selected project.

For more information on SBSv2, see the Symbian Foundation's wiki article Introduction to RAPTOR and others.

Other References

Concepts

+ + + + \ No newline at end of file diff -r 2771fd853ac2 -r 490bb9a68e6b core/com.nokia.carbide.cpp.doc.user/html/concepts/trk.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/trk.htm Thu Aug 05 14:24:42 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/trk.htm Thu Aug 05 14:41:19 2010 -0500 @@ -4,20 +4,20 @@ -On-device Debugging +TRK On-device Debugging -

On-device Debugging

The on-device debug agent (Application TRK or System TRK) is a program that enables on-device debugging of phone prototypes, reference boards, and retail phones. An on-device debug agent is a program that is installed on a phone or reference board. It communicates with the debugger using a serial-over-Bluetooth or serial-over-USB connection. Through this serial communication, the on-device debug agent acts as the interface between the Carbide.c++ debugger and the target device. An on-device debug agent provides:

TRK On-device Debugging

The on-device TRK remote agent (Application TRK or System TRK) is a program that enables on-device debugging of phone prototypes, reference boards, and retail phones. An on-device debug agent is a program that is installed on a phone or reference board. It communicates with the debugger using a serial-over-Bluetooth or serial-over-USB connection. Through this serial communication, the on-device debug agent acts as the interface between the Carbide.c++ debugger and the target device. An on-device debug agent provides:

Debug agent running on Symbian OS
Provides a stable & integrated interface to Symbian OS
Used to debug applications on actual devices
Can be built-in to the OS image or installed as a .sis file

Using the on-device debug agent, one can use the Carbide.c++ IDE to debug programs running on phone hardware, making the debugging process much easier. The on-device debug agent works on all S60 3rd Edition devices, UIQ 3rd Edition devices, and Symbian TechView devkits.

The Application TRK debug agents are stored online and can be downloaded and installed using the On-Device Connections > New Connection Wizard > Install remote agents pane.

Using the on-device remote agent, one can use the Carbide.c++ IDE to debug programs running on phone hardware, making the debugging process much easier. The on-device debug agent works on all Nokia Qt SDK, Symbian^3, and Symbian TechView devkits.

The Application TRK remote agents are stored online and can be downloaded and installed using the On-Device Connections > New Connection Wizard > Install remote agents pane.

Some of the key benefits to using an on-device debug agent include:

Easy debugging via serial interface (Bluetooth, USB, IrDA, etc)
System TRK— supports both application and limited ROM debugging (includes application executables and limited ROM based components (i.e. no device drivers) and available to original equipment manufacturers (OEM) for device creation and customization

NOTE The type of on-device debug agent you have is based upon which Carbide.c++ product you have licensed. System TRK is only available with the Professional or OEM version of the product.

Related tasks

On-device Debugging Overview

Clean level

abld clean erases all files created by a corresponding abld target command (all intermediate files created during compilation and all executables and import libraries created by the linker)

abld reallyclean does what abld clean does, and also removes files exported by abld export and makefiles generated by abld makefile, or the abld test equivalents

sbs clean erases all files created by a corresponding sbs target command (all intermediate files created during compilation and all executables and import libraries created by the linker)

sbs reallyclean does what sbs clean does, and also removes files exported by sbs export and makefiles generated by sbs makefile, or the sbs test equivalents

Keep going

+ +

+ SBSv2 is the new build engine for Symbian programs. Find out more here. + +

+ @@ -30,11 +40,11 @@ - Debugging programs on a target device has never been easier with PnP on-device debugging. + The TRK remote agent now uses TCF for faster, more flexible communication. diff -r 2771fd853ac2 -r 490bb9a68e6b core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml --- a/core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml Thu Aug 05 14:24:42 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml Thu Aug 05 14:41:19 2010 -0500 @@ -102,6 +102,7 @@ +