Difference between revisions of "Creating a new project"

From CodeBlocks
Jump to: navigation, search
(Created page with "Category: User Documentation right '''This is a work in progress, and may be missing key details.''' Launch the Project Wizard through ''File->New...")
 
Line 10: Line 10:
  
 
[[File:SelectSource.png|right]]Finally, the wizard will ask if this project should use the default compiler (normally GCC) and the two default builds: '''Debug''' and '''Release'''. All of these settings are fine. Press finish and and the project will be generated. The main window will turn gray, but that is not a problem, the source file needs only to be opened. In the '''Projects''' tab of the '''Management''' pane on the left expand the folders and double click on the source file '''main.cpp''' to open it in the editor. This file contains the following standard code.
 
[[File:SelectSource.png|right]]Finally, the wizard will ask if this project should use the default compiler (normally GCC) and the two default builds: '''Debug''' and '''Release'''. All of these settings are fine. Press finish and and the project will be generated. The main window will turn gray, but that is not a problem, the source file needs only to be opened. In the '''Projects''' tab of the '''Management''' pane on the left expand the folders and double click on the source file '''main.cpp''' to open it in the editor. This file contains the following standard code.
<source lang="cpp">
+
<source lang="cpp" line>
 
#include <iostream>
 
#include <iostream>
  
Line 20: Line 20:
 
     return 0;
 
     return 0;
 
}</source>
 
}</source>
==Adding additional files==
+
==Changing file composition==
 
A single source file is of little uses in programs of any useful complexity. In order to handle this, Code::Blocks has several very simple methods of adding additional files to the project.
 
A single source file is of little uses in programs of any useful complexity. In order to handle this, Code::Blocks has several very simple methods of adding additional files to the project.
 +
===Adding a blank file===
 +
In this example, we will be splitting the function
 +
<source lang="cpp" line start="7">
 +
    cout << "Hello world!" << endl;
 +
</source>
 +
into a separate file. To add the new file to the project, bring up the file template wizard through either ''File->New->File...'' or ''Main Toolbar->New file (button)->File...''
 +
 +
[[File:NewFile.png]]
 +
[[File:Hello.cpp.png|right]]
 +
Select '''C/C++ source''' and click '''Go'''. Continue through the following dialogs very much like the original project creation, selecting '''C++''' when prompted for a language. On the final page, you will be presented with several options. The first box will determine the new filename and location (as noted, the full path is required). You may optionally use the '''...''' button to bring up a file browser window to save the file's location. Checking '''Add file to active project''' will store the filename in the '''Sources''' folder of the '''Projects''' tab of the '''Management''' panel. Checking any of the build targets will alert Code::Blocks that the file should be compiled and linked into the selected target(s). This can be useful if, for example, the file contains debug specific code, as it will allow the inclusion (or exclusion) from the a the appropriate build target. In this example, however, the hello function is of key importance, and is required in each target, so select all the boxes.
 
==Modifying build options==
 
==Modifying build options==

Revision as of 04:47, 15 August 2011

ProjectWizard.png

This is a work in progress, and may be missing key details.

Launch the Project Wizard through File->New->Project... to start a new project. Here there are many pre-configured templates for various types of projects, including the option to create custom templates. Select Console application, as this is the most common for general purposes, an click Go.

The console application wizard will appear next. Continue through the menus, selecting C++ when prompted for a language. In the next screen, give the project a name and type or select a destination folder. As seen below, Code::Blocks will generate the remaining entries from these two.

ConsoleApplication.png

SelectSource.png
Finally, the wizard will ask if this project should use the default compiler (normally GCC) and the two default builds: Debug and Release. All of these settings are fine. Press finish and and the project will be generated. The main window will turn gray, but that is not a problem, the source file needs only to be opened. In the Projects tab of the Management pane on the left expand the folders and double click on the source file main.cpp to open it in the editor. This file contains the following standard code.
  1. #include <iostream>
  2.  
  3. using namespace std;
  4.  
  5. int main()
  6. {
  7.     cout << "Hello world!" << endl;
  8.     return 0;
  9. }

Changing file composition

A single source file is of little uses in programs of any useful complexity. In order to handle this, Code::Blocks has several very simple methods of adding additional files to the project.

Adding a blank file

In this example, we will be splitting the function

  1.     cout << "Hello world!" << endl;

into a separate file. To add the new file to the project, bring up the file template wizard through either File->New->File... or Main Toolbar->New file (button)->File...

NewFile.png

Hello.cpp.png

Select C/C++ source and click Go. Continue through the following dialogs very much like the original project creation, selecting C++ when prompted for a language. On the final page, you will be presented with several options. The first box will determine the new filename and location (as noted, the full path is required). You may optionally use the ... button to bring up a file browser window to save the file's location. Checking Add file to active project will store the filename in the Sources folder of the Projects tab of the Management panel. Checking any of the build targets will alert Code::Blocks that the file should be compiled and linked into the selected target(s). This can be useful if, for example, the file contains debug specific code, as it will allow the inclusion (or exclusion) from the a the appropriate build target. In this example, however, the hello function is of key importance, and is required in each target, so select all the boxes.

Modifying build options