SDK Support in Concepts

# HG changeset patch # User fturovic # Date 1245877002 18000 # Node ID 8ad872e05db49fe6814e512814483ab5fedf4491 # Parent 1d4b20e576960095b094e5ffcbbdb7ae84b6e90b Merge SDK Support page with Working with SDKs and cleaned up broken links and references to deleted page diff -r 1d4b20e57696 -r 8ad872e05db4 core/com.nokia.carbide.cpp.doc.user/html/concepts/SDKSupport.html --- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/SDKSupport.html Wed Jun 24 14:07:33 2009 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,33 +0,0 @@ - -SDK Support in Concepts - - - -

SDK Support

- -

- The SDK support provided in the workbench allows the developer to choose - which of the installed SDKs to work with. From the chosen SDK, Symbian OS - plug-ins pick-up information such as header files, import libraries, - documentation and other SDK specific information.

You can add and manage SDKs in the SDK Preferences window. The SDK Preferences window lists all - available SDKs and allows you to rescan the drive for newly installed and supported SDKs or remove an existing SDK. - The changes in SDK Preferences are applicable to all projects under that - workspace.

Related tasks

- -

Related references

Working with SDKs
SDK Preferences

- - - - \ No newline at end of file diff -r 1d4b20e57696 -r 8ad872e05db4 core/com.nokia.carbide.cpp.doc.user/html/concepts/concepts.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/concepts.htm Wed Jun 24 14:07:33 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/concepts.htm Wed Jun 24 15:56:42 2009 -0500 @@ -1,34 +1,33 @@ - - - - - - -Concepts - - - -

Concepts

The following concepts provide information on common Carbdie.c++ terminology, technologies, and processes:

- - -

- - + + + + + + +Concepts + + + +

Concepts

The following concepts provide information on common Carbdie.c++ terminology, technologies, and processes:

+ + +

+ + diff -r 1d4b20e57696 -r 8ad872e05db4 core/com.nokia.carbide.cpp.doc.user/html/concepts/contextual_menus.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/contextual_menus.htm Wed Jun 24 14:07:33 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/contextual_menus.htm Wed Jun 24 15:56:42 2009 -0500 @@ -1,44 +1,45 @@ - - - - - - -Context Menus - - - -

Context Menus

A context menu provides a shortcut to frequently used menu commands. The available menu commands change, based on the context of the selected item. For example, the Breakpoints view uses commands that differ from the Editor view.

Sample uses of the context menu for different tasks include:

Editor views - perform editing functions, format, compare, and a host of other file actions
Breakpoints view - enable, disable, remove, or select all breakpoints
Debug view - restart, step into, over, or out of routines, terminate or suspend program execution
Variables view - enable, disable, find, and change the format or value of variables displayed
Memory view - add or remove memory monitors

TIP Experiment using the context menu in various views to discover additional capabilities.

Figure 1 shows a sample context menu in the Breakpoints view.

Figure 1 - Context menu in Breakpoints view

Using Context Menus

Use context menus to apply context-specific commands to selected items.

Right-click or click and hold on an item to open a context menu

-
The context menu appears, displaying menu commands applicable to the selected item or view. - -
-

Related References

Menus

- - - - + + + + + + +Context Menus + + + +

Context Menus

Sample uses of the context menu for different tasks include:

Editor views - perform editing functions, format, compare, and a host of other file actions
Breakpoints view - enable, disable, remove, or select all breakpoints
Debug view - restart, step into, over, or out of routines, terminate or suspend program execution
Memory view - add or remove memory monitors
Project Explorer view - manage projects, build, delete, freeze, run, debug, and other common project commands
Variables view - enable, disable, find, and change the format or value of variables displayed

TIP Experiment using the context menu in various views to discover additional capabilities.

Figure 1 shows a sample context menu in the Breakpoints view.

Figure 1 - Context menu in Breakpoints view

Using Context Menus

Use context menus to apply context-specific commands to selected items.

Right-click or click and hold on an item to open a context menu

+
The context menu appears, displaying menu commands applicable to the selected item or view. + +
+

Related References

Menus

+ + + + diff -r 1d4b20e57696 -r 8ad872e05db4 core/com.nokia.carbide.cpp.doc.user/html/concepts/index.html --- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/index.html Wed Jun 24 14:07:33 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/index.html Wed Jun 24 15:56:42 2009 -0500 @@ -1,44 +1,44 @@ - -Concepts in Symbian OS Eclipse Development User Guide - - - -

Concepts

- - -

- This section of the User Guide provides an overview of the main concepts in - Eclipse to create and build programs for Symbian OS. -

- The Symbian OS plug-ins are a set of Eclipse plug-ins that provide project, - SDK and build support for Symbian OS developers. The plug-ins extend the - functionality provided by Eclipse and the C/C++ Development Toolkit (CDT). -

- The plug-ins simplify Symbian OS development by removing the need to use - command line build tools, and provide a graphical interface to Symbian OS - specific file formats, such as AIF and MBM. -

- The plug-ins provide a new perspective, called the Carbide.c++ Perspective, on - the Eclipse workbench. This perspective enhances the standard CDT C/C++ - perspective by allowing you to select easily the SDKs and build target types - that you want to use for each project. -

