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.
Note:
You can copy the contents of the sample customization 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.
-
Add customizations to achieve on 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.