Adding a File to a Run-time Image (Windows CE 5.0)

These steps apply to files that exist outside of the build system. They do not apply to files that are compiled by the build system, such as OS components and projects in Platform Builder. Unless you explicitly change the settings in Platform Builder to prevent it, the build system automatically adds the results of its compilations to your run-time image.

If you want your file compiled by the build engine, or if it needs to be processed by other functionality, you must take additional action. See Adding to an OS Design.

To copy a file to your release directory

1. From the Platform menu, choose Settings.

   The Platform Settings dialog box appears.

2. In the Configuration drop-down list, confirm that the correct configuration is selected.

3. Choose the Custom Build Actions tab.

   The controls in this tab allow you to insert your own commands into various stages of the build process. The following steps show you how to copy files to your release directory between the time your OS's binary files are built and the time your final run-time image is made. As a result, the copied files will be incorporated into your run-time image along with your other OS files.

4. In the Build step drop-down list, choose Pre-Make Image, and then choose New.

   The Custom Build Action dialog box appears.

5. To copy your file to your release directory, in the Custom build action field, type copy <Path>\<File name> %_FLATRELEASEDIR%\<File name>.

   As this demonstrates, you can use common Platform Builder environment variables in commands to make the commands more readable and more portable. For more information, see Miscellaneous Environment Variables.

6. To close the Custom Build Action dialog box, choose OK.

7. To close the Settings dialog box, choose OK.

To add a file from your release directory to your run-time image

1. In the Workspace window, choose the ParameterView tab.

2. Expand the root node of the parameters tree, navigate to the Project.bib file, and double-click to open it.

3. Edit the FILES section of Project.bib to add an entry for your file.

   FILES
   ; Name            Path                              Memory  Type
   ; --------------  --------------------------------  ------  ----
   <File name>     $(_FLATRELEASEDIR)&lt;File name>    NK      S

   The Name column contains the file name as it will appear in your run-time image. The Path column contains the name of the file as it appears in your release directory. For more information see FILES Section.

4. Save Project.bib.

See Also

How to Add a Media File to a Run-time Image

Last updated on Thursday, February 02, 2006

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.