PROJECT WINDOW

8.4 PROJECT WINDOW

The Project window contains a summary of information about the project. Select View>Project to alternately view or close the Project window.

• Project Window Display • Project Window Menus • Project Window FAQ

8.4.1 Project Window Display

The title bar of the Project window contains the name of the project workspace. The window itself contains a list of projects and project files by file type in tree format. The general structure of the project tree for a single project is shown in Figure 8-1.

FIGURE 8-1: PROJECT TREE GENERAL STRUCTURE

workspace name project name

file type file

project files

project window open space

If the project name is bolded, it is the active project. If the project name is followed by an asterisk (e.g., c:\project1\project.mcp* ), either the project settings have changed or the project is new, and it needs to be saved.

For information on the types of files listed in this window, see Section 4.5 “Project Folders and Files”.

8.4.2 Project Window Menus

Depending on where you click in the project window, different menus are available. • Display Menu

• Project Menu • File Type Menu • File Menu

DS51519A-page 104

 2005 Microchip Technology Inc.

MPLAB IDE Windows

8.4.2.1 DISPLAY MENU If you right-click on any open space in the project window, a menu with project display

commands will be displayed. • Refresh

This command causes the IDE to go out and check the status of all the files in all projects.

For version-control system files, the files' status is updated in the project window. For missing files that you have relocated, “file not found” text will be removed.

• Preferences Opens a dialog to set project preferences. See Section 9.15 “Project-Display

Preferences Dialog”.

8.4.2.2 PROJECT MENU If you right-click on a project file, a menu with project level commands will be displayed.

• Set Active Select a project as the active project in the workspace. For more on active

projects, see Section 4.9 “Using Multiple Projects in a Single Workspace”. To enable Quickbuild, select None.

• Clean Removes all intermediary project files, such as object, hex and debug files. These

files are recreated from other files when a project is built. • Build All

You must have a project open before this option is visible. Build all files in the project, i.e., compile/assemble all files as specified in the

project. Build All is available in the right mouse button menu of the project window as well.

• Make

You must have a project open before this option is visible. Build only the files in the project that have changed, i.e., compile/assemble these

files as specified in the project. Make is available in the right mouse button menu of the project window as well.

• Build Options Set and view options for the project and individual files. See Section 9.5 “Build

Options Dialog”. • Save Save the active project. • Save As Save the active project to a new location/name. See Section 9.18 “Save Project

As Dialog”. • Close Close/remove the selected project in the workspace. • Add Files Insert files into the project. Depending on the type of file, MPLAB IDE will sort the

files into the correct type within the project window tree. Note: Adding Header Files to the project window will not cause these files to be

added to the project build. You must use a #include statement in your code.

 2005 Microchip Technology Inc.

DS51519A-page 105

MPLAB ® IDE User’s Guide

• Reload This command causes the IDE to go out to disk and read the project file in again.

It also does a Refresh immediately after. This functionality is useful if you modify your project and then decide you don't want the modifications. As long as you haven't saved and overwritten the old project, you can “Reload” and get back to your original project.

• Refresh This command causes the IDE to go out and check the status of all the files in the

project. For version-control system files, the files' status is updated in the project window. For missing files that you have relocated, “file not found” text will be removed.

• Select Language Toolsuite Select the toolsuite you will use for your project, e.g., Microchip MPASM Toolsuite.

See Section 9.20 “Select Language Toolsuite Dialog”. • Select Version-Control System Set up your project to use files from a version-control system. See Section 9.25

“Version-Control Dialog”.

8.4.2.3 FILE TYPE MENU If you right-click on a file type in the project tree, a menu with file type commands will

be displayed. • Library Link Order (Library Files Only)

Opens the Library Link Order dialog, which shows you the true order of the library files and allows you to resequence them. This is important for MPLAB C30 users.

• Add Files Insert files into the project. Depending on the type of file, MPLAB IDE will sort the

files into the correct type within the project window tree. Note: Adding Header Files to the project window will not cause these files to be

added to the project build. You must use a #include statement in your code.

• Filter Change the way files are filtered to determine file type. For example, to be able to

add an assembly file with extension .a under Source Files, add .a to the list of file extensions in the Filter dialog.

8.4.2.4 FILE MENU If you right-click on a file in the project tree, a menu with file commands will be

displayed. Note: If you are using a version-control system, additional commands that can be

used on the selected file. • Assemble/Compile

Assemble/compile the selected file as appropriate. • Build Options Set and view options for the project and individual files. See Section 9.5 “Build

Options Dialog”. • Edit

Open the selected file in a window for editing, if appropriate. • Remove Remove the selected file from the project. The file is not deleted from the directory.

DS51519A-page 106

 2005 Microchip Technology Inc.

MPLAB IDE Windows

8.4.3 Project Window FAQ

How do I: • Create/Update a project?

See Section 4.3 “Creating/Updating any Project”. • Build a project? Right-click on the project in the workspace that you wish to build. In the menu,

select Build All to build the entire project or Make to recompile/reassemble any changed files and then build.

The results of this build will be loaded into program memory, even if the selected project is not the active project.

• Use projects with workspaces? See Chapter 4. “Projects and Workspaces”. • Set a project as active? To set a project as the active project, select Project>Set Active Project>project-

name.mcp, where projectname.mcp is the project name, or right-click on the project in the Project window and select Set As Active Project.