HOWTO configure QtCreator with ns-3

Basic Configuration

• Start QtCreator.
  • Under or Tools->Options->Text Editor
    • On Completion tab under Behavior enable Insert space after function name
  • Under Tools->Options->C++
    • On Code Style tab set Current setting: to "GNU [built-in]"
    • On File Naming tab set Source suffix: to "cc"

Importing project

• Go to File menu and select New File or Project.
• Then go to Import Project->Import Existing Project and click Choose... button.
• Project Name and Location
  • "Project name:" should be something like "qtcreator-project-ns-3-dev", because QtCreator will create couple of files in ns-3-dev directory and you want to be able to delete them easily if needed.
  • "Location:" should be your ns-3-dev directory.
  • Click Next >
• File Selection
  • Click Next >
• Project Management
  • Click Finish

Configuring project

• Click Edit on the left; open "qtcreator-project-ns-3-dev.includes" file.
  • Edit the line "<path-to-ns-3-dev>/build/ns3" to be "<path-to-ns-3-dev>/build"
• Click Projects on the left.
  • Under Build Settings
    • Remove make all under Build Steps, and click Add Build Step->Custom Process Step
      • 'Command: should be "./waf"
      • Working directory: is OK by default
      • Command arguments: should be "build"
    • Remove make clean under Clean Steps, and click Add Clean Step->Custom Process Step
      • 'Command: should be "./waf"
      • Working directory: is OK by default
      • Command arguments: should be "clean"
  • Under Run Settings
    • Set Executable: to "./waf"
    • Set Arguments: to "--run examples/tutorial/first" or whatever you need
      • If you set it to "--run examples/tutorial/first" make sure you built examples prior to running the code

Unresolved issues

• Start Debugging doesn't work