- The following topics discuss these concepts in more detail: -

- - - - + +Concepts in Symbian OS Eclipse Development User Guide + + + +

Concepts

+ + +

+ This section of the User Guide provides an overview of the main concepts in + Eclipse to create and build programs for Symbian OS. +

+ The Symbian OS plug-ins are a set of Eclipse plug-ins that provide project, + SDK and build support for Symbian OS developers. The plug-ins extend the + functionality provided by Eclipse and the C/C++ Development Toolkit (CDT). +

+ The plug-ins simplify Symbian OS development by removing the need to use + command line build tools, and provide a graphical interface to Symbian OS + specific file formats, such as AIF and MBM. +

+ The plug-ins provide a new perspective, called the Carbide.c++ Perspective, on + the Eclipse workbench. This perspective enhances the standard CDT C/C++ + perspective by allowing you to select easily the SDKs and build target types + that you want to use for each project. +

+ The following topics discuss these concepts in more detail: +

+ + + + \ No newline at end of file diff -r 1d4b20e57696 -r 8ad872e05db4 core/com.nokia.carbide.cpp.doc.user/html/context_help/carbide_ide_dialogs_help.xml --- a/core/com.nokia.carbide.cpp.doc.user/html/context_help/carbide_ide_dialogs_help.xml Wed Jun 24 14:07:33 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/context_help/carbide_ide_dialogs_help.xml Wed Jun 24 15:56:42 2009 -0500 @@ -1,606 +1,606 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - Use the Carbide Project Settings window to specify project build options. - - - - - - - - The Carbide Build Configurations page allows you to specify SIS file options and environment variable settings for the selected build configuration - - - - - - - - Add or Remove build configurations to current project - - - - - - - - Set global build options - - - - - - - builder_sis_dialog - - - - - - Set global build options - - - - - - Set project macros options - - - - - - - - - - - - - Use the ROM Build Settings panel to specify ROM build commands and working directory. - - - - - - - - - - - Specify the Leavescan directory. - - - - - - - - - - - - - - - Provides options to monitor project changes, emulator variables, and preprocessor symbols. - - - - - - Build information file selection page - - - - - - - MMP Selection Page - - - - - - - Project Properties page - - - - - - - Select an existing project. - - - - - - - - Symbian Project Navigator - - - - - - Use the New MMP Wizard to add an MMP file to the project. - - - - - - ==STUB== - - - - - - - - - - - - - - - - MMP Selection Page - - - - - - - - - - - - View and modify Symbian projects and export files to be included in building your application. - - - - - - - - - View and modify the list of files to be part of the normal build process. - - - - - - - Add and edit paths to exported files. - - - - - - - Add mmp files to the build process. - - - - - - - Add make files to the build process. - - - - - - - - - - - - - Define target information. - - - - - - - - - Define runtime, compiler, and linker options. - - - - - - - - - Define source files to be included in project build process. - - - - - - - - - Add libraries to the project. - - - - - - - - - Add resource files to the project. - - - - - - - - - - Add libraries to your project. - - - - - - - - - Add system resource capabilities to your application. - - - - - - - - - Specify a name for the selected library. - - - - - - - - - Specify user or system include paths. - - - - - - - - - - - - - Use the Select Languages dialog to add or remove languages from a project. - - - - - - - - - - - - - - - Use the MBM and MIF editor to create multi-bitmap or mif files. - - - - - - - - Use the AIF editor to specify the Symbian OS resource file and bitmaps that should be included in a Symbian OS application information (AIF) file. - - - - - - - - Use the add image from project dialog to search for image files in your project. - - - - - - - - - Use the add image from file system dialog to search for image files on your file system. - - - - - - - - - - - - - - - - - - - Use the SDK Preferences page to Add or remove SDKs, or edit SDK properties - - - - - - - - - - Use the SDK Add dialog to Add SDKs to current project - - - - - - - Use the SDK Properties window to examine the properties associated with the currently selected SDK in the SDK Preferences panel. - - - - - - - - Use the SDK Platform Filter window to show only platforms related to selected SDK. - - - - - - - SDKs and Build Configurations - - - - - - - - - - - - - - Use the Remote Connections view to manage your connections. - - - - - - - Use the Edit Connection page to choose a remote connection type. - - - - - - - Use the Settings page to set connection options. - - - - - - - - - - - - - - - - - - - - - - Specify source and header file names and location. - - - - - - - - Enter other properties for generated files. - - - - - - - - - - - - - - Specify project directories for files. - - - - - Enter the basic properties for a project. - - - - - Select a template to base the new project on. - - - - - Specify minimum project properties. - - - - - - - - - - - - Update Carbide.c++ version 1.1 projects to version 1.2. - - - - - - - View, accept, or cancel changes to be performed. - - - - - - - - - - - - Inspect and edit default preprocessor options. - - - - - - Verify which languages should be preprocessed. - - - - - - - - - - - - System search preference options - - - - - - - System search page options - - - - - - - System Search view options - - - - - - - - - - - News Reader preference options - - - - - - - News Reader editor options - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + Use the Carbide Project Settings window to specify project build options. + + + + + + + + The Carbide Build Configurations page allows you to specify SIS file options and environment variable settings for the selected build configuration + + + + + + + + Add or Remove build configurations to current project + + + + + + + + Set global build options + + + + + + + builder_sis_dialog + + + + + + Set global build options + + + + + + Set project macros options + + + + + + + + + + + + + Use the ROM Build Settings panel to specify ROM build commands and working directory. + + + + + + + + + + + Specify the Leavescan directory. + + + + + + + + + + + + + + + Provides options to monitor project changes, emulator variables, and preprocessor symbols. + + + + + + Build information file selection page + + + + + + + MMP Selection Page + + + + + + + Project Properties page + + + + + + + Select an existing project. + + + + + + + + Symbian Project Navigator + + + + + + Use the New MMP Wizard to add an MMP file to the project. + + + + + + ==STUB== + + + + + + + + + + + + + + + + MMP Selection Page + + + + + + + + + + + + View and modify Symbian projects and export files to be included in building your application. + + + + + + + + + View and modify the list of files to be part of the normal build process. + + + + + + + Add and edit paths to exported files. + + + + + + + Add mmp files to the build process. + + + + + + + Add make files to the build process. + + + + + + + + + + + + + Define target information. + + + + + + + + + Define runtime, compiler, and linker options. + + + + + + + + + Define source files to be included in project build process. + + + + + + + + + Add libraries to the project. + + + + + + + + + Add resource files to the project. + + + + + + + + + + Add libraries to your project. + + + + + + + + + Add system resource capabilities to your application. + + + + + + + + + Specify a name for the selected library. + + + + + + + + + Specify user or system include paths. + + + + + + + + + + + + + Use the Select Languages dialog to add or remove languages from a project. + + + + + + + + + + + + + + + Use the MBM and MIF editor to create multi-bitmap or mif files. + + + + + + + + Use the AIF editor to specify the Symbian OS resource file and bitmaps that should be included in a Symbian OS application information (AIF) file. + + + + + + + + Use the add image from project dialog to search for image files in your project. + + + + + + + + + Use the add image from file system dialog to search for image files on your file system. + + + + + + + + + + + + + + + + + + + Use the SDK Preferences page to Add or remove SDKs, or edit SDK properties + + + + + + + + + + Use the SDK Add dialog to Add SDKs to current project + + + + + + + Use the SDK Properties window to examine the properties associated with the currently selected SDK in the SDK Preferences panel. + + + + + + + + Use the SDK Platform Filter window to show only platforms related to selected SDK. + + + + + + + SDKs and Build Configurations + + + + + + + + + + + + + + Use the Remote Connections view to manage your connections. + + + + + + + Use the Edit Connection page to choose a remote connection type. + + + + + + + Use the Settings page to set connection options. + + + + + + + + + + + + + + + + + + + + + + Specify source and header file names and location. + + + + + + + + Enter other properties for generated files. + + + + + + + + + + + + + + Specify project directories for files. + + + + + Enter the basic properties for a project. + + + + + Select a template to base the new project on. + + + + + Specify minimum project properties. + + + + + + + + + + + + Update Carbide.c++ version 1.1 projects to version 1.2. + + + + + + + View, accept, or cancel changes to be performed. + + + + + + + + + + + + Inspect and edit default preprocessor options. + + + + + + Verify which languages should be preprocessed. + + + + + + + + + + + + System search preference options + + + + + + + System search page options + + + + + + + System Search view options + + + + + + + + + + + News Reader preference options + + + + + + + News Reader editor options + + + + + + + + + + + + + + + + + diff -r 1d4b20e57696 -r 8ad872e05db4 core/com.nokia.carbide.cpp.doc.user/html/reference/ProjectPreferences.html --- a/core/com.nokia.carbide.cpp.doc.user/html/reference/ProjectPreferences.html Wed Jun 24 14:07:33 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/ProjectPreferences.html Wed Jun 24 15:56:42 2009 -0500 @@ -1,36 +1,37 @@ - -Project and File Properties - - - -

