[Previous] [Contents] [Index] [Next]

Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

Common Wizards Reference

You can select a topic from this diagram:

Utilities Used by the IDE Getting System Information Using Code Coverage Common Wizards Reference Preparing Your Target Developing Photon Applications Developing C/C++ Programs Where Files Are Stored Building OS and Flash Images Migrating to the 6.3 Release Tutorials IDE Concepts About This Guide Analyzing Your System With Kernel Tracing Profiling an Application Finding Memory Errors Debugging Programs Managing Source Code Launch Configurations Reference

Workflow diagram with wizards chapter highlighted


This chapter describes the IDE's wizards.


In this chapter...

Introduction

Wizards guide you through a sequence of tasks, such as creating a new project or converting an existing non-IDE project to a QNX C/C++ application or library project.

Wizards aren't directly connected to any perspective. You can access all the project creation wizards from the main menu by selecting File-->New-->Other....

In the New Project dialog, the wizards are categorized according to the nature of the project. If you expand C, you'll see all projects that have a C nature; expand QNX, and you'll see all the projects with a QNX nature:

Common wizards dialog

Notice the overlap: the QNX C Project wizard appears in both C and QNX.

Besides the nature-specific wizards, the IDE also has "simple" wizards that deal with the very basic elements of projects: Project, Folder, and File. These elements have no natures associated with them. You can access these wizards by selecting File-->New-->Other...-->Simple.


Note: Although a project may seem to be nothing other than a directory in your workspace, the IDE attaches special meaning to a project -- it won't automatically recognize as a project any directory you happen to create in your workspace.

But once you've created a project in the IDE, you can bring new folders and files into your project folder, even if they were created outside the IDE (e.g. using Windows Explorer). To have the IDE recognize such folders and files:

=>> In the Navigator view, right-click the navigator pane and select Refresh.

Creating a C/C++ project

You use the New Project wizard to create a C or C++ project, which can be one of these varieties:

QNX C Project (application)
QNX C++ Project (application)
A C or C++ application for multiple target platforms. It supports the QNX-specific project structure using common.mk files to perform a QNX recursive make.
Note: If you open a common.mk file in the editor, you can toggle the display to reveal hidden internal code by clicking the expand icon in the editor:

common.mk toggle


QNX C Project (library)
QNX C++ Project (library)
A library that other projects can reference. In most other respects, library projects resemble QNX C/C++ application Projects.
Standard Make C Project
Standard Make C++ Project
A basic C or C++ project that uses a standard Makefile and GNU make to build the source files. You don't get the added functionality of the QNX build organization and the common.mk file, but these standard projects adapt well to your existing code that you wish to bring into the IDE. (For more about makefiles and the make utility, see the Conventions for Makefiles and Directories appendix in the Programmer's Guide.)

As a rule, the IDE provides UI elements to control most of the build properties of QNX projects, but not of Standard Make projects (unless you consider a makefile a "UI element").

How to create a C/C++ project

