Creating an Image Description

You can create an Image Description either manually, or by directly coping the structure and content of an existing runtime.

Create an Image Description Manually

To create an Image Description file that will be used to configure and generate a target image:

1. Make sure you have properly configured the environment as described in Prerequisites guide.
2. Select a preliminary created project/folder in one of the navigation views in the Workbench and use one of the following approaches:
   • From the File menu select New > Other or
   • From the Workbench window's toolbar, click on the down arrow of the drop-down menu on the New Wizard button and select Other.
3. Expand the OSGi node and click Image Description to open the corresponding wizard. Click Next.

   

4. In the New Image Description wizard specify the initial properties of the new Image Description file:
   • In the text field type the name of the project where the new Image Description file will be stored or select it from the listed projects in the pane below the field.

     In the Filename field enter the name of the Image Description.

   • Select one of the options from the Inherit from image pane to indicate whether you want to use the content of an existing Image Description file to create the new one. By default, the Do not inherit option is selected. To inherit the content of another Image Description, select it from the Workspace image drop-down menu if it is stored in your workspace or use the Browse button from the External image option to locate the .img file from your file system. From the picture bellow you can see how to specify the initial properties of an Image definition.

     

5. Click Finish to create the new Image Description file, or Cancel to quit the operation.

Generate an Image Description from a Connected Runtime

You can create an Image Description file directly by coping the structure and content of a runtime connected in the Frameworks view.

The core advantage is to be able to replicate an image based on an existing runtime that was generated on another machine or by a 3rd-party, if you do not have the original image descriptor.

1. Right-click on the root node of the OSGi Runtime's sub-tree and use the Create Image Description option.

   

2. In the New Image Description dialog specify a parent project or subfolders in the Eclipse workspace and click Next.
3. Select the bundles for the image and Click Finish.

Beware that it might not be possible to include in the resulting bundles which are not available in the PDE target platform. To leave such bundles out of the Image Description, select the Skip Missing Bundles option. On the next figure the New Image Description Window is shown:

The Image Description will become available within the specified project. You can open it in Eclipse for further configurations.

The OSS Disclosure is provided by Bosch.IO for the SDK as a whole and indicates all OSS included in the SDK and all applicable OSS licenses. Please be aware to check for each image created by the Image Builder on your own and sole authority what OSS is included in your image, what OSS licenses apply and how to comply with the applicable OSS license obligations. All information is provided in the notice files.