PDK Tools

This section provides information about Plug-in Development Kit tools. These include tools for uninstalling your application from the device, transferring files to the device, browsing the device, logging into the device, and uninstalling the PDK from your host PC.

In this section:

See also Using Eclipse as a Front-end for GDB Debugging.

Uninstalling Your Application from the Device

To uninstall your application from the device:

  1. On your device, hold down the orange button key and tap your application's icon.

  2. Tap the Delete button.

Using pscp or scp to Transfer Files to the Device

Windows

On Windows, you can use the pscp (PuTTY Secure Copy) utility that comes with the PDK to transfer files from the host PC to a folder on the device using an SSH connection. You would use pscp at the command line.

Syntax: 

pscp -scp -P 10022 -pw "" <source-file> root@localhost:/<path>/<to>/<folder>

Example: 

pscp -scp -P 10022 -pw "" simple root@localhost:/media/internal

The above example transfers the simple executable (sample application) to the /media/internal folder on the device. The port (-P) is 10022 and an empty string ("") is entered for the password (-pw).

Mac

On the Mac, use scp to transfer files. Launch the Terminal application, then, at the command line, type the command scp. It is used in the same way as Windows except without 'pscp' and without the '-pw' option. After entering the command, you are prompted for the password. Press ENTER and the file is transferred.

Browsing the Device

You can use the nova-browser utility (requires Java JDK or JRE 1.6 installed) to browse folders and files on the device.

  1. Make sure the device is USB connected.

  2. Open a command prompt (Windows), or launch the Terminal application (Mac).

  3. On the Mac, type "export PATH=$PATH:/opt/PalmPDK/bin" and press ENTER. This puts the development tools in your path.

  4. Run nova-browser. The following window appears:

    image

You can browse folders and files as well as get or save files (see File and Get menus):

image

 

Logging into the Device

The Palm PDK comes with utility programs for logging into the device:

  • On Windows, use the PuTTY program — a terminal emulator application which acts as a client for the SSH protocol.

  • On the Mac, use the SSH program.

Windows

Note: Before you can use PuTTY (below), you need to run "pdk-device-install install" from a command-line prompt while the device is connected. This script installs a SSH daemon on your device that you can use to get shell access and that sample scripts use to copy files to the device.

To log into the device from Windows:

  1. On your host PC, launch PuTTY: Start > All Programs > HP webOS > webOS PDK > Putty. The PuTTY application window opens:

    image

  2. In the Host Name (or IP address) text box, enter "root@localhost".

  3. In the Port text box, enter "10022".

  4. Click Open. A Linux shell opens.

  5. At the password prompt, press ENTER (empty string).

Mac

To log into the device from a Mac:

  1. Launch the Terminal application.

  2. At the prompt, type "ssh –p 10022 root@localhost" and press ENTER.

  3. At the password prompt, press ENTER (empty string).

Uninstalling the SDK and PDK

Windows

  • Uninstall the SDK using the Control Panel's Add/Remove Programs utility.

Mac

  1. Open the Mac Disk Image: Palm_webOS_SDK<version>.dmg.

    If you did not save the previously downloaded Disk Image, you can download and run the uninstall script.

  2. Double-click the uninstall-previous-sdk.command script.

  3. Answer "yes" to the prompt.

  4. Enter your administrator password.