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

1/6/2010

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 subprojects in Platform Builder for Windows Embedded CE 6.0. Unless you explicitly change the settings in Platform Builder for CE 6.0 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 Project menu, choose Properties.

    The Property Pages dialog box for your OS design appears.

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

  3. In the left pane, choose Custom Build Actions.

    The controls on this page 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 Property Pages dialog box, choose OK.

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

  1. In Solution Explorer, choose Parameter Files.

  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)\<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

Concepts

Adding to an OS Design

Other Resources