Creating An Xml Provisioning File; Xml Provisioning Vs. Regmerge And Copyfiles; Regmerge - Symbol MC909X Integrator Manual

8 - 8 MC909X Integrator Guide

Creating an XML Provisioning File

To create a .cpf file:
Create a valid provisioning XML file named _setup.xml using an XML editor or the tools supplied with
1.
Visual Studio 2005. (For example, use the SampleReg.xml sample created in the
and rename it _setup.xml.) Ensure the file contains the required parameters for the operation. Refer to the
Microsoft Windows Mobile 5.0 Help file for information.
In the Windows Mobile 5.0 tools directory on the desktop computer (typically \Program Files\Windows CE
2.
Tools\wce500\Windows Mobile 5.0 Pocket PC SDK\Tools), run the Makecab.exe utility, using the following
syntax to create a .cpf file from the _setup.xml file:
MakeCab.exe /D COMPRESS=OFF _setup.xml myOutCpf
C
NOTE OMPRESS=OFF is required for backward compatibility with Pocket PC.
Optionally, use the Authenticode tools to sign the .cpf file.
3.
Tap the filename to install.
4.
Certain applications and settings require a cold boot to take affect. In these cases, cold boot the mobile
5.
computer. Refer to the Windows Mobile Version 5.0 Help file for more information.

XML Provisioning vs. RegMerge and CopyFiles

Prior to Windows Mobile 5.0, Symbol used two drivers (RegMerge and CopyFiles) to update the registry and to
copy files during a cold boot. With Windows Mobile 5.0, Symbol recommends using XML provisioning instead.
RegMerge and CopyFiles are supported for backward compatibility but Symbol may eliminate support in the
future. The following sections provide examples of how RegMerge and CopyFiles were used, and how to
perform the same function using XML provisioning.

RegMerge

RegMerge.dll is a built-in driver that allows updating the registry during a clean boot. RegMerge runs very early
in the boot process and looks for registry files (.reg files) in certain Flash File System folders (i.e., \Application)
during a clean boot. It then merges the registry changes into the system registry located in RAM.
The following example uses RegMerge to set a registry key:
SampleReg.reg
[HKEY_LOCAL_MACHINE\Hardware\DeviceMap\Backlight]
"BacklightIntensity"=dword:00000036
RegMerge section below