Share via


Cloning a Catalog Item (Windows Embedded CE 6.0)

1/6/2010

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 Rebuild from the Build menu.

Note

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

To clone a Catalog item

  1. Create or open an OS design that you want to modify.

  2. In the Catalog Items View, select the Catalog item you want to clone into your OS design and then, from the context menu, choose Clone Catalog Item if that option is available.

    The Clone Catalog Item dialog box appears.

  3. In the Clone Catalog Item dialog box, select the libraries you want to clone and then select OK.

    The cloned libraries are copied to new subprojects that are displayed in Solution Explorer under the folder Subprojects.

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

See Also

Concepts

Adding Catalog Items to an OS Design

Other Resources

Run-Time Image and OS Directories