The Windows CE .NET Platform Export Tool (CEPET) may not include all the necessary files for a shared platform (823607)


The information in this article applies to:

  • Microsoft Windows CE .NET 4.2
  • Microsoft Windows CE .NET Operating System 4.1

SYMPTOMS

The Windows CE .NET Platform Export Tool (CEPET) parses project files to determine the specific source files that must be included when sharing a platform. However, CEPET may not list or may not include all the correct files, as described in the following:
  • Some files that you must have to fully build a platform may not be automatically included in the list of files that are to be shared.
  • Some files that were previously included in the shared platform (but that have been deleted), may be incorrectly listed in the shared platform.
If you do not have the CEPET tool already installed, you will not experience the problem that is described in this article.

CAUSE

These files may not be included or are included incorrectly in the shared platform, for the following reasons:
  • The files were added to the project or deleted from the project after a previous shared platform installation package was created.
  • The files are listed in the External Dependencies project folder.
  • The CEPET tool did not correctly parse the source file name.

RESOLUTION

To resolve this problem, use one of the following methods:

Manually Add the Missing Files

To manually add any missing files to the shared platform, follow these steps:
  1. Start the Windows CE .NET Platform Export Tool Wizard.
  2. In step 3 of the CEPET wizard, the Directories and Files dialog box appears.
  3. To add the missing files, click the Add file here button, and then select the files that you want to add.
  4. Complete the remainder of the 8 steps in the wizard, and then click Finish.
Although some files that no longer exist in the platform may be listed in the "Files and directories included in this platform" section of step 3, you may not be able to delete the files by means of this dialog box. If this condition occurs, remove and re-create the shared platform export file as described in the next section.

Remove and Re-create the Shared Platform Export File

If the steps in the "Manually Add the Missing Files" section do not resolve the problem, you can remove and re-create the shared platform export file.

When you create a shared platform, your settings for that shared platform are saved in the Options.xml file. This file is stored in the CEPET subdirectory, in your shared platform's root directory. If this file exists, the project files will not be parsed again, and the CEPET will re-use all project settings from the previous session.

To fix this problem, follow these steps:
  1. Before you run the CEPET tool, remove the Options.xml file.
  2. In the CEPET wizard, enter all the information that is requested.

    After you successfully complete the steps in the CEPET wizard, the Options.xml file is re-created.
If these steps do not resolve the problem, manually edit the Options.xml file, as described in the next section.

Edit the Shared Platform Export File

If the steps in the "Remove and Re-create the Shared Platform Export File" section do not resolve the problem, you can edit the shared platform export file, Options.xml.

To remove the references to your project from the Options.xml file, follow these steps:
  1. Open Options.xml from the following folder:

    %WINCEROOT%\Public\Platform Name\Cepet

  2. Search for your project name. You can expect to find it listed in both the Projects node and in the <ROOT> node.
  3. Remove the Projects node that contains a reference to your project by deleting the following lines of code from Options.xml:

    Note "ProjectName" refers to the name of your project.
    <PropertyBag NAME="Projects">
	<PropertyBag NAME="ProjectName">
		<Property NAME="Project PBP">.\ProjectName\ProjectName.pbp</Property>
	</PropertyBag>
</PropertyBag>
  4. Remove your project from the <ROOT> node by deleting the whole <PropertyBag NAME="ProjectName"> node, as shown in the following sample code. This removes both the reference to your project and the files in the project.

    Note - "ProjectName" refers to the name of your project and "Filen" refers to the files in your project. The file names in your project may differ from what is shown in the following sample code.
    <PropertyBag NAME="ProjectName">
	<Property NAME="Type">0x0001</Property> 
		<PropertyBag NAME="Children">
			<PropertyBag NAME="ProjectName.pbp">
  				<Property NAME="Type">0x0000</Property> 
  			</PropertyBag>
				<PropertyBag NAME="ProjectName.cpp">
  				<Property NAME="Type">0x0000</Property> 
  			</PropertyBag>
				<PropertyBag NAME="ProjectName.rc">
  			<Property NAME="Type">0x0000</Property> 
  			</PropertyBag>
			<PropertyBag NAME="File1.cpp">
  				<Property NAME="Type">0x0000</Property> 
  			</PropertyBag>
			<PropertyBag NAME="ProjectName.h">
				  <Property NAME="Type">0x0000</Property> 
			</PropertyBag>
			<PropertyBag NAME="File2.h">
				<Property NAME="Type">0x0000</Property> 
			</PropertyBag>
			<PropertyBag NAME="File1.h">
				<Property NAME="Type">0x0000</Property> 
			</PropertyBag>
			<PropertyBag NAME="ProjectName.ico">
				<Property NAME="Type">0x0000</Property> 
			</PropertyBag>
			<PropertyBag NAME="ReadMe.txt">
				<Property NAME="Type">0x0000</Property>				 
  			</PropertyBag>
		</PropertyBag>
	</PropertyBag>
</PropertyBag>
  5. Save Options.xml.
  6. Run the CEPET wizard to export the platform.

    Note If step 3 of the CEPET wizard is blank, this indicates that the Options.xml file was not modified correctly. If this behavior occurs, follow these steps:
    1. Follow the instructions that are listed in the "Remove and Re-create the Shared Platform Export File" section that is listed earlier in this article.
    2. Repeat steps 1 through 6 in this section ("Edit the Shared Platform Export File").

STATUS

Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section.

MORE INFORMATION

The Windows CE .NET Platform Export Tool (CEPET) is a tool that makes it easy to prepare Windows CE .NET device platforms and runtimes for non-commercial sharing and collaboration.

Steps to Reproduce the Behavior

  1. Download and install the CEPET from the link that is provided in the "References" section.
  2. Use Platform Builder version 4.1 or version 4.2 to create a Windows CE .NET platform.
  3. Add a project in Platform Builder: On the File menu, click New Project or File.
  4. Save your workspace.
  5. Run the CEPET wizard and choose the default settings to export the platform.
  6. Using Platform Builder, modify the platform by deleting the project.
  7. Save your workspace.
  8. Run the CEPET wizard again, and select the same platform to export.

    Notice that in step 3 of the CEPET wizard, the old project files are still listed in the "Files and directories included in this platform" section. You cannot remove them.

REFERENCES

Windows CE .NET Shared Platforms Program

http://msdn.microsoft.com/embedded

Modification Type:MajorLast Reviewed:2/18/2005
Keywords:kbBug kbprb KB823607 kbAudOEM kbAudDeveloper
©2004 Microsoft Corporation. All rights reserved.