C/C++ Project and File Properties

- -

- The Properties window allows you to change the general - settings for a project and individual files.

- To change the settings for a project, right-click the project from the Project Explorer, C/C++ Project, or Symbian Project Navigator views, and choose Properties from the context menu. The Properties for <project_name> window will then show all the project settings. If - you alter the settings, then the settings are applied as - defaults for all files in the project. The Carbide.c++ panels include:

Carbide Build Configuration
Carbide Project Settings
Carbide ROM Build Settings
other - additional panels may appear here as well. For example, Carbide CodeScanner.

- To change the settings only for a particular file, right-click the file - from the Project Explorer, C/C++ Project, or Symbian Project Navigator views, and choose Properties from the context menu. The Properties for <file_name> window shows the settings that are - relevant to that file.

- -

Related Tasks

Building Projects

- - - - + +Project and File Properties + + + +

C/C++ Project and File Properties

+ +

+ The Properties window allows you to change the general + settings for a project and individual files.

+ To change the settings for a project, right-click the project from the Project Explorer, C/C++ Project, or Symbian Project Navigator views, and choose Properties from the context menu. The Properties for <project_name> window will then show all the project settings. If + you alter the settings, then the settings are applied as + defaults for all files in the project.

The Carbide.c++ panels include:

Build Configurations
Macro Settings
Project Settings
other - additional panels may appear here as well. For example, CodeScanner and UI Designer, to name two.

