Deploy an application

When you have your application configured correctly and running on the GAS, you are now ready to package the files required to deploy it as an application.

1. Remove the HelloWorld.xcf file in your GAS appdata/app directory (On Linux/UNIX: $FGLASDIR/appdata/app, on Windows®: C:\ProgramData\FourJs\gas\gas_version\app)

   This file may have been uploaded by yourself during the Configure an application task. Applications with the same xcf can not be deployed.

2. Update the application configuration file (HelloWorld.xcf) for your HelloWorld application.
   Update the <PATH> element to the GAS deployment path as follows:

   <PATH>$(res.deployment.path)</PATH>

   The configuration should now look like this:

   <?xml version="1.0" encoding="UTF-8" ?>
   <APPLICATION Parent="defaultgwc" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xsi:noNamespaceSchemaLocation="http://www.4js.com/ns/gas/4.01/cfextwa.xsd">
     <EXECUTION>
       <PATH>$(res.deployment.path)</PATH>
       <MODULE>HelloWorld.42r</MODULE>
     </EXECUTION>
   </APPLICATION>

3. Create a new directory where you will archive the application's runtime files (you can name it "helloworld_deploy").
4. Copy all the HelloWorld application runtime files from $GSTDIR/samples to the archive directory.
   Note:

   If you are deploying resources (for example, images or web components) with your application, these need to go in dedicated directories in the archive.

5. Copy the application configuration file (HelloWorld.xcf) to the directory with the application runtime files.
6. In the same directory, create a MANIFEST file and save it with the name "MANIFEST" (without extension).
   The MANIFEST contents resembles the following:

   <MANIFEST>
     <DESCRIPTION></DESCRIPTION>
     <APPLICATION xcf="HelloWorld.xcf"/>
   </MANIFEST>

7. Create an archive file (gar) to deploy your application by performing the following steps:
   1. Navigate to your Genero Studio installation directory and set the environment.
      • On Linux®/macOS™, change to your Genero Studio root directory and source the script, for example:

        cd /opt/fourjs/gst
        source envgenero 

      • On Windows, change to your Genero Studio root directory and run the bat file, for example:

        cd "c:\program files\fourjs\gst"
        envgenero.bat 

   2. Navigate to the directory that contains the application runtime files AND the MANIFEST file.
   3. Create an archive file (gar) to deploy your application by typing this command:

      fglgar gar .

      Where the dot (period) specifies the current directory.

      A Genero Archive (gar) file is created in your current directory that has the same name as the directory. See the fglgar topic in the Genero Business Development Language User Guide.