Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
Microsoft Corporation
May 2000
Summary:This paper explains how to export a software development kit (SDK) from Microsoft Windows CE Platform Builder version 2.11 and install it on a computer for use with Microsoft Windows CE Toolkit for Visual C++ version 6.0. (4 printed pages)
Introduction
Microsoft Windows CE Platform Builder version 2.11 provides a
set of development tools designed to create custom configurations
of the Windows CE operating system (OS) for embedded devices.
Platform Builder can then package the OS configuration into a
software development kit (SDK), and you can export the SDK for your
use or for use by independent software and hardware vendors. This
SDK contains the tools and information needed to develop
applications for Windows CE-based platforms using Microsoft Windows
CE Toolkit for Visual C++. This paper assumes you have used Platform Builder to create a
custom Windows CE build and are ready to export its SDK. For
information about creating a custom Windows CE build, see the
Platform Builder documentation. Exporting an SDK from Platform Builder involves two procedures:
creating a Windows CE configuration using the Configuration Wizard
and then exporting the SDK using the Export SDK Wizard. Before you can export an SDK, Platform Builder needs to know
where the OS configuration is located on your hard drive. Using the
Configuration Wizard in Platform Builder, you must point to the
following files that define your OS:
When you export the SDK for a platform, Platform Builder refers
to the data collected by the Configuration Wizard and packages the
appropriate directories into a self-extracting executable file,
complete with headers, libraries, and OS components. This section first describes file paths that you might need to
add using the Configuration Wizard, and then gives a step-by-step
procedure for using the Configuration Wizard to add file paths. You must specify paths to all the files in your OS
configuration. If you want to create additional application
programming interfaces (APIs) that are not included in Windows CE,
you also need to add your dynamic-link library (DLL) and header
file paths. The paths should indicate the library and header files
located under the Cesysgen directory of your OS configuration. For
example, you could add the following Include paths. The header
files in these paths support software application and client device
driver development. For example, if you have built the OS configuration Maxall for
x86 and SH3 CPUs, you could point to files your software
application can link to by adding the following Library paths: If you are exporting files for an independent software vendor,
you only need to include files under the directory Cesysgen\Sdk. If
you are exporting files for an independent hardware vendor, you
must also include files under the directory Cesysgen\Ddk. In addition to including vendor-specific files, if you are
including support for Microsoft Foundation Classes (MFC) or Active
Template Library (ATL) in your Windows CE image, you must include
the MFC or ATL headers provided on installation CD 1. MFC and ATL
directories are located in the root directory on the CD. Copy these
entire directories to your development workstation and provide the
file paths, or provide the paths to the CD directories. To provide an independent software vendor with support for
debugging MFC or ATL applications, you must include paths to the
source files. For example, add paths such as the following: To add file paths:
You must provide paths to each directory. The Configuration
Wizard does not automatically include subdirectories.
If you need to verify or change the file paths for your
configuration:
After you create a configuration using the Configuration Wizard,
use the Export SDK Wizard to select the configuration and export
its platform SDK. The export process creates a compressed,
self-extracting executable file. To export an SDK:
If your Windows CE image includes MFC, MFC ActiveX, or ATL
support, and your configuration includes the appropriate paths,
select the check boxes applicable to MFC, MFC ActiveX, and ATL.
Selecting these check boxes does not cause the inclusion of the
MFC, MFC ActiveX, or ATL files. To include the files, you must have
added them to a Windows CE configuration you previously created.
The time required to export depends on the number of files to be
exported. Including MFC files, for example, noticeably increases
the export time. While the export is still in progress, the dialog
box displays "Exporting SDK to". When the export is complete, "SDK
Exported to" is displayed. To cancel the export, choose the Cancel button. To cancel the
export and change the SDK export options, choose the Back
button. Installing an exported SDK is as simple as double-clicking the
exported .exe file. The setup displays an EULA, which must be
accepted, and then installs all necessary files and settings on the
computer. The extracted files are placed in the directory
C:\Windows CE Tools\WCE211\projectname. The SDK is now available for developing Windows CE-based
applications using Microsoft Windows CE Toolkit for Visual C++.
After you open a workspace in the Toolkit, select the new
configuration supplied by the SDK as the active WCE configuration.
The active WCE configuration is the second box from the left on the
WCE Configuration toolbar. For more information about creating a custom Windows CE
configuration in Platform Builder, see the Platform Builder
documentation. For more information about using the Windows CE Toolkit for
Visual C++, see the Toolkit documentation.
Creating a Windows CE Configuration
Exporting an SDK
Installing and Using the SDK
For More Information
Introduction
Creating a Windows CE
Configuration
C:\wince211\public\MyOSProj\cesysgen\sdk\inc
C:\wince211\public\MyOSProj\cesysgen\ddk\inc
C:\wince211\public\MyOSProj\cesysgen\sdk\lib\x86\i486\ce\retail
C:\wince211\public\MyOSProj\cesysgen\ddk\lib\x86\i486\ce\retail
C:\wince211\public\MyOSProj\cesysgen\sdk\lib\shx\sh3\ce\retail
C:\wince211\public\MyOSProj\cesysgen\ddk\lib\shx\sh3\ce\retail
\
Atl\Src\Atl\Src\X86
\Mfc\Src
\Mfc\Src\X86
Exporting an SDK
Installing and Using the SDK
For More Information