BUILD APPLICATION

version 2004

BUILD APPLICATION {(projectName)}

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 Design Reference manual of 4th Dimension).

By default, 4th Dimension creates an application project named "buildapp.prj" (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 (".prj" 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 4th Dimension XML Keys manual (HTML format).

This example builds two applications in a single method:

   BUILD APPLICATION("c:\\folder\\projects\\myproject1.prj")
   If (OK=1)
      BUILD APPLICATION("c:\\folder\\projects\\myproject2.prj")
   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.