Carbide Help

# HG changeset patch # User fturovic # Date 1239304443 18000 # Node ID 61ef8f7de1aaf1174d4bd86f3ffad63a4282d79a # Parent 5464a0b24d87aac71154f3a7e88aca5abdd8def3 updated welcome section of manual, bug fixes, and TOC diff -r 5464a0b24d87 -r 61ef8f7de1aa core/com.nokia.carbide.cpp.doc.user/html/bugs_fixed.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/bugs_fixed.htm Tue Apr 07 15:28:30 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/bugs_fixed.htm Thu Apr 09 14:14:03 2009 -0500 @@ -15,9 +15,7 @@

Carbide.c++ bugs fixed

This is a comprehensive list of bugs fixed by release:

Bugs Fixed in 2.0.4
Bugs Fixed in 2.1.0

Bugs Fixed in v2.0.4

8050 - Fixed an issue that preventing the building of a target when another target of the same project is being debugged.
8282 - Fixed several issues with PRJ_EXTENSION that prevented resource building under SBSv1.
8694 - Fixed an issue that prevented building a project using SBSv2 when the workspace and kit resided on different drives.
8804 - Fixed a problem where the number of build errors reported wasn't consistent between the Console and Problem views.

Bugs Fixed in v2.0.3

Carbide Help

The Carbide IDE provides a wealth of help resources you can tap into to make learning and using Carbide easy. They include:

Welcome pages — the Welcome pages provide links to what's new, bug fixes, examples, and internet resources. They provide all the information you need to learn about new features and capabilites. Click Help > Welcome to view the various pages.
Manuals — extensive documentation on all aspect of Carbide, Carbide tools, SDKs, and more, are available by clicking Help > Help Content and then choosing the manual to read.
Cheat sheets — cheat sheets provide interactive assistance for many common tasks. They appear in their own view and allow you to step through the instructions at your own pace. Click Help > Cheat Sheets, then select the cheat sheet to open.
F1 support — press F1 to open a informational Help view about the currently selected view or dialog.
Hover help support — hover the pointer over a symbol in any C/C++ editor and a popup appears with related information. If the symbol represents a Symbian API call then Symbian API information appears.

References

Carbide.c++ Overview

Carbide.c++ Installation

You must install Carbide.c++ on a computer in order to create Symbian programs.

NOTE Also, see Carbide.c++ Requirements to ensure you have everything required to develop Symbian programs.

Installing Carbide.c++

Launch the Carbide.c++ installer

The first page of install wizard appears.

Follow install wizard instructions and accept default settings
Click Finish in installer window

The installer exits.

Install a software development kit (SDK) for Symbian development

You must have at least one Symbian OS SDK's installed to develop programs for Symbian devices. See System Requirements for a complete list of supported SDKs.

Install Perl

Download and install ActivePerl-5.6.1.635.

Install the “Symbian Connect” software that came with your phone

You need software that communicates with the target device from your PC. For more information, see Deploying Programs to Devices.

Carbide Overview

Carbide is an integrated development environment (IDE) designed to develop Symbian applications for mobile devices. Carbide is built using the open source Eclipse and C/C++ development toolkit (CDT) projects as its base with a wealth of additional tools that make it ideal for developing mobile applications. Carbide includes all the tools necessary to develop mobile applications including editors, GUI designers, project management tools, source code analysis tools, compilers, debuggers, profilers, on-device agents, revision control systems,and much more.

The basic structure of creating applications is easy to understand. You create a project, add some code, compile it into an executable file, then test it on an emulator, a simulator, or the actual device. If the application is compiled for debugging you can also control the program from within Carbide to ensure that the program behaves as expected using breakpoints, watchpoints, view variables, memory, stack traces, and other intimate details of the program as it runs.

To learn more about Carbide, see the following topics:

Carbide.c++ Installation

System Requirements

You use the Carbide.c++ IDE in conjunction with a recognized SDK to develop Symbian software.

In practice, whether you use an SDK, a developer kit (DevKit), or both depends on the edition of - Carbide.c++ you have (see Table 1). Further, if you use an OS devkit, - it must be version 9.1b or higher for EKA2 with - Platform Security support.

Table 1. Support packages used for development with each Carbide.c++ Editions

Carbide.c++ Edition	Support Packages - Used for Software Development	What You Can Do...
Developer / Professional	An SDK or OS developer kit (DevKit) including: - 9.x or higher for Platform Security -	Targets: S60 5th and 3rd Ed., Qt, UIQ - Debugger: Emulators, on-device debugging
OEM	Targets: S60 5th and 3rd Ed., Qt, UIQ - Debugger: Emulators, on-device debugging, device debugging in ROM, kernel debugging - Performance Investigator: application performance data, memory usage, power usage, button event reporting

Carbide.c++ Edition

Support Packages
- Used for Software Development

What You Can Do...

Developer / Professional

An SDK or OS developer kit (DevKit) including:

9.x or higher for Platform Security

Targets: S60 5th and 3rd Ed., Qt, UIQ

Debugger: Emulators, on-device debugging

OEM

Targets: S60 5th and 3rd Ed., Qt, UIQ

Debugger: Emulators, on-device debugging, device debugging in ROM, kernel debugging

Performance Investigator: application performance data, memory usage, power usage, button event reporting

Table 2. System Requirements