To create a C/C++ project :

  1. From the menu, select File-->New-->Project....
  2. In the left pane, select the project's nature according to this table:
    If you want to build: Select:
    Standard Make C project C
    QNX C application project C or QNX
    QNX C library project C or QNX
    Standard Make C++ application project C++
    QNX C++ application project C++ or QNX
    QNX C++ library project C++ or QNX
  3. In the right pane, select the type of project that you want (e.g. QNX C Project).
  4. Click Next.
  5. Give your project a name.

    Even though it allows it, don't use any of the following characters in your project name (they'll cause problems later): | ! $ ( " ) & ` : ; \ ' * ? [ ] # ~ = % < > { }

  6. Ensure that Use Default Location is checked.
  7. Select the type (application or library):

    Type field

    If you're building a library, see below.

  8. Click Next. The wizard displays the appropriate tabs.
  9. Select each tab and fill in the required information. The fields for each tab are described in the "Tabs in the New C/C++ Project wizard" section, below.
  10. Click Finish. The IDE creates your new project in your workspace.

Note: In the C/C++ Development perspective, you can also access the QNX C/C++ Projects wizards via the New C/C++ Project button:

Icon: New C/C++ Project


If you're building a library project

You'll need to choose the type of library you wish to build:

Library types

Static library (libxx.a)
Combine binary object files (i.e. *.o) into an archive that will later be directly linked into an executable.
Shared library (libxx.so)
Combine binary objects together and join them so they're relocatable and can be shared by many processes. Shared libraries are named using the format libxx.so.version, where version is a number with a default of 1. The libxx.so file will be a symbolic link to the latest version.
Static library for shared objects (libxxS.a)
Same as static library, but using position-independent code (PIC). Use this if you want a library that will later be linked into a shared object. The System Builder uses these types of libraries to create new shared libraries that contain only the symbols that are absolutely required by a specific set of programs.
Shared library without export (xx.dll)
A shared library without versioning. Generally, you manually open the library with the dlopen() function and look up specific functions with the dlsym() function.

If you're building a Standard Make C/C++ project

Since this type of project doesn't use the QNX recursive multivariant makefile structure, you'll have to set up your own makefile.

Here's how to create a simple "Hello World" non-QNX project:

  1. Open the New Project wizard.
  2. Select Standard Make C (or C++) Project, then click Next.
  3. Name your project, then click Finish. The IDE has now created a project structure.

    Even though it allows it, don't use any of the following characters in your project name (they'll cause problems later): | ! $ ( " ) & ` : ; \ ' * ? [ ] # ~ = % < > { }

  4. Now you'll create a makefile for your project. In the Navigator, highlight your project, then click the Create a File button on the toolbar:

    Create file button

  5. Name your file "Makefile" and click Finish. The editor should now open, ready for you to create your Makefile.

    Here's a sample Makefile you can use:

    CC:=qcc
    
    hello: hello.c
    
    all: hello
    
    clean:
        rm -f hello.o hello

    Note: Use Tab characters to indent commands inside of make rules, not spaces.

  6. When you're finished editing, save your file (right-click, then select Save, or click the Save button in the tool bar).
  7. Finally, you'll create your "hello world" C (or C++) source file. Again, open a new file, which might look something like this when you're done:
    #include <stdlib.h>
    #include <stdio.h>
    
    int main(int argc, char *argv[]) {
        printf("Hello, world!\n");
        return EXIT_SUCCESS;
    }

Tabs in the New C/C++ Project wizard

Depending on the type of project you choose, the New Project wizard displays different tabs:

QNX C or C++ application or library project
Tabs:
Standard Make C or C++ project
Tabs:

Build Variants tab

The Build Variants tab lets you choose the platforms to compile executables for:

Common wizards: C/C++ Projects; Build Variants tab


Note: By default, all platforms are enabled. You might want to set your preferences for QNX projects to build only for the specific target platforms you want. To do this, open Window-->Preferences-->QNX-->New Project-->Build Variants.

Click the Select All button to enable all of the listed variants, or the Deselect All button to disable all of the listed variants.

You can click the Add button to add a new variant under the currently selected target architecture, or the Delete button to remove the currently selected variant.

You must choose at least one platform to be the default build variant:

  1. Select the build variant you want as the default.
  2. Click the Default button.

    The variant's name changes to include "- default" and a blue exclamation mark is displayed beside it to indicate that it is now the default build variant.

Projects tab

The Projects tab lets you specify your preferred order of building:

Common wizards: C/C++ Projects; Projects tab

For example, if you associate myProject with mySubProject, the IDE builds mySubProject first when you rebuild all your projects. If you change mySubProject, the IDE doesn't automatically rebuild myProject.

Make Builder tab

The Make Builder tab lets you configure how the IDE handles make errors, what command to use to build your project, and when to do a build:

Common wizards: C/C++ Projects; Build Settings field

Build Setting
If you want the IDE to stop building when it encounters a make or compile error, check Stop on Error. Otherwise, check Keep Going On Error.
Build Command
If you want the IDE to use the default make command, check Use Default. If you want to use a different utility, uncheck Use Default and enter your own command in the Build Command field (e.g. C:/myCustomMakeProgram).
Workbench Build Behavior
You can specify how you want the IDE to build your project:

Error Parsers

The Error Parsers tab lets you specify which build output parsers (e.g. Intel C/C++ Compiler Error Parser, CDT GNU Assembler Error Parser, etc.) apply to this project and in which order. To change the order, simply select an item, then use the Up or Down buttons to position the item where you want in the list.

Common wizards: C/C++ Projects; Error Parsers tab

Options tab

The Options tab lets you specify several attributes for the project you're building:

Common wizards: C/C++ Projects; Options tab

General options
By default, some project properties (e.g. active targets) are local -- they're stored in the .metadata folder in your own workspace. If you want other developers to share all of your project's properties, then set Share all project properties on. The IDE then stores the properties in a .cdtproject file, which you can save in your version control system so that others may share the project file.
Build Options
If you want to profile your application and take full advantage of the QNX Application Profiler, then check Build with Profiling (see the Profiling an Application chapter in this guide).

If you want use the QNX Code Coverage tool, then check Build with Code Coverage (see the Using Code Coverage chapter in this guide).

If you want the IDE to do more dependency checking than it normally would, then set the Enhanced dependency checking option on. Note that this will mean slower builds, so you may want to turn this off in order to improve build times.

Binary Parser tab

If you're building a Standard Make C/C++ project, then this tab lets you define which binary parser (e.g. ELF Parser) should be used to deal with the project's binary objects.

Binary Parser tab (New Project wizard)

Discovery Options tab

If you're building a Standard Make C/C++ project, then this tab lets you control how include paths and C/C++ macro definitions for this particular project are automatically discovered. Certain features of the IDE (e.g. syntax highlighting, code assistance, etc.) rely on this information, as do source-code parsers.

Discovery Options tab (New Project wizard)


Note: At a later time, you can supply this data using the Search Paths item in project's Properties.

C/C++ Indexer tab

If you're building a Standard Make C/C++ project, then this tab lets you control the C/C++ source code indexer. Certain features of the IDE rely on this information.

C/C++ Indexer tab (New Project wizard)

Creating a target

You must create a Target System Project for every target you want to use with the IDE.

To create a new target:

  1. From the menu, select File-->New-->Project....
  2. In the left pane, select QNX.
  3. In the right pane, select QNX Target System Project.
  4. Click Next. The New QNX Target System Project wizard appears:

    Common wizards: New Target System Project

  5. Complete the fields described below:
    Target Name
    Type a descriptive name for your QNX Target System Project.
    Project contents
    Check Use default to store it in your workspace, or turn this option off and select another location in the Directory field.
    QNX Connector Selection
    Type the target connection in the Hostname or IP and Port fields. If you're running the IDE on a QNX Neutrino machine running qconn, then check Use local QNX Connector; the IDE automatically fills in the connection information. (If you wish to connect to a different target, you may turn Use local QNX Connector off, and then fill in the fields manually.)
    Target Configuration
    This section is for a future feature.
  6. Click Finish. Your new QNX Target System Project appears in the Navigator view. When you create a launch configuration, the target is listed under the Main tab in the Target Options pane. Note that you can use the Add New Target button in the Target Options pane to open the New Target System Project wizard.
    Note: You can also reach the New Target System Project wizard from within the Target Navigator (right-click, then select Add New Target).

Converting projects

At various times, you may need to convert non-QNX projects to QNX projects (i.e. give them a QNX nature). For example, suppose another developer committed a project to CVS without the .project and .cdtproject files. The IDE won't recognize that project as a QNX project when you check it out from CVS, so you'd have to convert it. Or, you may wish to turn a Standard Make C/C++ project into a QNX C/C++ project in order to take advantage of the QNX recursive makefile hierarchy (a project with a QNX nature causes the IDE to use the QNX make tools and structure when building that project).

The IDE lets you convert many projects at once, provided you're converting all those projects into projects of the same type.


Note: If you wish to convert a QNX project back into a Standard Make C/C++ project, you can use the Convert C/C++ Projects wizard. From the main menu, select File-->New-->Other.... Expand C, then select Convert to a C or C++ Project.

Converting to a QNX project

To convert a non-QNX project to a QNX Project:

  1. From the menu, select File-->New-->Other....
  2. Expand QNX.
  3. Select Convert to a QNX Project.
  4. Click Next. The Convert C/C++ Projects wizard appears.

    Convert to QNX Project wizard

  5. Select the project(s) you want to convert in the Candidates for conversion field.
  6. Specify the language (C or C++).
  7. Specify the type of project (application or library).
  8. Click Finish. Your converted project appears in the C/C++ Projects view and the Navigator view.

Note: You now have a project with a QNX nature, but you'll need to make further adjustments (e.g. specify a target platform) via the Properties dialog if you want it to be a working QNX Project.

Completing the conversion

The conversion wizard gave your Standard Make project a QNX nature; you now need to use the Properties dialog to fully convert your project to a working QNX Project.

To bring up the Properties dialog of a project:

  1. In the C/C++ Projects or Navigator view, right-click your project.
  2. Select Properties from the context menu. The Properties dialog appears:

    Properties dialog

  3. In the left pane, select QNX C/C++ Project.
  4. Specify the properties you want using the available tabs:
    Options
    See the section "Tabs in the New C/C++ Project wizard" above.
    Build Variants
    See the section "Tabs in the New C/C++ Project wizard" above.
    General
    In the Installation directory field, you can specify the destination directory (e.g. bin) for the output binary you're building. (For more information, see the Conventions for Makefiles and Directories appendix in the Programmer's Guide.)

    In the Target base name field, you can specify your binary's base name, i.e. the name without any prefixes or suffixes. By default, the IDE uses your project name as the executable's base name. For example, if your project is called "Test_1," then a debug version of your executable would be called "Test_1_g" by default.

    In the Use file name, enter the name of the file containing the usage message for your executable. (For more on usage messages, see the entry for usemsg in the Utilities Reference.

    Compiler
    See the section Compiler tab below.
    Linker
    See the section Linker tab below.
    Make Builder
    See the section "Tabs in the New C/C++ Project wizard" above.
    Error Parsers
    See the section "Tabs in the New C/C++ Project wizard" above.
  5. When you've finished specifying the options you want, click Apply, then OK. The conversion process is complete.

Compiler tab

The Compiler tab changes depending on which of the three categories you select:

Compiler tab, Project properties

Compiler type
If you've selected General options, the first item you specify is the type of compiler. Currently, the choices are:
Output options
Here you can specify the warning level (0 to 9), i.e. the threshold level of warning messages that the compiler outputs. You can also choose to have the preprocessor output intermediate code to a file; the IDE will name the output file your_source_file.i (C) or your_source_file.ii (C++), using the name of your source file as the base name.
Code generation
For the Optimization level, you can specify four levels: from 0 (no optimization) to 3 (most optimization). In the Stack size field, you can specify the stack size, in bytes or kilobytes.
Definitions field
Here you can specify the list of compiler defines to be passed to the compiler on the command line in the form -D name[=value], but you don't have to bother with the -D part; the IDE adds it automatically.
Other options field
Here you can specify any other command-line options that aren't already covered in the Compiler tab. For more information on the compiler's command-line options, see qcc in the Utilities Reference.
Extra source paths
If you want to specify source locations other than your project's root directory, select this category. Then click the appropriate button to specify the location:
Extra include paths
You can specify a list of directories where the compiler should look for include files. The options here are the same as for Extra source paths, except that here you can change the order of directories in the list, which can be important if you happen to have more than one header file with the same name.

Linker tab

The Linker tab changes depending on which of the four categories you select:

Linker tab, Project properties

Export symbol options
This field lets you define the level of final stripping of your binary, ranging from exporting all symbols to removing just the debugger symbols to removing them all.
Generate map file
If you set this option on, the IDE will print a link map to the build console.
Build goal name
Specify the output filename for an application or library project. Note that the name you enter in this field will force the library's shared-object name to match.

By default, a generated application will have the same name as the project it's built from. A library will have prefix of "lib" and a suffix of ".a" or ".so" after the project name. In addition, debug variants of applications and libraries have a suffix of "_g."

Link against CPP library (valid for C++ projects only)
Select the particular C++ library you want to use. QNX Momentics currently ships with these C++ libraries:

Compiling C++ code without support for exceptions usually results in a faster executable.

Library shared object name
You can use this field to override the shared-object name used in C/C++ library projects. Note that this will not affect the actual filename.
Note: If you specify a filename in the Build goal name field, don't use the Library shared object name field.

Library version
This dropdown list lets you select a version number for both the library's shared-object name and filename. If this is a library that doesn't have a version number (e.g. "platform.so"), then select "No."

Note that you can still set the library version even if Build goal name is specified.

Other options field
Here you can specify any other command-line options that aren't already covered in the Linker tab. For more information on the linker's options, see the entry for ld in the Utilities Reference.
Extra library paths
Select this category if you want to specify locations where the linker should look for import libraries (.so or .a files). Then click the appropriate button to specify the location. (These buttons work the same as those in the Compiler tab when you select Extra source paths.)
Extra libraries
Here you can add a list of libraries (.so or .a files) to search for unsatisfied references. For each item in this list, you can define:
Note: Adding a new element to the extra library list automatically adds the directory where this library resides to the Extra library paths list (see above), if it's not already there. But if you remove an item from the list, its parent directory is not automatically removed.

You can add a library in two ways:

Extra object files
This lets you link a project against any object file or library, regardless of the filename.
Note: The file-selection dialog may seem slow when adding new files. This is because the system can't make assumptions about naming conventions and instead must use a binary parser to determine if a file is an object file or a library.

Note also that the Extra object files option is available for an individual platform only. If a project has more than one active platform, you can't use this feature. In that case, you can still specify extra object files using the Advanced mode for each platform separately.


Post-build actions
When you select this category and click the Add button, you'll see a dialog that lets you select one of four predefined post-build actions for your project:

In the What field, you specify the item (e.g. application) you want to copy or move; in the Where field, you specify the destination. You can use the To Workspace or To Filesystem buttons to locate the place.

If you select Rename result, a New Name field appears for you to enter the name. If you select Other command, enter the shell command in the field.

Note that you can set up more than one post-build action; each will be processed sequentially.

Advanced/regular modes

The Properties dialog can appear in two different modes: regular (default) and advanced.

To activate the advanced mode, press the Advanced button at the bottom of the dialog.

To return to regular mode, press the Regular button.

In advanced mode, you can override various options that were set at the project level for the particular build variant you've selected:

For example, you can change the optimization level for a particular C file, specify which set of import libraries to use for a specific architecture, and so on.

Advanced properties

During the final build, the IDE will merge the options you've set for the project's general configuration with the advanced options, giving priority to the advanced settings.

Importing projects

Use the Import wizard to bring resources into your workspace from a filesystem, ZIP archive, or CVS repository.

To bring up the Import wizard:

=>> Choose File-->Import....

Or

Right-click in the Navigator or C/C++ Projects view, then choose Import....


Import wizard


The Import wizard


The Import wizard can import resources from several different sources:

Existing Container Project into Workspace

To import a container project and its associated C/C++ projects from another workspace:

  1. In the Import wizard, choose Existing Container Project into Workspace and click the Next button.

    The IDE displays the Import Container Project From File System panel.


    Import container  project


    Importing a container project

    
    
  2. Enter the full path to an existing container project directory in the Project contents field, or click the Browse... button to select a container project directory using the file selector.

    Click Next to continue. The IDE displays the Select components to install panel.


    Container  components


    Selecting container components to import

    
    
  3. By default, every project reference by the container project will also be imported. To exclude certain projects, expand the project tree and de-select projects you don't want to import.

    Click Finish to import the container project and its sub-projects.

Existing Project into Workspace

To copy an existing project from another workspace:

  1. In the Import wizard, choose Existing Project into Workspace and click the Next button.

    The IDE displays the Import Project From Filesystem panel.


    Import existing  project


    Importing an existing project

    
    
  2. Enter the full path to an existing project directory in the Project contents field, or click the Browse... button to select a project directory using the file selector.
  3. Click the Finish button to import the selected project into your workspace.

External Features

Eclipse developers use this for developing IDE plug-ins and features.

External Plug-ins and Fragments

Eclipse developers use this for developing IDE plug-ins and features.

File System

To copy files and folders from your filesystem into an existing project in your workspace:

  1. In the Import wizard, choose File System and click the Next button.

    The IDE displays the File system panel.


    File system


    Importing code from the filesystem

    
    
  2. Enter the full path to the code in the From directory field, or click the Browse... button to select a source directory.
  3. Use the Filter Types..., Select All and Deselect All buttons to control which files will be imported.

    Click a directory on the left panel to see a list of files in the right panel.


    Select types


    The Select Types dialog lets you filter imported files by selecting one or more extensions.

    
    
  4. Enter the name of a project or folder in the Into folder field, or click the Browse... button to select one.
    Note: This project or folder must already exist before you bring up the Import wizard.


    Import Into  Folder


    Browsing for a project or folder

    
    
  5. To overwrite existing files, check the Overwrite existing resources without warning box.
  6. To import only the selected folders, check Create selected folders only.

    To import the selected folder and all sub folders, check Create complete folder structure.

  7. Click Finish to import the selected resources.

GCC Coverage Data from Project

The GCC Coverage Data from Project option in the Import wizard lets you import code coverage data from applications that have been run outside of the IDE.

For example, in a self-hosted build environment, if you run a code coverage enabled program from the command-line, it will write code coverage data into a programname.da file in the same directory as the program's code.

To import code coverage data:

  1. In the Import wizard, choose GCC Coverage Data from Project and click the Next button.

    The IDE displays the GCC Coverage Import panel.


    GCC Coverage Data


    Importing GCC coverage data

    
    
  2. Enter a code coverage session name in the Session name field.
  3. Enter a project name in the Project field, or click the Browse... button to select a project.
  4. Click Next to continue.

    The IDE displays the next panel.


    Importing code  coverage


    Referenced projects and comments

    
    
  5. To include code coverage data from referenced projects, select them in the Referenced projects to include coverage data from list.
  6. To include any comments with the new code coverage session (such as details about the data you're importing), enter them in the Comments for this coverage session field.
  7. Click Finish to import the code coverage data as a new session in the Code Coverage Sessions view.

QNX Board Support Package

To copy a Board Support Package (BSP) into your workspace:

  1. In the Import wizard, choose QNX Board Support Package and click the Next button.

    The IDE displays the Import QNX BSP panel.


    Import BSP


    Importing a BSP

    
    
  2. Select an installed BSP from the Known Packages list.

    You can also enter the full path to a BSP archive (.zip file) in the Filename field, or click the Select Package... button to browse to a BSP archive.

    Click Next to continue.

    The IDE displays the Select Source Projects panel.


    Import BSP source projects


    Selecting source projects from a BSP archive

    
    
  3. All of the projects in the BSP archive are imported by default. Uncheck any projects you don't need to import. Click Next to continue.

    The IDE displays the Select Working Set panel.


    Import BSP working set


    Selecting a working set from a BSP archive

    
    
  4. To change the working set name for the imported projects, enter a new working set name in the Working Set Name field, or select one from the drop-down list.

    To change the project name prefix, enter a new prefix in the Project Name Prefix field. This will be prepended to the name of each project imported from the BSP archive.

    To change the destination directory for the projects, enter a new path in the Directory for Projects field, or click the Browse... button to select one. The default is your IDE workspace.

    Click Finish to import the BSP projects.

    The IDE imports the selected projects from the BSP archive and displays the Build Projects dialog.


    Build Projects


    Building BSP projects

    
    
  5. Click Yes to build all of the BSP projects that were just imported. Click No to return to the IDE.

QNX mkifs Buildfile

The IDE can import the .build files used by mkifs into an existing System Builder project.

To import a mkifs .build file:

  1. In the Import wizard, choose QNX mkifs Buildfile and click the Next button.

    The IDE displays the Import mkifs Buildfile panel.


    Import mkifs Buildfile


    Importing a mkifs .build file

    
    
  2. Enter the full path to a mkifs .build file in the Select the file to import field, or click the Browse... button to select one.
  3. Click the Browse... button beside Select the destination project to select a destination for this import.

    The IDE displays the Select System Builder Project dialog.


    Select a destination


    Selecting a destination System Builder project

    
    
  4. Select one or more project, then click OK.

    The IDE imports the selected .build file's System Builder configuration.

QNX Source Package

To copy a QNX Source Package into your workspace:

  1. In the Import wizard, choose QNX Source Package and click the Next button.

    The IDE displays the Import QNX Source Package panel.


    Import QNX Source Package


    Importing a QNX Source Package

    
    
  2. Select an installed source package from the Known Packages list.

    You can also enter the full path to a source package (.zip file) in the Filename field, or click the Select Package... button to browse to a source package.

    Click Next to continue.

    The IDE displays the Select Source Projects panel.


    Import source package projects


    Selecting source projects from a source package

    
    
  3. All of the projects in the source package are imported by default. Uncheck any projects you don't need to import. Click Next to continue.

    The IDE displays the Select Working Set panel.


    Import BSP working set


    Selecting a working set from a BSP archive

    
    
  4. To change the working set name for the imported projects, enter a new working set name in the Working Set Name field, or select one from the drop-down list.

    To change the project name prefix, enter a new prefix in the Project Name Prefix field. This will be prepended to the name of each project imported from the source package.

    To change the destination directory for the projects, enter a new path in the Directory for Projects field, or click the Browse... button to select one. The default is your IDE workspace.

    Click Finish to import the projects.

    The IDE imports the selected projects from the source package and displays the Build Projects dialog.


    Build Projects


    Building package projects

    
    
  5. Click Yes to build all of the projects that were just imported. Click No to return to the IDE.

Team Project Set

Team project sets are a convenient way of distributing a collection of projects stored in a CVS server among members of your development team. Create them with the Export wizard.

To import a team project set and the projects it references:

  1. In the Import wizard, choose Team Project Set and click the Next button.

    The IDE displays the Import a Team Project Set panel.


    Import team project set


    Importing a Team Project Set

    
    
  2. To create a working set for the imported projects, check the Create a working set containing the imported projects box, and enter a name for the working set in the Working Set Name field.

    Click Finish to import the projects from the CVS repository.

Zip file

To copy files and folders from a ZIP archive into an existing project in your workspace:

  1. In the Import wizard, choose Zip File and click the Next button.

    The IDE displays the Zip File panel.


    Zip import


    Importing code from a ZIP archive

    
    
  2. Enter the full path to the ZIP archive in the From zip file field, or click the Browse... button to select a ZIP archive.
  3. Use the Filter Types..., Select All and Deselect All buttons to control which files will be imported.

    Click a directory on the left panel to see a list of files in the right panel.


    Select types


    The Select Types dialog lets you filter imported files by selecting one or more extensions.

    
    
  4. Enter the name of a project or folder in the Into folder field, or click the Browse... button to select one.
    Note: This project or folder must already exist before you bring up the Import wizard.


    Import Into  Folder


    Browsing for a project or folder

    
    
  5. To overwrite existing files, check the Overwrite existing resources without warning box.
  6. To import only the selected folders, check Create selected folders only.

    To import the selected folder and all sub folders, check Create complete folder structure.

  7. Click Finish to import the selected resources.

[Previous] [Contents] [Index] [Next]