+ To change the settings only for a particular file, right-click the file + from the Project Explorer, C/C++ Project, or Symbian Project Navigator views, and choose Properties from the context menu. The Properties for <file_name> window shows the settings that are + relevant to that file.

+ +

Related Tasks

Building Projects

+ + + + \ No newline at end of file diff -r 1d4b20e57696 -r 8ad872e05db4 core/com.nokia.carbide.cpp.doc.user/html/reference/ProjectTypeandSDK.html --- a/core/com.nokia.carbide.cpp.doc.user/html/reference/ProjectTypeandSDK.html Wed Jun 24 14:07:33 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/ProjectTypeandSDK.html Wed Jun 24 15:56:42 2009 -0500 @@ -1,66 +1,61 @@ - - - Symbian OS SDKs - - - -

Symbian OS SDKs

You can set the SDKs and Build Configurations in this page. The available SDKs shown are determined by the settings in the SDK Preferences page.

- - - - - - - - - - - - - - - - -

Name	Functions
- SDKs and Build Configurations -	- Specifies the SDKs and -Build Configurations set for the project being created. You can -select multiple SDKs and build configurations for a project. -
Filter SDKs based on selected template	By default, the Symbian OS SDKs page only displays the templates related to the SDKs used by the project. Uncheck to view all available templates.

- - - - -

NOTE The number and type of SDKs shown are dependent upon the SDKs installed and recognized by Carbide.c++.

Related concepts

- -

SDK Support

Related tasks

Creating New Projects

Related references

Working with SDKs
SDK Preferences

- - - - + + + Symbian OS SDKs + + + +

Symbian OS SDKs

You can set the SDKs and Build Configurations in this page. The available SDKs shown are determined by the settings in the SDK Preferences page.

+ + + + + + + + + + + + + + + + +

Name	Functions
+ SDKs and Build Configurations +	+ Specifies the SDKs and +Build Configurations set for the project being created. You can +select multiple SDKs and build configurations for a project. +
Filter SDKs based on selected template	By default, the Symbian OS SDKs page only displays the templates related to the SDKs used by the project. Uncheck to view all available templates.

+ + + + +

NOTE The number and type of SDKs shown are dependent upon the SDKs installed and recognized by Carbide.c++.

Related tasks

Creating New Projects

Related references

Working with SDKs
SDK Preferences

+ + + + diff -r 1d4b20e57696 -r 8ad872e05db4 core/com.nokia.carbide.cpp.doc.user/html/reference/SDKPreferences.html --- a/core/com.nokia.carbide.cpp.doc.user/html/reference/SDKPreferences.html Wed Jun 24 14:07:33 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/SDKPreferences.html Wed Jun 24 15:56:42 2009 -0500 @@ -1,79 +1,75 @@ - - -SDK Preferences - - - - - -

SDK Preferences

-Use the

-SDK Preferences page in the Preferences window to control which installed SDKs are available to projects during an import. To - access SDK preferences preference panel, select Window > Preferences > Carbide.c++ > SDK Preferences. -

NOTE There must be at least one recognized SDK installed before you can create a project. If the SDK you have installed is not recognized, you may still be able to add it to the Discovered Symbian OS SDK list. See Carbide.c++ Requirements for a list of supported SDKs.

NOTE This panel serves as a devices.xml file editor. The devices.xml file stores information about the installed SDKs used for Symbian OS development.

- -

SDK preferences panel

Figure 1. SDK Preferences preference panel

- - - - - - - - - - - - - - - - - - - - - - - - - - -

Name	Function
Available Symbian OS SDK's	Lists all the installed and recognized SDKs supported by the IDE. Only SDKs supported by the IDE are included in the list. - Checked SDKs indicate build configurations available for creating projects. Unchecked SDKs are not displayed when creating new projects. - SDKs shown in red indicate a problem, usually no EPOCROOT or missing build configurations. - Click on a SDK name to see its EPOCROOT location and build configuration status in the SDK Information area.
Add New SDK	Click to add an SDK to the Available Symbian OS SDKs list.
Remove SDK	Click to remove the selected SDK from the Available Symbian OS SDK's list.
SDK Properties	Click to view and edit the properties of the currently selected SDK in the Available Symbian OS SDKs list.
Listen for devices.xml changes outside of Carbide	Enable of have Carbide issue an alert prompting you to rescan your SDKs when changes to the devices.xml file are made outside of Carbide. When disabled the devices.xml file is not scanned for changes.
Rescan All SDKs	Click to rescan the drive for newly installed SDKs. The devices.xml file is scanned for SDKs and the list of available SDKs is updated if the devices.xml file has changed. - NOTE Carbide.c++ scans for available SDKs each time it is started.

Legacy SDK's

