# HG changeset patch # User fturovic # Date 1279141159 18000 # Node ID 94b6d13265348d418bcb278878760b0358cfb02a # Parent 1828ccdd6878b5ad111201a5a7b1c4337439685c revised dll example with new images, TOC, and welcome page diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/html/projects/images/dll_attach_to_process.png Binary file core/com.nokia.carbide.cpp.doc.user/html/projects/images/dll_attach_to_process.png has changed diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/html/projects/images/dll_build_project.png Binary file core/com.nokia.carbide.cpp.doc.user/html/projects/images/dll_build_project.png has changed diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/html/projects/images/dll_change_debug_process.png Binary file core/com.nokia.carbide.cpp.doc.user/html/projects/images/dll_change_debug_process.png has changed diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/html/projects/images/dll_change_remote_connection.png Binary file core/com.nokia.carbide.cpp.doc.user/html/projects/images/dll_change_remote_connection.png has changed diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/html/projects/images/dll_new_launch_config.png Binary file core/com.nokia.carbide.cpp.doc.user/html/projects/images/dll_new_launch_config.png has changed diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/html/projects/images/dll_other_settings.png Binary file core/com.nokia.carbide.cpp.doc.user/html/projects/images/dll_other_settings.png has changed diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/html/projects/images/new_dll_project_02.png Binary file core/com.nokia.carbide.cpp.doc.user/html/projects/images/new_dll_project_02.png has changed diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/html/projects/images/new_dll_project_03.png Binary file core/com.nokia.carbide.cpp.doc.user/html/projects/images/new_dll_project_03.png has changed diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/html/projects/images/new_dll_project_04.png Binary file core/com.nokia.carbide.cpp.doc.user/html/projects/images/new_dll_project_04.png has changed diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/html/projects/images/new_dll_project_07.png Binary file core/com.nokia.carbide.cpp.doc.user/html/projects/images/new_dll_project_07.png has changed diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_dll_example_00.htm --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_dll_example_00.htm Wed Jul 14 15:59:19 2010 -0500 @@ -0,0 +1,22 @@ + + + + + + +Creating and Debugging DLL Projects Tutorial + + + +

Creating and Debugging DLL Projects Tutorial

+

In this example we show how to create a project for a DLL (Dynamic Linked Library) using one of the built-in Carbide templates, how to build it into an executable, and how to launch the debugger to verify program accuracy. The steps to do this include:

+
    +
  1. Creating a project from a project template
    2. +
  2. Building an executable based on the project sources
    3. +
  3. Debugging the DLL using the Carbide debugger
    4. +
+

NOTE There must be at least one recognized SDK installed before you can create a project. See the SDK Preferences panel to determine if the installed SDKs are recognized by Carbide.c++ IDE. If the SDK you have installed is not recognized, you may still be able to add it to the Discovered Symbian OS SDK list.

+ + + + \ No newline at end of file diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_dll_example_01.htm --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_dll_example_01.htm Wed Jul 14 15:59:19 2010 -0500 @@ -0,0 +1,66 @@ + + + + + + +Creating DLL Projects Tutorial + + + +

Creating DLL Projects Tutorial

+

In this example we show how to create a project for a DLL (Dynamically Linked Library) using one of the built-in Carbide templates, build it, then attach to another program for debugging. The steps to do this include:

+
    +
  1. Creating a DLL project from a project template
    2. +
  2. Building the DLL object code based on the project sources
    3. +
  3. Debugging the DLL using the Carbide debugger
    4. +
+

NOTE There must be at least one recognized SDK installed before you can create a project. See the SDK Preferences panel to determine if the installed SDKs are recognized by Carbide.c++ IDE. If the SDK you have installed is not recognized, you may still be able to add it to the Discovered Symbian OS SDK list.

+
+

In this tutorial you'll create a simple DLL project using the New Symbian OS C++ Project wizard, attach it to the HelloWorld project created here, then debug it.

+
+

Creating a DLL project from a template

+
    +
  1. Click the File > New > Symbian OS C++ Project menu option.
    +

    The New Symbian OS C++ Project window appears to guide you through project creation process.

    +

    New DLL project

    +
    2. +
  2. Select a template from the available options, then click Next.
    +

    Select the template for the type of project you want to create. For this example we chose the Generic Symbian OS > Baisc dynamically linked library (DLL) template. Note that as you select a template a brief description appears below the list explaining it attributes.

    +
    3. +
  3. Use the New Symbian OS C++ Project page to define the project name and build system.
    +

    New Symbian OS C++ Project page

    +
      +
    1. Type a name into the Project name text box.
      +

      The project name is used to define several of the pre-build source files in the prject.

      +
      2. +
    2. (Optional) Change the project location.
      +

      Uncheck the Use default location option to specify a different location for the project.

      +
      3. +
    3. Select the Builder type.
      +

      Based on the installed SDKs you can choose between SBSv2 (recommended) and the older SBSv1 build systems.

      +
      4. +
    4. Click Next.
      5. +
    +
    4. +
  4. In the Symbian OS SDKs page, select the SDK and build configurations for the project.
    +

    Here you can select from any SDK that is both installed and recognized by Carbide. If the SDK supports several build configurations (GCCE, RVCT, etc.) then you can pick and choose among them for your project.

    +

    Symbian OS SDKs page

    +
    5. +
  5. (Optional) Click Next to provide Basic Settings like author, copyright and other info for your project.
    6. +
  6. (Optional) Click Next to rename the Project Directories used to organize the project.
    7. +
  7. Click Finish.
    +

    Carbide uses the selected project template and your settings to create the DLL project in the Project Explorer view.

    +

    DLL project in Project Explorer view

    +
    8. +
