This procedure sets up the structure for a new customization project. You can have
many customization projects in a gbc-project-dir;
however, each must have a unique name.
Before you begin
You should have prepared your development environment for GBC customization. If you
have not, follow the instructions at Set up your GBC build environment.
You need to know the location of gbc-project-dir.
-
Create a new directory in gbc-project-dir/customization. The name you give this new directory becomes the name of your customization.
For example, if you create gbc-project-dir/customization/companyA, then the customization is named companyA.
This directory will be referred to as the customization-project-dir throughout this documentation.
-
Set up the customization directory structure.
You do not need to create every folder mentioned; you only need to create
those folders needed to complete your customization.
Tip:
You can copy the contents of the default customization (named
sample) into your
new customization folder. However, you must then:
- Search and remove all customization entries that you do not want included in your new
customization.
- Change the version customization suffix from "sample" to a different value of your own choosing
for this new customization. For more information on setting the customization suffix, go to Change the version customization suffix
-
Add customizations to achieve your customization goals.
-
To build your customization, execute from a command prompt:
$ gbc build --customization customization/customization-project-dir
Alternatively, you can configure your GBC project to build your customization with a simple
gbc build command. See Configure your build.