Cloning a Catalog Item (Windows CE 5.0)

In Platform Builder, you might want to make changes in a selected OS design by making changes to source code in the %_WINCEROOT%\Public tree. However, if you modify the source code in its original location, you can unintentionally create build issues and bugs that are difficult to trace, and you might replicate your changes in future OS designs.

Also, if you are using source control management, you can increase the size of the file set for source control management.

To avoid these issues you can clone the Catalog item associated with the source code, creating a project in your OS design that contains copies of the libraries associated with the Catalog item. This enables you to modify the source code in the project while leaving the source code in the Public directory tree intact.

After you complete modifying the cloned libraries, you can build a run-time image based on your OS design. During this build, during the Sysgen phase, the cloned libraries are used instead of the original libraries to create the module.

Note   To build a run-time image based on an OS design which includes modified libraries that you have cloned, you must configure build options and then select Sysgen from the Build OS menu.

Do not perform a Build and Sysgen, because this builds the OS tree and then performs a Sysgen.

If there is no associated Catalog item and you want to duplicate a part of the %_WINCEROOT%\Public tree or a shell component, see How to Duplicate a Public Directory as an OS Design Directory. However, completing the steps described in that topic does not directly generate a Catalog item in your OS design.

To clone a Catalog item

  1. Create or open a workspace containing an OS design you want to modify.

  2. In the Catalog, select the Catalog item you want to clone into your OS design and then, from the context menu, choose Add to OS Design.

    The item is added to your OS design as an user-specified Catalog item.

  3. In the Workspace window, on the OSDesignView tab, select the Catalog item you added and then perform one of the following:

    • From the context menu, select Clone Catalog Item.
    • From the Platform menu, select Clone Catalog Item.

    The Clone Libraries dialog box appears.

  4. In the Clone Libraries dialog box, select the libraries you want to clone and then select OK.

    The cloned libraries are copied to a new user-created project that is displayed on the FileView tab. This is also displayed on the OSDesignView tab under the folder Projects.

You have cloned libraries associated with a selected Catalog item, and are now ready to continue modifying the libraries.

See Also

Adding Catalog Items to an OS Design | Run-Time Image and OS Directories | Shared Source Code Directories | How to Duplicate a Public Directory as an OS Design Directory

Last updated on Thursday, February 02, 2006

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.