+
+

NEXT STEP > Building the object code based on the project sources

+

Other references

+ + + + + \ No newline at end of file diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_dll_example_02.htm --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_dll_example_02.htm Wed Jul 14 15:59:19 2010 -0500 @@ -0,0 +1,48 @@ + + + + + + +Building the DLL Project Tutorial + + + +

Building the DLL Project Tutorial

+

In this example we show how to create a project for a DLL (Dynamic Linked Library) using one of the built-in Carbide templates, how to build it into an executable, and how to launch the debugger to verify program accuracy. The steps to do this include:

+
    +
  1. Creating a DLL project from a project template
    2. +
  2. Building the DLL object code based on the project sources
    3. +
  3. Debugging the DLL using the Carbide debugger
    4. +
+
+

Building a DLL is just like building any other executable.

+
+

Building the DLL project

+
    +
  1. Select the project to build in the Project Explorer view.
    2. +
  2. Build the project using one of these actions: +
    +
      +
    • Right-click the project in the Project Explorer view and choose Build Project.
      • +
    • Click the Run > Build Project menu option.
      • +
    • Click the Build (Build Project icon) icon in the toolbar to build the project.
      • +
    +
    3. +
  3. Verifying a successful project build
    +
    4. +
+
+

Once compiling is complete use the Project Explorer, Problems, Console, and Executables views to locate and resolve any problems generated during the build. See Step 2 here for more details.

+

Project Explorer showing DLL project

+
+
+

NEXT STEP > Defining a launch configuration for running or debugging the DLL

+

Other references

+ + + + + \ No newline at end of file diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_dll_example_03.htm --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_dll_example_03.htm Wed Jul 14 15:59:19 2010 -0500 @@ -0,0 +1,65 @@ + + + + + + +Debugging a DLL Project Tutorial + + + +

Debugging a DLL Project Tutorial

+

In this example we show how to create a project for a DLL (Dynamic Linked Library) using one of the built-in Carbide templates, how to build it into an executable, and how to launch the debugger to verify program accuracy. The steps to do this include:

+
    +
  1. Creating a DLL project from a project template
    2. +
  2. Building the DLL object code based on the project sources
    3. +
  3. Debugging the DLL using the Carbide debugger
    4. +
+
+

With the DLL compiled into object code, it's time to link it to any process running on the target device, then launch it with the debugger. Using the New Launch Configuration Wizard makes doing this quick, easy, and reliable.

+
+

Debugging a DLL project

+
    +
  1. Select the project to launch in the Project Explorer view.
    2. +
  2. Launch a debug session using one of these actions:
    +
      +
    • Right-click the project in the Project Explorer view and choose Debug As > Debug Symbian OS Application on Phone or Simulator menu option.
      • +
    • Click the Run > Debug (F11) menu option.
      • +
    • Click the Debug (Debug icon) icon in the toolbar to build the project.
      • +
    +

    The first time you perform any of the following actions, the New Launch Configuration Wizard appears asking for the additional info to connect to a device.

    +

    New Launch Configuration Wizard

    +
    3. +
  3. Provide the wizard the information it needs to complete the Configure launch configuration.
    +

    Complete all of the options below to create a launch connection for the DLL project.

    +
      +
    1. Connect to device — click Change... to select a Current connection, create a new one, or edit the chosen remote connection settings.
      +

      Change connection dialog

      +
      2. +
    2. Debug process — click Change... to open the Change Debug Process dialog. Then select the Attach to process option and click OK
      +

      To debug a DLL you simply need to attach it to any process running on the target device. Setting the Attach to process option will throw up a Attach to Process dialog when you start a debug session.

      +

      Change Debug Process dialog

      +
      3. +
    3. Other Settings — click Change... to open the Other Settings dialog to set a preference for when the project is built during a launch, then click OK.
      +

      Other Settings dialog

      +
      4. +
    4. (Optional) Edit advanced settings before launch — enable this option and click Edit to open the Debug Configurations dialog where you can set more launch options. Click Close to cancel the debug session launch.
      5. +
    +

    The Debug control enables when all the information is complete.

    +
    4. +
  4. Click Debug.
    +

    The debug session is launched and the Attach to Process dialog appears. Select a process and click OK to continue.

    +

    Attach to Process dialog

    +
    5. +

    The DLL is attached to the running process and control returns to the Carbide debugger. From this point you can use all of the Carbide debugger features to debug the DLL as it runs on the device.

    +
