Delivering your application to end users

When you deliver the executable version of your application to users, you need to make sure that various files and programs are installed in the right places on the users’ devices or emulators. Table 27-5 presents a summary of the types of files you need to distribute. You will distribute most of these components using cabinet (CAB) files.

**Table 27-5: Distribution checklist**
Checklist item	Details
The application	Application files include: The executable (EXE) file Any dynamic libraries ( PKD files) Any files for resources you are delivering separately (BMP, GIF, ICO, JPEG, and PNG files)
Additional files	Additional files might include: Initialization (INI) files Text or sound files
External files	If the application references external files, such as DLL files accessed by external function calls, install them in the \Windows directory on a Pocket PC or in the \Storage\Windows directory on a Smartphone.
PocketBuilder runtime DLLs	The following DLLs can or must be installed in the \Windows directory on every Pocket PC device or in the \Storage\Windows directory on every Smartphone device: pkvm25.dll virtual machine, required for all users pkdwe25.dll for DataWindow engine support pkhdw25.dll for barcode, GPS, RFID, and fingerprint readers pkphn25.dll for phone support pkpoom25.dll for Pocket Outlook support pkicn25.dll for standard bitmaps and icons pkbgr25.dll for graph support pkodb25.dll for ODBC database support pkul925.dll for UltraLite 9 support pkul1025.dll for UltraLite 10 support You can use the Enhanced CAB Generation tool to select the DLL files you want to include in the CAB file that the tool generates for deployment of your application. For more information, see “Building CAB files with the Enhanced CAB Generation tool”.
Database files	You must install the pkodb25.ini initialization file, along with the pkodb25.dll file, for ODBC database support. If the application needs to access a local database, install the database files on each device. Typically you install the data source (the DSN file) in the device’s root directory, and install the database and its log file in the same directory as the application. Make sure that the DSN file references the location where you install the database.
Network server	If the application needs to access a consolidated database on a server, the device must be properly connected, and the databases on the device and the server must be correctly configured. For more information about synchronizing databases on the server and device, see the chapter in the Resource Guide about using MobiLink synchronization and the Mobilink Server Administration book in the SQL Anywhere online book collection.
Windows CE registry	If you rely on the Windows CE registry to manage information needed by the application, update the registry on each device with required values.

The rest of this chapter describes how you create CAB files and deliver them to your users. You can build CAB files with the Project painter or with the Enhanced CAB Generation tool.