Creating New Cartridge Projects

Cartridge projects are collections of entities that you deploy to a run-time environment to support your business processes.

To create a Cartridge project:

  1. From the Studio menu, select New, then select Project, and then select the type of cartridge project to create.

    The New Project dialog box appears.

  2. In the Project Name field, enter a name for the project.

    Project names must be unique in the workspace. The cartridge and resultant archive file use the name that you enter here. Do not enter spaces or periods in this field. Oracle recommends a naming convention of lowercase letters separated by underscores. For example, my_cartridge.

  3. (Optional) Select a location for the project.

    By default, Design Studio saves the project to your default workspace location. To identify a location different from the default:

    1. Deselect Use default location.

    2. Click Browse.

    3. Navigate to the directory in which to save the project.

    4. Click OK.

  4. In the Target Version field, indicate the version of the run-time software to which you will deploy the cartridge.

    Note:

    The value in the Target Version field is used by Design Studio to build your cartridge project to be compatible with the run-time version to which you want to deploy the project. Select the highest version number that is equal to or less than the version of the run-time software to which you want to deploy the project.

  5. In the Execution Environment field, select an execution environment for the target version.

    Design Studio pre-populates this field (based on the selection in the Target Version field) with the recommended environment for the target version. You can select a different supported version from the list. When you create the project, Design Studio automatically configures the JRE System Library and the compiler compliance setting.

    Design Studio obtains the list of execution environments from the Eclipse workspace configuration. To view the list, from the Windows menu select Preferences, then expand Java, then expand Installed JREs, then select Execution Environments.

  6. In the Package Name field, define the default implementation package name to be used as a prefix for generated code.

  7. Click Finish.

    Design Studio adds the new Cartridge project to the Studio Projects view. In addition to containing the Project entity, the project may also include system-supplied entities, such as a Data Schema entity.