For legacy SDK's the OS/SDK version is determined from the SDK id. Some older SDK's have two verisons, one where the emulator was built with MSVC and the other built with CodeWarrior. We support those SDK's built with CodeWarrior. The id of that SDK is S60_2nd_FP2_CW.

Related concepts

SDK Support

Related tasks

- - - - + + +SDK Preferences + + + + + +

SDK Preferences

+Use the

+SDK Preferences page in the Preferences window to control which installed SDKs are available to projects during an import. To + access SDK preferences preference panel, select Window > Preferences > Carbide.c++ > SDK Preferences. +

NOTE This panel serves as a devices.xml file editor. The devices.xml file stores information about the installed SDKs used for Symbian OS development.

+ +

SDK preferences panel

Figure 1. SDK Preferences preference panel

+ + + + + + + + + + + + + + + + + + + + + + + + + + +

Name	Function
Available Symbian OS SDK's	Lists all the installed and recognized SDKs supported by the IDE. Only SDKs supported by the IDE are included in the list. + Checked SDKs indicate build configurations available for creating projects. Unchecked SDKs are not displayed when creating new projects. + SDKs shown in red indicate a problem, usually no EPOCROOT or missing build configurations. + Click on a SDK name to see its EPOCROOT location and build configuration status in the SDK Information area.
Add New SDK	Click to add an SDK to the Available Symbian OS SDKs list.
Remove SDK	Click to remove the selected SDK from the Available Symbian OS SDK's list.
SDK Properties	Click to view and edit the properties of the currently selected SDK in the Available Symbian OS SDKs list.
Listen for devices.xml changes outside of Carbide	Enable of have Carbide issue an alert prompting you to rescan your SDKs when changes to the devices.xml file are made outside of Carbide. When disabled the devices.xml file is not scanned for changes.
Rescan All SDKs	Click to rescan the drive for newly installed SDKs. The devices.xml file is scanned for SDKs and the list of available SDKs is updated if the devices.xml file has changed. + NOTE Carbide.c++ scans for available SDKs each time it is started.

Legacy SDK's

Related tasks

+ + + + \ No newline at end of file diff -r 1d4b20e57696 -r 8ad872e05db4 core/com.nokia.carbide.cpp.doc.user/html/tasks/AddinganSDK.html --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/AddinganSDK.html Wed Jun 24 14:07:33 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/AddinganSDK.html Wed Jun 24 15:56:42 2009 -0500 @@ -1,49 +1,45 @@ - -Adding an SDK - - - -

Adding an SDK

- -

- The Symbian OS plug-ins can usually detect when a SDK has been installed, - as described in SDK Support.

- To do this: -

-
- Click Window > Preferences to open the Preferences window, then select SDK Preferences in the Carbide.c++ group - to show the page for SDKs.
-

- -

- - -

Click Add New SDK to add a specific SDK or Rescan All SDKs to search the installed SDKs and add them to the Available Symbian OS SDKs list.
-
Click OK to save the settings.

SDK Support

Working with SDKs
SDK Properties

SDK Preferences

- - - - + +Adding an SDK + + + +

Adding an SDK

+ +

+ The Symbian OS plug-ins can usually detect when a SDK has been installed, + as described in SDK Support.

+ To do this: +

+
+ Click Window > Preferences to open the Preferences window, then select SDK Preferences in the Carbide.c++ group + to show the page for SDKs.
+

+ +

+ + +

Click Add New SDK to add a specific SDK or Rescan All SDKs to search the installed SDKs and add them to the Available Symbian OS SDKs list.
+
Click OK to save the settings.

Working with SDKs
SDK Properties

SDK Preferences

+ + + + \ No newline at end of file diff -r 1d4b20e57696 -r 8ad872e05db4 core/com.nokia.carbide.cpp.doc.user/html/tasks/RmvngandVwngPropsosSDK.html --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/RmvngandVwngPropsosSDK.html Wed Jun 24 14:07:33 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/RmvngandVwngPropsosSDK.html Wed Jun 24 15:56:42 2009 -0500 @@ -1,52 +1,48 @@ - -Viewing SDK Properties and Removing SDKs in Working with SDKs - - - - -

Editing SDK Properties

- -

- This section explains how to view and edit properties of an - existing SDK using SDK preferences. For an overview of how the plug-ins handle - SDKs, see SDK Support.

- To edit properties of an existing SDK

- -

-
- Click Window > Preferences to open the Preferences page, then expand Carbide.c++ and select SDK Preferences from the list of preferences - to show the page that allows SDK Preferences to be set.
-

- -

NOTE SDKs shown in red indicate a problem, for example no EPOCROOT.

Select a SDK entry, then click SDK Properties to edit the selected SDK's information
Click OK to accept changes

Related concepts

- -

SDK Support

Related tasks

Working with SDKs
SDK Properties

- - - - + +Viewing SDK Properties and Removing SDKs in Working with SDKs + + + + +

Editing SDK Properties

+ +

+ This section explains how to view and edit properties of an + existing SDK using SDK preferences. For an overview of how the plug-ins handle + SDKs, see Working with SDKs.

+ To edit properties of an existing SDK

