GBC 4.01
Customization
How customization works
Planning for the customization Getting the customization to the user
Set up your GBC build environment Create a customization project Rebuild the GBC
Create a runtime package Deploy on GAS Deploy on JGAS Change the version customization suffix
Manage themes
Add a theme part Add a theme Modify a theme Delete a theme
Replace an image
Change the favicon Change background image for empty tabbed container
Use theme variables
Display or hide the sidebar Customize the chromebar Change checkbox icons Display the Genero context menu Change relog prompt
Use style sheets
Center progress indicator icon Center file loading icon
Use widgets
Add header image Add header image using style class Add header text Add footer text Change file loading icon Redirect application end Extend the MainContainerWidget
Internationalize your app
Add localized text Configure right-to-left languages Customize translation text Default encoding
Migrating customizations
Change the version customization suffix

When you package and deploy a customized version of the Genero Browser Client (GBC), a suffix is appended to the version number. This suffix lets users know that the version of the GBC is a customized version. By default, the suffix is "c", and it appears in:

  • the version number displayed in the Info dialog of the GBC interface.
  • the name of the GBC runtime package created for the customization.

This procedure shows you how to change the suffix from the default (c) to a value of your own choosing.

Before you begin

  • You have a customization directory, gbc-project-dir/customization/customization-project-dir with a config.json file. If the file does not exist, create it.

TIP: Use a copy of the config.json file provided in the sample customization folder as a starting point.

Update the config.json file

Edit gbc-project-dir/customization/customization-project-dir/config.json to define customizationSuffix in the root object of the config.json file of your customization, as in this example:

{
    "customizationSuffix" : "mySuffix",
    "themes": [{
      "name": "default",
      "title": "Default",
      "uses": ["platform/desktop", "common"]
    },
    ... additional themes would be listed here ...
  ]
}

Effect on version information displayed

With customizationSuffix set to mySuffix, the version information displayed now displays:

  • Version 1.00.xx.mySuffix, where xx represents the build number.

Effect on GBC customization package file

With customizationSuffix set to mySuffix, the GBC runtime package name (created with the gbc build option --create-zip) now includes the suffix. The GBC runtime package file name is:

  • fjs-gbc-1.00.xx.mySuffix-buildyyyyyyyyyyy-customization_sample.zip, where xx represents the build number and yyyyyyyyyyy represents the build timestamp.