Copying files to a device or emulator

When you select a complete install in the PocketBuilder setup program, or when you select the Deployment Device Manual Install components on the Select Components page for a custom install, the setup program installs PocketBuilder VM files, pkvm25.dll and associated DLLs, and the applist.exe file in ARM (Pocket PC) and SPARM (Smartphone) subdirectories of the PocketBuilder 2.5\WinCE directory. Applist.exe is a program that makes it easier to locate and launch applications you build with PocketBuilder.

NoteDLLs for the device or emulator For most PocketBuilder applications, not all of the PocketBuilder DLLs are required. For information on which DLLs might or might not be required for your application, see the chapter on packaging and deploying an application in the Users Guide, or the What’s New topic on DLL repackaging in the online Help.

When you select a complete install, or when you select the PocketBuilder CABs for Deployment components in a custom install, the PocketBuilder setup program installs CAB files on the desktop that you can use to install PocketBuilder to a device or emulator. Each CAB file contains applist.exe and the PocketBuilder DLL files for a specific platform. The following CAB files are installed in the PocketBuilder 2.5\WinCE directory:

You can copy the CAB files or the individual DLLs to a device or emulator. Make sure that you copy the correct CAB file to the device or emulator where you want to install the PocketBuilder VM.

Instead of copying files manually, you can launch a setup program from the desktop Start menu to install PocketBuilder to a connected handheld device. The Setup PocketPC, Setup WM-5 PocketPC, and the Setup Smartphone commands from the Start>Programs>Sybase>PocketBuilder 2.5 menu install PocketBuilder to the connected device or emulator.

The SQL Anywhere setup program also installs files that you can copy to a device or emulator in platform-specific subdirectories of the SQL Anywhere 10\ce directory.

The following procedures describe how to copy files to a device or emulator.

StepsTo copy files to a Pocket PC or Smartphone device using ActiveSync and Windows File Explorer:

  1. On your desktop, open ActiveSync and click the Explore button.

    Explorer opens with Mobile Device as the current address.

  2. Navigate to the directory where the file or files are located on the desktop, select them, and select Edit>Copy.

    You can use the Up button in Explorer to navigate to the desktop, or you can browse to an address using the drop-down list in the Address toolbar or the Explorer.

  3. Use the Address drop-down list to return to the Mobile Device directory.

  4. Double-click My Pocket PC and navigate to the directory where you want to copy the files.

    DLL files must be installed in the \Windows directory. For a Smartphone, thic can be the \Storage\Windows directory.

  5. Select Edit>Paste to install the files.

  6. If you copied a CAB file, select Programs>File Explorer from the Start menu on the device, navigate to the directory where you copied the file, and tap it (Pocket PC) or press the Action button (Smartphone) to install its contents.

StepsTo copy files to a Pocket PC or Smartphone emulator using the Windows CE Remote File Viewer:

  1. On your desktop computer, open cefilevw.exe and select the device or emulator to which you want to copy files.

    By default, the cefilevw tool is installed in C:\Program Files\Windows CE Tools\Common\Platman\bin when you install the Pocket PC or Smartphone Software Development Kit.

  2. Navigate to the directory to which you want to copy a file.

    DLL files must be installed in the \Windows directory.

  3. Click the Export File button (a yellow Up arrow) on the toolbar.

  4. In the Export File dialog box, navigate to the directory where the first file you want to copy is located, select the file, and click Open.

    The Remote File Viewer copies the file.

  5. Repeat steps 2 to 4 for any additional files you want to copy.

  6. If you copied a CAB file, select Programs>File Explorer from the Start menu on the device or emulator, navigate to the directory where you copied the file, tap it (Pocket PC device), select it using the Action button (Smartphone), or click it (on the emulator) to unpack the CAB file and install the PocketBuilder VM.

NoteCopying CAB files to the Pocket PC 2002 or 2003 emulator If a CAB file is too large to copy, you can change the default memory configuration for the Pocket PC 2002 or 2003 emulator in the Windows registry. For instructions, see the Release Bulletin. When you shut down the emulator, make sure you select Save Emulator State. By default, files that you copy to the emulator are deleted when you shut it down.