To provide a specific GBC to be used by an application, you can add the GBC runtime
package to the application path.
Before you beginYou 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 procedureIn 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.
-
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.
-
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/.
-
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/4.01/cfextwa.xsd">
<EXECUTION>
<PATH>applications/myapp/</PATH>
<MODULE>myModule.42m</MODULE>
</EXECUTION>
<UA_OUTPUT>
<PUBLIC_IMAGEPATH>$(res.public.resources)</PUBLIC_IMAGEPATH>
</UA_OUTPUT>
</APPLICATION>
-
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 stepsOnce 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 Application
information icon to open the Product identification dialog. The
version number is appended with the suffix as defined by the GBC customization.
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.