+ +

+
+ Click Window > Preferences to open the Preferences page, then expand Carbide.c++ and select SDK Preferences from the list of preferences + to show the page that allows SDK Preferences to be set.
+

+ +

NOTE SDKs shown in red indicate a problem, for example no EPOCROOT.

Select a SDK entry, then click SDK Properties to edit the selected SDK's information
Click OK to accept changes

Related tasks

+ +

Working with SDKs
SDK Properties

+ + + + \ No newline at end of file diff -r 1d4b20e57696 -r 8ad872e05db4 core/com.nokia.carbide.cpp.doc.user/html/tasks/WorkingwithSDKs.html --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/WorkingwithSDKs.html Wed Jun 24 14:07:33 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/WorkingwithSDKs.html Wed Jun 24 15:56:42 2009 -0500 @@ -1,20 +1,27 @@ - -Working with SDKs - - - -

Working with SDKs

- This section explains how to work with SDKs using the tools provided. -

- - - - + +Working with SDKs + + + +

Working with SDKs

The SDK support provided in the workbench allows the developer to choose + which of the installed SDKs to work with. From the chosen SDK, Symbian OS + plug-ins pick-up information such as header files, import libraries, + documentation and other SDK specific information.

You can add and manage SDKs in the SDK Preferences panel. The SDK Preferences panel lists all + available SDKs and allows you to rescan the drive for newly installed and supported SDKs or remove an existing SDK. + The changes in SDK Preferences are applicable to all projects under that + workspace.

Related references

+ + + \ No newline at end of file diff -r 1d4b20e57696 -r 8ad872e05db4 core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/prj_adding_symbian_class.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/prj_adding_symbian_class.htm Wed Jun 24 14:07:33 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/prj_adding_symbian_class.htm Wed Jun 24 15:56:42 2009 -0500 @@ -1,51 +1,46 @@ - - - - - - -Adding Symbian OS Classes - - - -

Adding Symbian OS Classes

Use the Symbian OS C++ Class wizard to add Symbian OS templated classes to a project.

Adding a Symbian OS C++ Class to a Project

Right-click the project name and select the New > Symbian OS C++ Class menu item.

The Symbian OS C++ Class Wizard window appears (Figure 1).

Figure 1 - Symbian OS C++ Class Wizard window

Select the project to add the new class to, then click Next.

The Name and Location page appears (Figure 2).

location

Figure 2 - Symbian OS C++ Class Wizard window's Name and Location page

Enter class name and header and source directory information, and optionally enable filenames to be lowercase, then click Next.

The Templates page appears (Figure 3).

template

Figure 3 - Symbian OS C++ Class Wizard window's Templates page

Click a class template to use for the new class, then click Next.

The Other Settings page appears (Figure 4).

Figure 4 - Symbian OS C++ Class Wizard window's Other Settings page

Enter Author and Copyright information, then click Finish.

The new defined Symbian-based class titled NewClass, is added to the project and appears in the src folder (Figure 5).

Figure 5 -New class appears in C/C++ Projects list inside the project

Related concepts

SDK Support

Related tasks

Adding Classes
New C++ Classs Wizard

- - - + + + + + + +Adding Symbian OS Classes + + + +

Adding Symbian OS Classes

Use the New Symbian OS C++ Class wizard to add Symbian templated classes to a project.

Adding a Symbian OS C++ Class to a Project

Right-click the project name and select the New > Symbian OS C++ Class menu item.

The New Symbian OS C++ Class wizard appears showing the Select project page (Figure 1).

Figure 1 - Symbian OS C++ Class wizard window

Select the project to add the new class to, then click Next.

The Name and Location page appears (Figure 2).

location

Figure 2 - Name and Location page

Enter class name and header and source directory information, and optionally enable filenames to be lowercase, then click Next.

The Select a type of class page appears (Figure 3).

template

Figure 3 - Select a type of class page

Click a class template to use for the new class, then click Next.

The Other Settings page appears (Figure 4).

Figure 4 - Other Settings page

Enter Author and Copyright information, then click Finish.

The new defined Symbian-based class titled NewClass, is added to the project and appears in the src folder (Figure 5).

Figure 5 -New class appears in C/C++ Projects list inside the project

Related tasks

Adding Classes
New C++ Classs Wizard

+ + + \ No newline at end of file diff -r 1d4b20e57696 -r 8ad872e05db4 core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/prj_debug_multiple_projects.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/prj_debug_multiple_projects.htm Wed Jun 24 14:07:33 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/prj_debug_multiple_projects.htm Wed Jun 24 15:56:42 2009 -0500 @@ -1,35 +1,31 @@ - - - - - - -Debugging Multiple Projects - - - -

Debugging Multiple Projects

Use the import Symbian executable feature to import another project's executable into a main project to debug them both in a single debugging session. This works very well when every executable you import uses the same debug launch configuration, enabling you to switch between the various executables as necessary to debug each in turn or together. For example, you could debug an application project as well as the two DLL projects that it uses, in a single debug session.

NOTE You must have the executable's project in order to embed that executable into the main project for debugging.

Configuring to Debug Multiple Projects

