Provide the GBC in the application path

To provide a specific GBC to be used by an application, you can add the GBC runtime package to the application path.

Before you begin

You have a GBC runtime package downloaded from the Four Js web site or created from a customization GBC project. For more information on creating a GBC runtime package, see the Genero Browser Client User Guide.

About this procedure

In this procedure, you have a GBC runtime package that you want your application to use. You add the GBC to the gbc directory of the application path. When you use this method, the application uses the GBC found in that directory, regardless of the GAS configuration.

Complete these steps

Complete these steps to provide the GBC client in the application path.

  1. In your application root directory, create a directory named gbc.
    For example, if your application root directory is applications/myapp/, you would create applications/myapp/gbc/. The directory will be empty.
  2. Copy the compiled GBC to this directory.
    You must copy the GBC unzipped. The GAS will look for bootstrap.html in this directory to check if it is a valid GBC.
    To continue the example, if your customized GBC sits in /gbc-project-dir/dist/customization/sample/ (where gbc-project-dir references your GBC project directory), you would copy the contents of the sample directory into applications/myapp/gbc/.
  3. In the application configuration file, specify the application root directory in the PATH element.
    For example:
    <?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/5.00/cfextwa.xsd">
     <EXECUTION>
        <PATH>applications/myapp/</PATH>
        <MODULE>myModule.42m</MODULE>
     </EXECUTION>
      <UA_OUTPUT>
        <PUBLIC_IMAGEPATH>$(res.public.resources)</PUBLIC_IMAGEPATH>
      </UA_OUTPUT>
    </APPLICATION>
  4. Save the changes to the application configuration file.

    If you are saving the application configuration file for the first time, you can save it in the default application group directory ($(res.appdata.path)/app) or in your own defined group.

    Alternatively, you can deploy the app.

Next steps

Once you have completed your configuration, you can verify that the correct GBC client is used. Enter the application URL in a browser; this example uses the local standalone dispatcher:

http://localhost:6394/ua/r/myapp.

To find out which GBC client is being used, click on the Settings icon. In the dialog that opens, the version information is displayed. It contains the GBC version number appended with the customization suffix defined in the GBC customization being used. It also provides the build timestamp of the customization package.

If your application does not load, the issue may be with your customized GBC runtime package. See topics such as Fix configuration issues in the Genero Browser Client User Guide.