+
+

Other references

+ + + + + \ No newline at end of file diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_00.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_00.htm Wed Jul 14 15:00:33 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_00.htm Wed Jul 14 15:59:19 2010 -0500 @@ -4,15 +4,15 @@ -Creating New Projects Tutorial +Creating and Debugging New Projects Tutorial -

Creating New Projects Tutorial

+

Creating and Debugging New Projects Tutorial

In this example we show how to create a new project using one of the built-in Carbide templates, how to build it into an executable, and how to launch the debugger to verify program accuracy. The steps to do this include:

  1. Creating a project from a project template
    2. -
  2. Building an executable based on the project sources
    3. +
  3. Building an object code based on the project sources
  4. Defining a launch configuration for running or debugging the application
  5. Controlling and debugging the running program using the Carbide debugger
diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_01.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_01.htm Wed Jul 14 15:00:33 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_01.htm Wed Jul 14 15:59:19 2010 -0500 @@ -12,7 +12,7 @@

In this example we show how to create a new project using one of the built-in Carbide templates, how to build it into an executable, and how to launch the debugger to verify program accuracy. The steps to do this include:

  1. Creating a project from a project template
    2. -
  2. Building an executable based on the project sources
    3. +
  3. Building the object code based on the project sources
  4. Defining a launch configuration for running or debugging the application
  5. Controlling and debugging the running program using the Carbide debugger
@@ -25,7 +25,7 @@

The New Symbian OS C++ Project window appears to guide you through project creation process.

New Symbian OS C++ Project window

-
  • Select a template from the available, then click Next.
    +
  • Select a template from the available options, then click Next.

    Select the template for the type of project you want to create. For this example we chose the S60 > GUI Application template. Note that as you select a template a brief description appears below the list explaining it attributes.

  • Use the New Symbian OS C++ Project page to define the project name and build system.
    @@ -56,7 +56,7 @@ NEXT STEP > Building an executable based on the project sources

    Other references

    diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_02.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_02.htm Wed Jul 14 15:00:33 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_02.htm Wed Jul 14 15:59:19 2010 -0500 @@ -12,7 +12,7 @@

    In this example we show how to create a new project using one of the built-in Carbide templates, how to build it into an executable, and how to launch the debugger to verify program accuracy. The steps to do this include:

    1. Creating a project from a project template
      2. -
    2. Building an executable based on the project sources
      3. +
    3. Building the object code based on the project sources
    4. Defining a launch configuration for running or debugging the application
    5. Controlling and debugging the running program using the Carbide debugger
    @@ -34,6 +34,7 @@

    Building a project

      +
    1. Select the project to build in the Project Explorer view.
    2. Build the project using one of these actions:
        @@ -89,7 +90,8 @@

        Other references

        diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_03.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_03.htm Wed Jul 14 15:00:33 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_03.htm Wed Jul 14 15:59:19 2010 -0500 @@ -12,7 +12,7 @@

        In this example we show how to create a new project using one of the built-in Carbide templates, how to build it into an executable, and how to launch the debugger to verify program accuracy. The steps to do this include:

        1. Creating a project from a project template
          2. -
        2. Building an executable based on the project sources
          3. +
        3. Building the object code based on the project sources
        4. Defining a launch configuration for running or debugging the application
        5. Controlling and debugging the running program using the Carbide debugger
        @@ -57,7 +57,7 @@

        Other references

        diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_04.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_04.htm Wed Jul 14 15:00:33 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_04.htm Wed Jul 14 15:59:19 2010 -0500 @@ -11,12 +11,11 @@

        In this example we show how to create a new project using one of the built-in Carbide templates, how to build it into an executable, and how to launch the debugger to verify program accuracy. The steps to do this include:

        1. Creating a project from a project template
          2. -
        2. Building an executable based on the project sources
          3. +
        3. Building the object code based on the project sources
        4. Defining a launch configuration for running or debugging the application
        5. Launching and debugging an executable using the Carbide debugger
        -

         

        NOTE You can only debug compiled programs. Use the Build Project command to compile project sources into a binary file if you do not already have an executable in the project. A symbolics (.sym) file is also required for debugging on a target device. Ensure that a .sym file has been created. If you are importing an existing application, you may have to rebuild the application and create a related .sym file. Make sure a .sym file has been created in the output directory.

        Launching and debugging an executable

        @@ -59,7 +58,7 @@

        Other references

        diff -r 1828ccdd6878 -r 94b6d1326534 core/com.nokia.carbide.cpp.doc.user/intro/tutorialsCarbideExtContent.xml --- a/core/com.nokia.carbide.cpp.doc.user/intro/tutorialsCarbideExtContent.xml Wed Jul 14 15:00:33 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/intro/tutorialsCarbideExtContent.xml Wed Jul 14 15:59:19 2010 -0500 @@ -20,11 +20,11 @@ - Learn how to create a simple “Test1” DLL project. + Learn how to create and debug DLL projects. + + + + +