Import one or more project executables into the current project

The debugger loads the executable into the project.

Debug the project using the same debug launch configuration

The debugger loads the project and all embedded executables for debugging.

Related Concepts

SDK Support

Related Tasks

- - - + + + + + + +Debugging Multiple Projects + + + +

Debugging Multiple Projects

NOTE You must have the executable's project in order to embed that executable into the main project for debugging.

Configuring to Debug Multiple Projects

Import one or more project executables into the current project

The debugger loads the executable into the project.

Debug the project using the same debug launch configuration

The debugger loads the project and all embedded executables for debugging.

Related Tasks

+ + + \ No newline at end of file diff -r 1d4b20e57696 -r 8ad872e05db4 core/com.nokia.carbide.cpp.doc.user/html/tasks/sdks/sdk_add.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/sdks/sdk_add.htm Wed Jun 24 14:07:33 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/sdks/sdk_add.htm Wed Jun 24 15:56:42 2009 -0500 @@ -1,76 +1,73 @@ - - - - - - -Adding SDKs - - - -

Adding SDKs

Use the Add New SDK window to provide the information Carbide.c++ requires to identify, locate and build a project with the specified SDK.

Figure 1. Add New SDK window

Table 1 Add New SDK window—items

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Item	Explanation
SDK ID	The name used to identify this SDK.
EPOCROOT	The path to EPOCROOT within the SDK. Click Browse to locate and select EPOCROOT.
Vendor	Select the vendor from the drop down list, for example, com.nokia.s60 or com.symbian.TechView -
Is Default	Specify whether or not the selected SDK is the default to use.
OS Version	Specify the operating system version or select Auto detect.
SDK Version	Select the SDK version or Auto detect.

Adding SDKs to Carbide.c++

Click Add New SDK in the SDK Preferences panel

The Add New SDK window (Figure 1) appears.

Enter SDK name, EPOCROOT, and additional information

Enter the requested information in the appropriate fields.

Click OK

The Add New SDK window closes and the SDK is added to the Available Symbian OS SDKs list in the SDK Preferences panel.

- -

Related concepts

SDK Support

Related tasks

Related references

SDK Preferences Panel

- - - + + + + + + +Adding SDKs + + + +

Adding SDKs

Use the Add New SDK window to provide the information Carbide.c++ requires to identify, locate and build a project with the specified SDK.

Figure 1. Add New SDK window

Table 1 Add New SDK window—items

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Item	Explanation
SDK ID	The name used to identify this SDK.
EPOCROOT	The path to EPOCROOT within the SDK. Click Browse to locate and select EPOCROOT.
Vendor	Select the vendor from the drop down list, for example, com.nokia.s60 or com.symbian.TechView +
Is Default	Specify whether or not the selected SDK is the default to use.
OS Version	Specify the operating system version or select Auto detect.
SDK Version	Select the SDK version or Auto detect.

Adding SDKs to Carbide.c++

Click Add New SDK in the SDK Preferences panel

The Add New SDK window (Figure 1) appears.

Enter SDK name, EPOCROOT, and additional information

Enter the requested information in the appropriate fields.

Click OK

The Add New SDK window closes and the SDK is added to the Available Symbian OS SDKs list in the SDK Preferences panel.

+ +

Related tasks

Related references

SDK Preferences Panel

+ + + \ No newline at end of file diff -r 1d4b20e57696 -r 8ad872e05db4 core/com.nokia.carbide.cpp.doc.user/html/tasks/sdks/sdk_add_custkits.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/sdks/sdk_add_custkits.htm Wed Jun 24 14:07:33 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/sdks/sdk_add_custkits.htm Wed Jun 24 15:56:42 2009 -0500 @@ -1,50 +1,42 @@ - - - - - - -Adding Symbian Custom Kits - - - -

Adding Symbian Custom Kits

The Carbide.c++ Developer Edition and higher level products includes functionality to work with Symbian CustKits or any arbitrary SDK source base. This enables you to work with evolving SDKs as they are released.

NOTE The features that enable build support with CustKits are only available for Carbide.c++ Developer Edition and higher level products.

Adding a CustKit without a devices.xml entry

Add SDK

add

Mapping a CustKit SDK to a known SDK release
-
- Use the SDK Properties window to map an unrecognized SDK (S60_3rd_Ed_FP2) to a known version of a similar SDK (S60_3rd_Ed) . This should enable you to import projects against the CustKit SDK.

Figure 1 - SDK Information group showing SDK errors

-
Some issues to look for in the SDK Properties dialog include: -
-

SDK Name — templates and UI designs may not display if the name used is not a known default (e.g. com.nokia.s60) as defined under the SDK properties
OS version — ensure the correct OS version is assigned to the CustKit tells Carbide what platforms the SDK supports
SDK version — used to filter which template projects and/or UI Designer projects are available and the UI components displayed

- - - + + + + + + +Adding Symbian Custom Kits + + + +

Adding Symbian Custom Kits

NOTE The features that enable build support with CustKits are only available for Carbide.c++ Developer Edition and higher level products.

Adding a CustKit without a devices.xml entry

Add SDK

add

