Difference between revisions of "Ide/Project Settings"

From wiki.visual-prolog.com

m (include directly)
Line 6: Line 6:


=== General Tab ===
=== General Tab ===
{{:ideNavbar/Project Settings/General Tab}}
 
When creating a new project the sheet looks like:
 
[[Image:Ide/ApplicationExpert_General_Create.png]]
 
You need to specify a mandatory project name and other options. After the needed information is specified, press the '''OK''' button. The '''Project Settings''' utility will create the default files, define the [..\Make_Facility\Make_Facility.htm#Build_Script build script], etc.
 
==== Project Name ====
 
The project name must be specified in the '''Project Name''' option while a project creation. '''Project Settings''' uses this project name to generate name for the project file: '''<ProjectName>.prj6'''. The specified project name is also used as the default name of '''Subdirectory''' in which the project is placed.
 
==== Project Kind ====
 
Sets which type the application will have.
 
[[Image:Ide/ApplicationExpert_UI_Strategy.png]]
 
The IDE automatically generates different default sets of files (and codes) for each application type.
 
'''Note. DLL option is available for the Visual Prolog Commercial Edition only.'''
 
==== MDI Mode/SDI Mode ====
 
Specifies whether the IDE creates a ''multi document interface-'' or ''single document interface-'' project template respectively.
 
'''Note. This option is available for the Visual Prolog Commercial Edition only. Otherwise the ''MDI Mode'' is assumed by the default.'''
 
==== Base Directory and Subdirectory ====
 
The name of the directory, in which the project is placed, is generated from the path specified in '''Base Directory''' that is concatenated with the folder name specified in '''Subdirectory'''.
 
===== Base Directory =====
 
Specifies the base directory for the project being created.
 
With the '''Browse''' button, you can open up a directory browser to find a proper '''Base Directory.'''
 
===== Subdirectory =====
 
Specifies the subdirectory (relative to the '''Base Directory'''), which should be the root directory for the project being created.
 
By default the '''Subdirectory''' name is equal to the specified '''Project Name''', but it can be changed while the project creation.
 
Note. That if you choose a directory that already contains some project as the directory in which to place the project being created, then the '''Project Settings''' utility displays the '''These files will be overwritten''' warning dialog. It displays names of already existing files which will be overwritten after you push the '''Create''' button. Therefore, it is a good idea to store each project in its own directory.
 
[#Platform_Description '''See platform description below''']
 
To open the '''Project Settings '''dialog for the existing project, use the '''Project | Settings''' menu item.
 
The General tab will look, in this case, as foolows:
 
[[Image:Ide/ApplicationExpert_General.png]]
 
=== Directories Tab ===
=== Directories Tab ===
{{:ideNavbar/Project Settings/Directories Tab}}
 
Here you can specify directories that will be used by the project. In '''Directories''' tab you can set up the project subdirectories to be used by the compiler, linker, resource generators, etc.
 
Directory names refer to the [..\Make_Facility\Make_Facility.htm#Build_Symbols build script symbols]. For example, when giving the name '''$(ProDir)''', it is automatically expanded to the actual path where the Visual Prolog system is installed.
 
When all these project subdirectories are defined, then it is possible to move a project to another place and still be able to use it without need to redefine the [..\Make_Facility\Make_Facility.htm#Build_Script project build scripts] manually. This is possible because:
 
* Usually these project subdirectories are defined relatively to the project root directory. Therefore, they are automatically redefined when the project is moved.
* Each of these subdirectories generates correspondent [..\Make_Facility\Make_Facility.htm#Build_Symbols built symbol] and namely these built symbols are used to define file locations in the [..\Make_Facility\Make_Facility.htm#Build_Script project build scripts].
 
==== Intermediate - $(ObjDir) ====
 
This directory is used to place all intermediate (temporary) files of the project generated by the IDE. It defines the '''$(ObjDir)''' [..\Make_Facility\Make_Facility.htm#Build_Symbols build script symbol]. The IDE automatically adds suffix '''64''' to the intermediate directory name.
 
==== Final - $(ExeDir) ====
 
This directory is the place for the generated target module (executable or DLL). It defines the '''$(ExeDir)''' [..\Make_Facility\Make_Facility.htm#Build_Symbols build script symbol]. The IDE automatically adds suffix '''64''' to the final directory name.
 
==== Import Library - $(LibDir) ====
 
This directory is used for DLL projects to place the generated import library. It defines the '''$(LibDir)''' [..\Make_Facility\Make_Facility.htm#Build_Symbols build script symbol].
 
==== Prolog Root - $(ProDir) ====
 
It is the root directory of the used Visual Prolog version. This directory defines the '''$(ProDir)''' [..\Make_Facility\Make_Facility.htm#Build_Symbols build script symbol].
 
==== Include Directories - $(IncDir) ====
 
This list box displays the list of the project include directories.
 
Each line contains one directory. In these directories the compiler will search for included files (specified in <vp>#include</vp> or <vp>#bininclude</vp> compiler directives), if the specified filename does not contain an absolute path. A single dot indicates the current directory, which is always the project directory. Two dots indicate the parent directory of the current directory.
 
You can add a new directory to the list of the project include directories using the '''Browse''' button. The '''Browse''' button activates the '''Set New Directory''' dialog. Also you can use the '''Edit''' button, which activates the '''Edit Include Directory''' dialog. In this dialog you can directly type in a path. Using '''Up''' and '''Down''' buttons you can change the order in which the compiler will search in the specified include directories.
 
This directory defines the '''$(IncDir)''' [..\Make_Facility\Make_Facility.htm#Build_Symbols build script symbol].
 
=== Build Options Tab ===
=== Build Options Tab ===
{{:ideNavbar/Project Settings/Build Options Tab}}
 
=== Version Information Tab ===
=== Version Information Tab ===
{{:ideNavbar/Project Settings/Version Information Tab}}
 
=== File Templates Tab ===
=== File Templates Tab ===
{{:ideNavbar/Project Settings/File Templates Tab}}
 
 
=== Run Options Tab ===
=== Run Options Tab ===
{{:ideNavbar/Project Settings/Run Options}}

Revision as of 15:58, 13 February 2013

IDE

The Project Settings utility is used to create new Visual Prolog Projects and to change some settings of existing projects.

To activate the Project Settings dialog, select the Project | Settings menu item. Project Settings is also activated when you create a new project (with the Project | New command).

General Tab

When creating a new project the sheet looks like:

File:Ide/ApplicationExpert General Create.png

You need to specify a mandatory project name and other options. After the needed information is specified, press the OK button. The Project Settings utility will create the default files, define the [..\Make_Facility\Make_Facility.htm#Build_Script build script], etc.

Project Name

The project name must be specified in the Project Name option while a project creation. Project Settings uses this project name to generate name for the project file: <ProjectName>.prj6. The specified project name is also used as the default name of Subdirectory in which the project is placed.

Project Kind

Sets which type the application will have.

File:Ide/ApplicationExpert UI Strategy.png

The IDE automatically generates different default sets of files (and codes) for each application type.

Note. DLL option is available for the Visual Prolog Commercial Edition only.

MDI Mode/SDI Mode

Specifies whether the IDE creates a multi document interface- or single document interface- project template respectively.

Note. This option is available for the Visual Prolog Commercial Edition only. Otherwise the MDI Mode is assumed by the default.

Base Directory and Subdirectory

The name of the directory, in which the project is placed, is generated from the path specified in Base Directory that is concatenated with the folder name specified in Subdirectory.

Base Directory

Specifies the base directory for the project being created.

With the Browse button, you can open up a directory browser to find a proper Base Directory.

Subdirectory

Specifies the subdirectory (relative to the Base Directory), which should be the root directory for the project being created.

By default the Subdirectory name is equal to the specified Project Name, but it can be changed while the project creation.

Note. That if you choose a directory that already contains some project as the directory in which to place the project being created, then the Project Settings utility displays the These files will be overwritten warning dialog. It displays names of already existing files which will be overwritten after you push the Create button. Therefore, it is a good idea to store each project in its own directory.

[#Platform_Description See platform description below]

To open the Project Settings dialog for the existing project, use the Project | Settings menu item.

The General tab will look, in this case, as foolows:

File:Ide/ApplicationExpert General.png

Directories Tab

Here you can specify directories that will be used by the project. In Directories tab you can set up the project subdirectories to be used by the compiler, linker, resource generators, etc.

Directory names refer to the [..\Make_Facility\Make_Facility.htm#Build_Symbols build script symbols]. For example, when giving the name $(ProDir), it is automatically expanded to the actual path where the Visual Prolog system is installed.

When all these project subdirectories are defined, then it is possible to move a project to another place and still be able to use it without need to redefine the [..\Make_Facility\Make_Facility.htm#Build_Script project build scripts] manually. This is possible because:

  • Usually these project subdirectories are defined relatively to the project root directory. Therefore, they are automatically redefined when the project is moved.
  • Each of these subdirectories generates correspondent [..\Make_Facility\Make_Facility.htm#Build_Symbols built symbol] and namely these built symbols are used to define file locations in the [..\Make_Facility\Make_Facility.htm#Build_Script project build scripts].

Intermediate - $(ObjDir)

This directory is used to place all intermediate (temporary) files of the project generated by the IDE. It defines the $(ObjDir) [..\Make_Facility\Make_Facility.htm#Build_Symbols build script symbol]. The IDE automatically adds suffix 64 to the intermediate directory name.

Final - $(ExeDir)

This directory is the place for the generated target module (executable or DLL). It defines the $(ExeDir) [..\Make_Facility\Make_Facility.htm#Build_Symbols build script symbol]. The IDE automatically adds suffix 64 to the final directory name.

Import Library - $(LibDir)

This directory is used for DLL projects to place the generated import library. It defines the $(LibDir) [..\Make_Facility\Make_Facility.htm#Build_Symbols build script symbol].

Prolog Root - $(ProDir)

It is the root directory of the used Visual Prolog version. This directory defines the $(ProDir) [..\Make_Facility\Make_Facility.htm#Build_Symbols build script symbol].

Include Directories - $(IncDir)

This list box displays the list of the project include directories.

Each line contains one directory. In these directories the compiler will search for included files (specified in #include or #bininclude compiler directives), if the specified filename does not contain an absolute path. A single dot indicates the current directory, which is always the project directory. Two dots indicate the parent directory of the current directory.

You can add a new directory to the list of the project include directories using the Browse button. The Browse button activates the Set New Directory dialog. Also you can use the Edit button, which activates the Edit Include Directory dialog. In this dialog you can directly type in a path. Using Up and Down buttons you can change the order in which the compiler will search in the specified include directories.

This directory defines the $(IncDir) [..\Make_Facility\Make_Facility.htm#Build_Symbols build script symbol].

Build Options Tab

Version Information Tab

File Templates Tab

Run Options Tab