HOWTO configure QtCreator with ns-3 - Revision history

Vedranm: Fix a typo

2013-01-02T13:04:49Z

Fix a typo

← Older revision		Revision as of 13:04, 2 January 2013
Line 41:		Line 41:
	** Under '''Run Settings'''		** Under '''Run Settings'''
	*** Set '''Executable:''' to "./build/examples/tutorial/ns3-dev-first-debug" or any executable you want to run and debug		*** Set '''Executable:''' to "./build/examples/tutorial/ns3-dev-first-debug" or any executable you want to run and debug
	**** If you set it to "examples/tutorial/first" make sure you used "--enable-examples" option in "./waf configure" prior to running the code		**** If you set it to "./build/examples/tutorial/ns3-dev-first-debug" make sure you used "--enable-examples" option in "./waf configure" prior to running the code
	*** Leave '''Arguments:''' blank		*** Leave '''Arguments:''' blank
	*** '''Working directory:''' is again OK by default		*** '''Working directory:''' is again OK by default

Vedranm: Without extra =

2012-10-06T13:28:01Z

Without extra =

← Older revision		Revision as of 13:28, 6 October 2012
Line 1:		Line 1:
	== Introduction ===		== Introduction ==
	* There are two possible approaches:		* There are two possible approaches:
	** '''variant 1:''' chaining QtCreator to waf, '''or'''		** '''variant 1:''' chaining QtCreator to waf, '''or'''

Vedranm: Minor cleanup

2012-10-06T13:27:46Z

Minor cleanup

← Older revision		Revision as of 13:27, 6 October 2012
Line 1:		Line 1:
	* ~~Open~~ a terminal; cd to the ns-3-dev directory and run "./waf configure --enable-examples" or whatever configuration is to your taste, and "./waf build".		== Introduction ===
	* You have two options now:		* There are two possible approaches:
	** chaining QtCreator to waf, '''or'''		** '''variant 1:''' chaining QtCreator to waf, '''or'''
	** using QtCreator with qmake instead of waf.		** '''variant 2:''' using QtCreator with qmake instead of waf.
			* In both cases first open a terminal, cd to the ns-3-dev directory and run "./waf configure --enable-examples" or whatever configuration is to your taste, and "./waf build".

	== Variant 1: chaining QtCreator to waf ==		== Variant 1: chaining QtCreator to waf ==

Vedranm: Add John Abraham's approach

2012-10-06T13:26:06Z

Add John Abraham's approach

@@ Line 1: / Line 1: @@
 * Open a terminal; cd to the ns-3-dev directory and run "./waf configure --enable-examples" or whatever configuration is to your taste, and "./waf build".
 * Run "./waf shell", and then '''in the same terminal''' start QtCreator using "qtcreator" command.
 ** Under or ''Tools''->''Options''->''Text Editor''
@@ Line 8: / Line 13: @@
 *** On ''File Naming'' tab set '''Source suffix:''' to "cc"
-== Importing project ==
+=== Importing project ===
 * Go to ''File'' menu and select ''New File or Project''.
 * Then go to ''Import Project''->''Import Existing Project'' and click ''Choose...'' button.
@@ Line 20: / Line 25: @@
 ** Click ''Finish''
-== Configuring project ==
+=== 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"
@@ Line 39: / Line 44: @@
 *** '''Working directory:''' is again OK by default
-== FAQ ==
+=== FAQ ===
 * Q: I get an error "./build/examples/tutorial/ns3-dev-first-debug: error while loading shared libraries: libns3-dev-point-to-point-debug.so: cannot open shared object file: No such file or directory".
 ** A: Please make sure that you are running "qtcreator" inside "./waf shell".

Vedranm at 18:21, 4 October 2012

2012-10-04T18:21:16Z

← Older revision		Revision as of 18:21, 4 October 2012
Line 1:		Line 1:
	== Basic Configuration ==		== Basic Configuration ==
	* ~~Start~~ QtCreator.		* Open a terminal; cd to the ns-3-dev directory and run "./waf configure --enable-examples" or whatever configuration is to your taste, and "./waf build".
			* Run "./waf shell", and then '''in the same terminal''' start QtCreator using "qtcreator" command.
	** Under or ''Tools''->''Options''->''Text Editor''		** Under or ''Tools''->''Options''->''Text Editor''
	*** On ''Completion'' tab under '''Behavior''' enable '''Insert space after function name'''		*** On ''Completion'' tab under '''Behavior''' enable '''Insert space after function name'''
