Creating a Catalog Item that Represents an Application
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/27/2008
This topic describes how to create and set properties for an item in a Catalog file so that it can represent an application in the Platform Builder Catalog.
To create a Catalog item, you must have already created a Catalog file. For more information about creating Catalog files, see Using the Catalog Editor to Create a Catalog File.
To create a Catalog item that represents an application
In Catalog Editor, choose the Add arrow, and then choose Catalog Item.
Browse to the new Catalog item and select it.
The Properties window displays the property settings for the selected Catalog item in the .pbcxml file.
Click in the box next to Supported CPUs, select which CPUs will support your application, and then choose OK. In this example, select x86.
Click in the box next to Type, and then choose the Catalog item group to which you want to add your application. In this example, choose General.
In the box next to Title, type a name for the Catalog item that you want to add to the Catalog. In this example, type "My Application".
In the box next to Unique Id, type a unique ID for the Catalog item that follows the expected format. For your application, use the format Item:VENDOR:SYSGEN, where Item is the name of the Catalog item, VENDOR is the name of the Catalog item vendor, and SYSGEN is the Sysgen variable. In this example, type "MyFeature:MyCompany:sysgen_my_app".
Click in the box next to Modules, and type the full name of each file that represents a module that implements the functionality of your application. For example, if you built a subproject named MyApp, type "MyApp.exe". Choose OK.
In the box next to Sysgen variable, type a Sysgen variable for your selectable Catalog item. In this example, type "SYSGEN_MY_APP".
Note
The Sysgen variable must be the same as the Sysgen substring that you specified in Unique Id.
Add any additional property values that you want for the Catalog item. For more information about property values, see Catalog Item Properties.
To add a link to application source code, add a source-code link to the Catalog item. This source-code link is for display purposes only. For more information about source-code links, see Adding a Source Code Link to a Catalog File.
On the File menu, choose Save <MyCatalogFile>.pbcxml.
See Also
Tasks
Using the Catalog Editor to Create a Catalog File
Concepts
Catalog Item Properties
How to Add an Application to the Catalog