Share via

Requirements for .NET Compact Framework Support (Windows Embedded CE 6.0)

  • Article

1/6/2010

In order for plug-ins based on the Microsoft Remote Tools Framework to function as expected, .NET Compact Framework 1.0 must be installed on both your developer workstation and on the target device. This is because Microsoft.RemoteToolSdk.DeviceComponents.dll depends on .NET Compact Framework 1.0 in order to function.

To obtain .NET Compact Framework 1.0, go to this Microsoft Web site. You can also obtain .NET Compact Framework 2.0, which also supports development with the .NET Compact Framework 1.0 API. For more information, see the Installation and Release Notes in your Windows Embedded CE 6.0 Platform Builder Service Pack 1 installation.

The Remote Tools Framework Plug-in Project Wizard generates projects that are already configured to enable plug-ins to function under .NET Compact Framework 1.0, and the sample plug-in projects also provide this capability.

However, if you have chosen to manually create a new plug-in, to ensure that the device-side component of the plug-in will run as expected, perform the following steps.

Creating a configuration file to provide .NET Compact Framework 2.0 support for your device-side application

  1. Use the following code sample to create an XML file that uses the same name as the device-side component, and which has a .config file extension.

    <?xml version="1.0" encoding="utf-8"?>
<configuration> 
  <startup> 
    <!-- see https://blogs.msdn.com/davidklinems/archive/2004/08/03/207372.aspx and https://blogs.msdn.com/davidklinems/archive/2005/04/19/409541.aspx -->
    <supportedRuntime version="v2.0.5238"/> 
  </startup> 
</configuration>

  2. Save the file, and then on the device, place it in the same folder as the device-side component.

    This file overrides the device-side component's compile-time association with .NET Compact Framework 1.0. This enables the component to run under .NET Compact Framework 2.0, if it is present on the device, but does not prevent it from running under .NET Compact Framework 1.0 if .NET Compact Framework 2.0 has not been installed. This is because .NET Compact Framework 1.0 does not support .config files and ignores them.

  3. Modify the .cebundleinfo file for the plug-in project to include the XML file as a file component for the specific device package that contains the executable for the device-side component. This allows the .config file to be downloaded to the device along with the device-side component.

See Also

Concepts

Required OS Dependencies for Plug-ins

Other Resources

Remote Tools Framework