Share via


Setting Up the Source Files for a Custom Shell

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

8/28/2008

This topic describes how to add unique shell source code to your Windows Embedded CE installation while preserving the original shell source.

By default, all Windows Embedded CE-based OS designs compile the shell source code in the %_WINCEROOT%\Public\Shell directory. Thus, changes made to the shell source code in this directory affect all OS designs.

The source files that create the shell are in %_WINCEROOT%\Public\Shell\Oak\Hpc. It is recommended that you leave this file and directory structure intact. This preserves clean source code for future reference. More importantly, preserving the original H/PC code in its original path enables you to successfully install future product updates from Microsoft.

The file %_WINCEROOT%\Public\Shell\Oak\dirs is the only file in the update path you need to alter.

To setup your source files

  1. Copy the files and directories in %_WINCEROOT%\Public\Shell\Oak\Hpc to %_WINCEROOT%\Public\Shell\Oak\<Shell Name>.

    The shell name should have no spaces and must be unique compared to all file, directory, and subdirectory names within your %_WINCEROOT% directory.

  2. Back up the file %_WINCEROOT%\Public\Shell\Oak\Dirs by saving it as dirs_original in the same directory.

  3. Replace the existing code in the dirs file with the following code, which allows you to optionally build your custom shell.

    OPTIONAL_DIRS= hpc \
                   <Shell Name>
    
  4. If you want to build other shells, such as the default shell in %_WINCEROOT%\Public\Shell\Oak\Hpc, list them as optional directories.

See Also

Tasks

How to Customize the Shell

Other Resources

Dirs File
OPTIONAL_DIRS
Sources File
Makefile File