Line 33:		Line 34:
	**** '''Command arguments:''' should be "clean"		**** '''Command arguments:''' should be "clean"
	** Under '''Run Settings'''		** Under '''Run Settings'''
	*** Set '''Executable:''' to "./~~waf"~~		*** Set '''Executable:''' to "./build/examples/tutorial/ns3-dev-first-debug" or any executable you want to run and debug
	*** Set '''Arguments:''' to "--run examples/tutorial/first" or ~~whatever~~ you ~~need~~		**** If you set it to "examples/tutorial/first" make sure you used "--enable-examples" option in "./waf configure" prior to running the code
	**** If you set it to "~~--run~~ examples/tutorial/first" make sure you ~~built~~ examples prior to running the code		*** Leave '''Arguments:''' blank
			*** '''Working directory:''' is again OK by default

	== ~~Unresolved issues~~ ==		== FAQ ==
	* ~~'''Start Debugging''' doesn't work~~		* Q: I get an error "./build/examples/tutorial/ns3-dev-first-debug: error while loading shared libraries: libns3-dev-point-to-point-debug.so: cannot open shared object file: No such file or directory".
			** A: Please make sure that you are running "qtcreator" inside "./waf shell".

Vedranm: make all and make clean

2012-10-04T13:29:45Z

make all and make clean

← Older revision		Revision as of 13:29, 4 October 2012
Line 24:		Line 24:
	* Click '''Projects''' on the left.		* Click '''Projects''' on the left.
	** Under '''Build Settings'''		** Under '''Build Settings'''
	*** Remove ''~~Make~~'' under '''Build Steps''', and click ''Add Build Step''->''Custom Process Step''		*** Remove ''make all'' under '''Build Steps''', and click ''Add Build Step''->''Custom Process Step''
	**** '''Command:'' should be "./waf"		**** '''Command:'' should be "./waf"
	**** '''Working directory:''' is OK by default		**** '''Working directory:''' is OK by default
	**** '''Command arguments:''' should be "build"		**** '''Command arguments:''' should be "build"
	*** Remove ''~~Make~~'' under '''Clean Steps''', and click ''Add Clean Step''->''Custom Process Step''		*** Remove ''make clean'' under '''Clean Steps''', and click ''Add Clean Step''->''Custom Process Step''
	**** '''Command:'' should be "./waf"		**** '''Command:'' should be "./waf"
	**** '''Working directory:''' is OK by default		**** '''Working directory:''' is OK by default

Vedranm: Remove "start QtCreator" item

2012-10-04T13:26:58Z

Remove "start QtCreator" item

← Older revision		Revision as of 13:26, 4 October 2012
Line 8:		Line 8:

	== Importing project ==		== Importing project ==
	* ~~Start QtCreator and go~~ to ''File'' menu and select ''New File or Project''.		* Go to ''File'' menu and select ''New File or Project''.
	* Then go to ''Import Project''->''Import Existing Project'' and click ''Choose...'' button.		* Then go to ''Import Project''->''Import Existing Project'' and click ''Choose...'' button.
	* '''Project Name and Location'''		* '''Project Name and Location'''

Vedranm: Add "start QtCreator" item

2012-10-04T13:26:36Z

Add "start QtCreator" item

← Older revision		Revision as of 13:26, 4 October 2012
Line 1:		Line 1:
	== Basic Configuration ==		== Basic Configuration ==
	** Under ~~'''Editor Settings'''~~ or ''Tools''->''Options''->''Text Editor''		* Start QtCreator.
			** Under or ''Tools''->''Options''->''Text Editor''
	*** On ''Completion'' tab under '''Behavior''' enable '''Insert space after function name'''		*** On ''Completion'' tab under '''Behavior''' enable '''Insert space after function name'''
	** Under ''Tools''->''Options''->''C++''		** Under ''Tools''->''Options''->''C++''

Vedranm: Detailed QtCreator help

2012-10-04T13:25:47Z

Detailed QtCreator help

New page

== Basic Configuration ==
** Under '''Editor Settings''' 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 ==
* Start QtCreator and 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'' 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'' 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