Hardware	- x86-based personal computer - 1800MHz - 1GB of RAM minimum, recommend 2GB or more - CD-ROM drive - -
Operating System	Microsoft® Windows® XP (Service Pack 2) recommended, Microsoft® Windows® Vista® supported - NOTE While Carbide.c++ supports many different OS configurations, only the ones listed here provide for optimal Symbian development. - NOTE If you experience any VM issues, see the Tips & Hints page for info on modifying Carbide's default memory setup.
Other Software	A Symbian OS™ SDK and Perl: - - S60 Platform SDKs (forum.nokia.com/main/resources/tools_and_sdks/carbide/) - - S60 5th Edition - S60 3rd Edition, FP1 - S60 3rd Edition, MR - S60 3rd Edition - - - Qt - (www.trolltech.com) - - Qt SDK for S60 - - - UIQ SDKs (www.uiq.com) - - UIQ 3.1 - UIQ 3.0 - - - - Perl (www.activestate.com) - (required) - - ActivePerl-5.6.1.635 - - Symbian Connect software - Software that communicates between a PC and a target device. For example, Nokia PC Suite. -
Disk Space	- 700 MB for Carbide.c++ - Up to 1.5 GB per S60 SDK - 1.5 GB for each Symbian OS™ SDK installation -

Carbide.c++ Installation

System Requirements

You use the Carbide.c++ IDE in conjunction with a recognized SDK to develop Symbian software.

In practice, whether you use an SDK, a developer kit (DevKit), or both depends on the edition of + Carbide.c++ you have (see Table 1). Further, if you use an OS devkit, + it must be version 9.1b or higher for EKA2 with + Platform Security support.

Table 1. Support packages used for development with each Carbide.c++ Editions

Carbide.c++ Edition	Support Packages + Used for Software Development	What You Can Do...
Developer / Professional	An SDK or OS developer kit (DevKit) including: + 9.x or higher for Platform Security +	Targets: S60 5th and 3rd Ed., Qt, UIQ + Debugger: Emulators, on-device debugging + UI Designer: create graphical interfaces quickly using standard UI components
OEM	Targets: S60 5th and 3rd Ed., Qt, UIQ + Debugger: Emulators, on-device debugging, device debugging in ROM, kernel debugging + Performance Investigator: application performance data, memory usage, power usage, button event reporting

Carbide.c++ Edition

Support Packages
+ Used for Software Development

What You Can Do...

Developer / Professional

An SDK or OS developer kit (DevKit) including:

9.x or higher for Platform Security

Targets: S60 5th and 3rd Ed., Qt, UIQ

Debugger: Emulators, on-device debugging

UI Designer: create graphical interfaces quickly using standard UI components

OEM

Targets: S60 5th and 3rd Ed., Qt, UIQ

Debugger: Emulators, on-device debugging, device debugging in ROM, kernel debugging

Performance Investigator: application performance data, memory usage, power usage, button event reporting

Table 2. System Requirements

Hardware	+ x86-based personal computer + 1800MHz + 1GB of RAM minimum, recommend 2GB or more + CD-ROM drive + +
Operating System	Microsoft® Windows® XP (Service Pack 2) recommended, Microsoft® Windows® Vista® supported + NOTE While Carbide.c++ supports many different OS configurations, only the ones listed here provide for optimal Symbian development. + NOTE If you experience any VM issues, see the Tips & Hints page for info on modifying Carbide's default memory setup.
Other Software	A Symbian OS™ SDK and Perl: + + S60 Platform SDKs (forum.nokia.com/main/resources/tools_and_sdks/carbide/) + + S60 5th Edition + S60 3rd Edition, FP1 + S60 3rd Edition, MR + S60 3rd Edition + + + Qt + (www.trolltech.com) + + Qt SDK for S60 + + + UIQ SDKs (www.uiq.com) + + UIQ 3.1 + UIQ 3.0 + + + + Perl (www.activestate.com) + (required) + + ActivePerl-5.6.1.635 + + Symbian Connect software + Software that communicates between a PC and a target device. For example, Nokia PC Suite. +
Disk Space	+ 700 MB for Carbide.c++ + Up to 1.5 GB for each S60 SDK installation +

References

Carbide.c++ Overview

Carbide Tools

References

Carbide.c++ Overview

Updating Carbide.c++

Updates to Carbide.c++ current features are available using the Software Updates feature.

Carbide is a collection of difference software projects combined into a working environment for Symbian OS C/C++ development. At its base Carbide uses Eclipse and CDT projects from Eclipse.org. We then modify some of these base plug-ins to work with our Carbide plug-ins. This is important for you to know as any updates to those modified base plug-ins may cause Carbide to not work as intended.

IMPORTANT We recommend that you not install any updates for Carbide.c++ features except for those provided by Nokia via Software Update. Replacing any standard Eclipse plugin with an updated version from a non-Nokia update site can result in Carbide.c++ no longer working as intended.

Select Help > Software Updates > Find and Install... to display the Install/Update dialog. Select "Search for new features to install" and click Next.

Figure 1 - Install/Update Dialog

Select the Carbide.c++ Update Site option and click Finish.

Figure 2 - Update Sites

For more information visit the Carbide site online at http://www.forum.nokia.com/main/resources/tools_and_sdks/carbide_cpp/.

Updating Carbide.c++

Updates to Carbide.c++ current features are available using the Software Updates feature.

Installing Carbide Updates

Select Help > Software Updates > Find and Install... to display the Install/Update dialog. Select "Search for new features to install" and click Next. +
+
Figure 1 - Install/Update Dialog
Select the Carbide.c++ Update Site option and click Finish. +
+
Figure 2 - Update Sites
Select the Carbide.c++ features to install, then click Next +
+
Figure 3 - Search results showing Carbide features available
+
Accept with the license + terms and click Next. +
+
Figure 4 - Update Sites
Select where the new feature should be installed, then click Finish. +
+
Figure 5 - Update Sites

Carbide downloads the selected features and installs them. You may need to relaunch Carbide.c++ to access the newly installed capabilities.

References

Carbide.c++ Overview

- + + + + + - - - -