Previous Topic: Create the Folder StructureNext Topic: Start Bundle Builder from an Ant Task


Run Bundle Builder to Create a Bundle

You can run Bundle Builder from the command line or using an ANT task.

Follow these steps:

  1. Open a command prompt and change to the following folder:
    cs-home/jcs/tools/bundle_builder
    
  2. Run the bundle_builder script, using the following arguments:
    manifestfile

    (Optional) Identifies the bundle manifest file.

    If a bundle manifest file is provided, Bundle Builder uses the following information from this file:

    • The name of the bundle
    • The Java files to include in the bundle

    If no manifest file is listed, Bundle Builder creates a bundle fragment.

    jardir

    Lists the folders that contain Java files to be included in the bundle. Use a comma-separated list.

    Default: If you omit this argument, this defaults to the current directory.

    connectorjar

    The name of the connector JAR file. This file must contain connector.xml for the connector. Bundle Builder uses information in connector.xml to create the OSGi artifacts required to make the connector visible to the core connector server.

    This argument is ignored for bundle fragments.

    Default: If you omit this argument, Bundle Builder looks for a JAR file with the prefix jcs-connector.

    outputdir

    The directory to write the output to.

    Default: If you omit this argument, this defaults to the current directory.

    tempdir

    The folder to use for temporary files created by the bundle builder while creating the bundle.

    Default: If you omit this argument, this defaults to the home directory of the logged in user.

    resources

    A comma-separated list of resources to be included in the bundle.

    This can include items like static properties files, images, static xml documents etc.

    If the user will need to access a resource directly e.g. for customizations, then they should not be included in the bundle.

  3. The bundle builder creates the OSGi bundle.