- Overview
- How to?
- Creating a configuration
- Working on a project configuration
- Generating a project configuration
- Add an element into a project configuration
- Excluding an element from a project configuration
- Duplicate a project configuration
- Delete a project configuration
- Characteristics of a project configuration
- Options in the "General" tab
- Tips
Project configurations define what kind of element will be generated once the development process is completed: 32 or 64-bit executable, web service, component, etc. The project elements can be: - common to several configurations (a window used in a 32-bit executable and in a 64-bit executable for example).
- specific to a configuration (a class used by a component for example).
You can work on a specific configuration at any time. Elements that do not belong to this configuration appear grayed out in the "Project explorer" pane. This help page presents the following topics:
Warning
Starting with version 2025, project configurations can only be manipulated in the "Project explorer" pane.
Creating a configuration By default, a single configuration is created in the project. This configuration is named like the project and it contains all project elements. To create a new configuration: - In the "Project explorer" pane, right-click "Configurations" and select "New configuration".
- The project configuration creation wizard opens. Specify:
- the configuration name.
Note: If the project contains several project configurations, this name will also correspond to the name of directory where the files of the project configuration will be generated. - its description.
- what you want to generate: Executable, Java, Library, Component, Web service, .Net assembly, .Net executable, etc.
Note: This option is not required if you specified the platform during the creation process.
- Depending on the type of generation chosen for the project configuration, additional options can be specified:
- Options for compatibility between IDEs: The element can be generated for a specific type of project, or for all IDEs (WINDEV, WEBDEV and WINDEV Mobile). You can enable or disable compilation errors for 64-bit or Linux compatibility.
- Operating system and platform.
- If necessary, specify the project elements you want to integrate into the current project configuration (windows, reports, queries, etc.). If your project uses components, you can also select the components included in the configuration.
- Confirm. This project configuration is automatically selected.
To change it, right-click the configuration in the "Project Explorer" pane and select "Description". Project configuration directory: By default, when a project configuration is created, the files of this configuration are generated in a subdirectory of the project's EXE directory. This allows you to easily find the files generated by a configuration. If the project already was a multi-configuration project, when creating a project configuration, a wizard plane proposes to generate the configuration files: - in the EXE directory of the project (option kept for backward compatibility).
- in a subdirectory by configuration (created in the project's EXE directory). In this case, a directory is created for each one of the configurations that exists in the project. The name of this directory corresponds to the name of the project configuration.
Remarks: - In the "Options" tab of the project description window, "Generate all the configurations in the "Exe" directory (not recommended if several configurations)" is used to restore the operating mode of earlier versions.
- In test mode, the files present in the configuration directory (INI files, data files, etc.) will be used.
- When a project configuration is first created, the entire contents of the EXE directory are copied to the subdirectories of the project configuration. You may have to delete the files that are not related to the current configuration (e.g., EXE file not required in the directory of a component configuration).
- You can also create a project configuration from an existing configuration. To do so, perform a configuration duplication.
Working on a project configuration You can switch between configurations in the "Project explorer" pane. Simply double-click the desired configuration or select "Enable this configuration" in the context menu. The entire project corresponds to the configuration named like the project. When working on a specific configuration: - In the "Project explorer" pane, the icon next to the name of an unused element in the current configuration is grayed out.
- A first window or a first page can be defined for each project configuration.
- You can set the user groupware options for each project configuration.
- When generating the elements of a configuration, only the elements defined in the configuration are taken into account.
- In the quick access buttons, the generation icon automatically adapts to the current configuration (create an executable, create a JAVA archive, etc.).
Generating a project configuration To generate the result of a project configuration: - Open the project configuration management window. To do so, go to the "Project explorer" pane, right-click "Configurations" and select "Manage configurations".
- Select the project configuration to generate.
- Click the "Generate" button.
Add an element into a project configuration To add an element into a configuration: - In the "Project Explorer" pane, select the element you want to add (window, report, etc.).
- Right-click to open the context menu and select "Configurations".
In the menu appears:
- checked configurations are associated with the element.
- unchecked configurations are not associated with the element.
- "All" associates the element with all the configurations.
- "None" dissociates the element from a configuration.
- "Multiple" allows you to choose the configurations you want to associate the element with.
- Select the unchecked configuration to which the element will be added.
Note: When saving a new element, the following window appears: In this window, you can choose the configuration in which you want to add the element. To make this window appear automatically each time a new element is saved, check "Ask for the location of the new elements in the project" in the "Options" tab of the project description. Excluding an element from a project configuration To exclude an element from a configuration: - In the "Project explorer" pane, select the element you want to exclude (window, report, etc.).
- Right-click to open the context menu and select "Configurations". In the menu appears:
- checked configurations are associated with the element.
- unchecked configurations are not associated with the element.
- Select the checked configuration for which the element will be excluded.
Note: Elements excluded from a project configuration are not compiled for that specific configuration. The code related to that element is grayed out. In the non-compiled code: - there are no code suggestions.
- there are no cross-references. The Shift+F2 shortcut is disabled, it is not possible to see where element are used and elements may appear in the lists of orphan elements and dead code.
- the code is not analyzed and the smart renaming feature is disabled.
- there are no compilation errors: If you modify the prototype of a procedure, the error will only be displayed when you switch to a configuration that supports compilation.
Duplicate a project configuration Project configurations can be duplicated: - from the "Project explorer" pane.
- from the configuration management window.
To duplicate a project configuration from the "Project explorer" pane: - Select the project configuration to duplicate.
- Open the context menu of the description and select "Duplicate".
- The new project configuration appears in the "Project explorer" pane.
- Modify (if necessary) the new project configuration:
- In the "Project explorer" pane, open the context menu and select "Description".
- In the "General" tab, edit the name, type of generation and generation directory of the duplicated configuration.
To duplicate a configuration from the project configuration management window: - Open the project configuration management window. To do so, go to the "Project explorer" pane, right-click "Configurations" and select "Manage configurations".
- Select the project configuration to duplicate.
- Click "Duplicate".
- Modify (if necessary) the new project configuration:
- Click the "Description" button.
- In the "General" tab, edit the name, type of generation and generation directory of the duplicated configuration.
Remarks: - The duplicated configuration and the source configuration contain the same elements. This allows you to easily create an iOS configuration in an Android project.
- The name of generated element must be modified if necessary in the corresponding generation wizard.
Delete a project configuration To delete a configuration: - Select the desired configuration in the "Project explorer" pane.
- Select "Delete" from the menu of the "Project explorer" pane.
Remarks: - The configuration elements will be saved in the project (windows, reports, etc.).
- Generated elements (executable, service, component, etc.) will not be deleted from disk.
Characteristics of a project configuration To edit a project configuration, go to the "Project explorer" pane, right-click "Configurations" and select "Manage configurations". In the configuration management window, you can define: - a command line for testing the project configuration ("Test mode" button).
- an action to be executed before generating the project configuration ("Action before generation" button). Simply specify the action to perform at the time of generation.
- an action to be executed after generating the project configuration ("Action after generation" button). Simply specify the action to perform after the generation.
The "Description" button opens the configuration description window. This window includes several tabs: - "General" tab, which contains general information of the configuration. For more details, see Options in the "General" tab.
- "Elements" tab, which contains the list of elements in the configuration.
- "Components" tab, which displays all the external components used by the project configuration.
- "Compatibility" tab, which lists the compatibility options of the project configuration. These options affect:
- options related to the management of multiple platforms. You can:
- Enable or disable compilation errors for 64-bit or Linux compatibility.
Display errors related to pre-launched sessions.
- the cross-platform options of a "Component" configuration.
"Unicode" tab, which allows you to define whether UNICODE or ANSI strings are used at runtime. "GPU " tab, to enable or disable the User Groupware for the current configuration.
Options in the "General" tab The "General" tab includes the following options: - general information: Configuration name and description.
- generation information:
- type of generation.
- project configuration generation directory, if the project contains several configurations.
- actions to be performed before and after generating the project configuration.
- first windows or pages.
home page: Home page of the site. The [...] button opens a preview of all project pages for quick selection. For more details, see The home page. first page in Session mode: First page of the project in Session mode. The [...] button shows a preview of all the pages in Session mode for quick selection. For more details, see First page of the project in Session mode. error page: Page used to display site errors. The [...] button opens a preview of all static project pages for quick selection. For more details, see A specific page to display the errors.
- the executable characteristics.
 - The "Encryptable executable
(Library loaded by standard APIs)" option makes generated executables compatible with executable encryption and compression tools (UPX, HASP Envelope, etc.).
- "Disable the prevention of data execution (/NXCOMPAT:NO option)
(Allows you to use of external modules that do not support the last security standard)" is used to manage the "NX" compilation option (No eXecute).
- The 32-bit executables and DLLs for Windows are now compiled with the "NX" option (No eXecute). This option is commended to improve security. It must necessarily be used in order for an application to be certified by Microsoft for example. An application compiled without this option can allow its author to execute a code placed at a specific location in memory. This technique, already used by malevolent applications, is not allowed anymore.
- The option "Disable the prevention from running data (/NXCOMPAT:NO option)" is used to compile without the "NX" option. This may be required when the executable uses an external DLL (ActiveX, ODBC driver for accessing a database, etc.), that has no NX flag and that runs code in memory via what could be a security breach. If the main application is compiled with the NX option, a General Protection Fault (GPF) will be triggered.
- Remarks:
- We recommend that you ask the DLL publisher for an updated version of the DLL with the NX flag.
- We advise you to foresee in the medium term an alternative to the use of DLL. With the ever-increasing security of systems, it is quite likely that executables without the NX option will no longer be able to run.
- "Executable with windows" and "Console executable" are used to specify whether or not the executable corresponding to the current project configuration should display windows. In the latter case, it could be a Batch executable executed in command line mode, for example.
Subscription-exclusive new featuresite-specific options:
- Device management application (can become "device owner" for the kiosk mode): This option supports full kiosk mode. For more details, see Application in kiosk mode.
- Action bar height: This option allows you to set the height of the Action Bar control in the different windows. Until version 25, the height of Action Bar controls is 48 px by default. Starting with new projects in version 26, the height of the Action Bar control is 56 px by default. This option allows you to change the height of the Action Bar control in existing projects.
Note: Height changes apply to all windows in the application.
For the actions before and after generation, the following operations must be performed: - Type the command script to run. You can type:
- the path of an executable file: enter the path directly in the control or click "Browse...".
- macros: Click "Macro" and double-click the macro you want to add to your command line. For example, "Name of Current Project" {$ProjectName} will be replaced with the name of your project being edited. A specific macro is used to run an option of a CustomMenu.
- Select the runtime options of the command line:
- Display the console: a console (command prompt) will be displayed.
- Leave the console opened: if a console is displayed, it will remain opened until the end of execution of the program.
- Non-locking execution: the execution of the command line will not lock the access to WINDEV, WEBDEV or WINDEV Mobile.
- Select the runtime directory of program.
- Validate
Tips - To know which project configuration is being used, simply use ProjectInfo with the piConfiguration constant.
- To activate a project configuration from the "Project explorer" pane, simply double-click on the name of the desired configuration. To open the description window of the selected configuration, select "Description" in the context menu.
- To directly open the generation directory of a configuration:
- Select "Open generation directory" in the context menu of the project configuration.
- On the "Home" tab, in the "General" group, expand
and select "Browse generation directory".
This page is also available for…
|
|
|