Setting Up the Source Files for a Custom Shell (Windows CE 5.0)

Windows CE 5.0
Send Feedback

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

By default, all Windows 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

How to Customize the Shell | Dirs File | OPTIONAL_DIRS | Sources File | Makefile File

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.