4D v13.4

BUILD APPLICATION

Home

 
4D v13.4
BUILD APPLICATION

BUILD APPLICATION 


 

BUILD APPLICATION {( projectName )} 
Parameter Type   Description
projectName  String in Full access path of the project to use

The BUILD APPLICATION command launches the application generation process. It takes into account parameters set in the current application project or the application project set in the projectName parameter.

An application project is an XML file that contains all the parameters used to generate an application. Most parameters can be seen in the Build Application... dialog box (for more information, refer to the Finalizing and deploying final applications section of the 4D Design Reference manual).
By default, 4D creates an application project named “buildapp.xml” (default) for each database and places it in the BuildApp subfolder in the database Preferences folder.

If the database has not yet been compiled or if the compiled code is outdated, the command will first launch the compiler process. In this case, the compiler window does not appear (unless an error occurs), only a progress bar is displayed.

If you do not pass the optional projectName parameter, the command displays a standard open file dialog box, so that you can designate a project file. When the dialog box has been validated, the system variable Document contains the full pathname of the open project file.

If you pass the access path and name of an XML file for a valid application project (UTF-8 encoding and “.xml” extension), the command will use the parameters defined in the file. For more information on the structure and the keys that can be used in the XML file of an application project, refer to the 4D XML Keys BuildApplication manual.

Example  

This example builds two applications in a single method:

 BUILD APPLICATION("c:\\folder\\projects\\myproject1.xml")
 If(OK=1)
    BUILD APPLICATION("c:\\folder\\projects\\myproject2.xml")
 End if

The system variable OK is set to 1 if the command has been correctly executed. Otherwise, it is set to 0. The system variable Document contains the full pathname of the open project file.

If the command fails, an error is generated that you can intercept using the ON ERR CALL command.

 
PROPERTIES 

Product: 4D
Theme: 4D Environment
Number: 871

The OK variable is changed by the commandThis command modifies the system Document variableThis command modifies the Error system variable

 
INDEX

Alphabetical list of commands

 
HISTORY 

Created: 4D 2004