Create a customization project

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.

  1. 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.

  2. 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.


    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.

  3. Add customizations to achieve on your customization goals.
  4. 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.