Red App Bundle Requirements

These requirements include layout, components (digital certificate bundle.crt, bundle.properties, JARs), JAR file names, bundle ZIP file name, size, and an example.

Standard Red App Bundle Layout

You are required to format the package for your Red App bundle according to the following example. This layout assumes that the Red App bundle ZIP file has the following name: My_Red_App_1.0.0.201107211322.zip

        /bundle.crt

        /bundle.properties

        /plugins/

        /plugins/com.mycompany.myredapp_1.0.0.201107211322.jar

        /plugins/com.mycompany.myeditor.basic.dependency1_1.0.0.201107211322.jar

        /plugins/com.mycompany.myhorizontalview.dependency2_1.0.0.201107211322.jar

        /plugins/com.mycompany.loggerservice.dependency3_1.0.0.201107211322.jar

NOTES:

The bundle.crt and bundle.properties files must be located in the root of the bundle.

The main Red App plug-in JAR and dependent JARs are located in the /plugins folder.

Whether the functionality in a Red App is contained within a single project or distributed among multiple projects, all JARs for each plug-in project must be located in the plugins directory in the Red App bundle ZIP file layout.

Bundle Components: bundle.crt, bundle.properties, and JARs

The minimum components in a Red App bundle ZIP file are described below:

  • bundle.crt file. This file is the valid digital certificate of the provider of the Red App. The file is the actual certificate that a developer used to sign the files. The digital certificate must be valid for a minimum of 30 days, starting from the date that Sabre validates your submitted Red App. The certificate must be obtained from one of the vendors that Sabre approves.

  • bundle.properties file. This file contains important metadata about the Red App. The content of this file is explained below.

        redapp.bundle.id is the Plug-in ID of the main Red App plug-in. For information about Plug-in IDs, see Main and Dependent Plug-in IDs.

        redapp.bundle.version is the 4-part version number of the main Red App plug-in. For information about plug-in versions, see Main Red App and Dependent Plug-in Versions.

        Sample Entries in bundle.properties

redapp.bundle.id=com.mycompany.myredapp
redapp.bundle.version=1.0.0.201107211322

  • Digitally-signed JAR file for the main Red App plug-in

  • Digitally-signed JAR files for all dependent plug-ins

For information about digitally signing the JAR files and creating the bundle.properties file, see Preparing to Create and Upload a Red App Bundle. This topic describes several options for creating your bundle.

JAR File Names within a Red App Bundle

Requirements for all JAR file names within a Red App bundle are listed below.

        The format is Plug-in ID + _ separator + plug-in version + .jar

The main jar file has the following requirements:

  • The file name has a maximum of 100 characters.

  • The file conforms to Java conventions for JAR file names.

For examples of JAR file names, see Bundle and JAR File.

Red App Bundle ZIP File Name

The bundle ZIP file name has a maximum character count of 160. The file name can include alphanumeric characters, spaces, and underscore characters.

The format for the name of the Red App bundle ZIP file consists of the following parts:

        Red_App_Name_ + major.minor.patch. + date-time qualifier + .zip

        Where:

Red_App_Name is the name of the main Red App plug-in in the bundle. This part of the ZIP file must match the name of the Red App that you used in your Red App proposal and the name in the Bundle-Name field in MANIFEST.MF of the main Red App plug-in.

_ separates the name from the version. The ZIP file name may exclude the underscore characters that separate the Red App name.

major.minor.patch.date-time qualifier is the release version of the main Red App plug-in. The version number part of the file name conforms to Red App versioning standards.

.zip is the file type.

        Example: My_Red_App_1.0.0.201107211322.zip

The following examples show how the ZIP file name changes, based on several releases:

First release of a Red App:    My_Red_App_1.0.0.201107211322.zip

First patch release:   My_Red_App_1.0.1.201107311322.zip

First upgrade release:   My_New_Red_App_1.1.0.201110311322.zip

Bundle Size

The maximum size of the complete bundle ZIP file is 32  MBytes.

Example of a Company, Bundle, and JAR File

Assume the following company and product names:

        Company name: Acme

        Company domain name: acme.co.uk

        Red App marketing (product) name: London Trip Advisor+

The file names are as follows:

        Main Plug-in ID: co.uk.acme.londontripadvisor

        Main plug-in version: 1.0.0.201201162000

        Main JAR file name: co.uk.acme.londontripadvisor_1.0.0.201201162000.jar

        Red App bundle ZIP file name: London_Trip_Advisor_1.0.0.201201162000.zip

For related procedures, see the topics in the book "Creating and Securing a Red App Bundle."