4D Doc Center : BUILD APPLICATION

Home

4D v14.3

BUILD APPLICATION


BUILD APPLICATION {( projectName )}

Parameter	Type	Description
projectName	String	Full access path of the project to use

Description

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 Application builder 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.
You can hide this progress bar using the MESSAGES OFF command.

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 MissingRef 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

System Variables or Sets

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.

Error Handling

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