Mapping a CustKit SDK to a known SDK release
+
+ Use the SDK Properties window to map an unrecognized SDK (S60_3rd_Ed_FP2) to a known version of a similar SDK (S60_3rd_Ed) . This should enable you to import projects against the CustKit SDK.

Figure 1 - SDK Information group showing SDK errors

+
Some issues to look for in the SDK Properties dialog include: +
+

SDK Name — templates and UI designs may not display if the name used is not a known default (e.g. com.nokia.s60) as defined under the SDK properties
OS version — ensure the correct OS version is assigned to the CustKit tells Carbide what platforms the SDK supports
SDK version — used to filter which template projects and/or UI Designer projects are available and the UI components displayed

Related references

Working with SDKs

+ + + \ No newline at end of file diff -r 1d4b20e57696 -r 8ad872e05db4 core/com.nokia.carbide.cpp.doc.user/html/tasks/sdks/sdk_platform_filter.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/sdks/sdk_platform_filter.htm Wed Jun 24 14:07:33 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/sdks/sdk_platform_filter.htm Wed Jun 24 15:56:42 2009 -0500 @@ -98,18 +98,9 @@

Select this button to obtain a fresh list of configurations from SBSv2. The list is refreshed each time Carbide starts up, but this button will allow users to add configuration xml files and get those new configurations without restarting Carbide.c++.

Related concepts

Related references

SDK Support

Related tasks

Adding SDKs
Searching SDKs

Related references

diff -r 1d4b20e57696 -r 8ad872e05db4 core/com.nokia.carbide.cpp.doc.user/html/tasks/sdks/sdk_search.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/sdks/sdk_search.htm Wed Jun 24 14:07:33 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/sdks/sdk_search.htm Wed Jun 24 15:56:42 2009 -0500 @@ -1,41 +1,36 @@ - - - - - - -Searching for SDKs - - - -

Searching for SDKs

Use the SDK Preferences panel to search for installed Symbian OS SDKs.

Figure 1. SDK Preferences panel

Searching for SDKs

Click Rescan All SDKs in the SDK Preferences panel

Carbide rescans the hard drive searching for install SDKs, adding them to the Available Symbian OS SDKs list.

- -

Related concepts

SDK Support

Related tasks

Adding SDKs
View SDK Properties

Related references

SDK Preferences Panel

- - - + + + + + + +Searching for SDKs + + + +

Searching for SDKs

Use the SDK Preferences panel to search for installed Symbian OS SDKs.

Figure 1. SDK Preferences panel

Searching for SDKs

Click Rescan All SDKs in the SDK Preferences panel

Carbide rescans the hard drive searching for install SDKs, adding them to the Available Symbian OS SDKs list.

+ +

Related references

+ + + \ No newline at end of file diff -r 1d4b20e57696 -r 8ad872e05db4 core/com.nokia.carbide.cpp.doc.user/html/tasks/sdks/sdk_view_properties.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/sdks/sdk_view_properties.htm Wed Jun 24 14:07:33 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/sdks/sdk_view_properties.htm Wed Jun 24 15:56:42 2009 -0500 @@ -1,42 +1,37 @@ - - - - - - -Viewing SDK Properties - - - -

SDK Properties

Use the SDK Properties window to examine the properties associated with the currently selected SDK in the SDK Preferences panel. You can also use this window to map an unrecognized SDK to a known build configuration to use CustKits with a project.

NOTE The SDK Properties dialog box serves as a devices.xml editor for the OEM or Professional Developer edition of Carbide.c++.

SDK Properties window

Figure 1. SDK properties window

Viewing and Modifying SDK Properties

Select an SDK in the Available Symbian OS SDKs list in the SDK Preferences panel
Click SDK Properties -
The SDK Properties window (Figure 1) appears. You can now review an SDKs properties and make modifications if your Carbide.c++ edition supports SDK modification.
-
NOTE Changes are directly applied to the devices.xml file.

- -

Related concepts

SDK Support

Related tasks

Adding SDKs
Searching SDKs

Related references

SDK Preferences Panel

- - - - + + + + + + +Viewing SDK Properties + + + +

SDK Properties

NOTE The SDK Properties dialog box serves as a devices.xml editor for the OEM or Professional Developer edition of Carbide.c++.

SDK Properties window

Figure 1. SDK properties window

Viewing and Modifying SDK Properties

Select an SDK in the Available Symbian OS SDKs list in the SDK Preferences panel
Click SDK Properties +
The SDK Properties window (Figure 1) appears. You can now review an SDKs properties and make modifications if your Carbide.c++ edition supports SDK modification.
+
NOTE Changes are directly applied to the devices.xml file.

+ +

Related references

+ + + + diff -r 1d4b20e57696 -r 8ad872e05db4 core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml --- a/core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml Wed Jun 24 14:07:33 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml Wed Jun 24 15:56:42 2009 -0500 @@ -15,7 +15,6 @@ - @@ -30,23 +29,20 @@ - + + + - - - + + + - - - - - - + @@ -54,12 +50,12 @@ - - + + + - @@ -83,7 +79,7 @@ - + @@ -92,6 +88,7 @@ +