Running the Sample Application

The PDK comes with a sample app provided to verify and test your setup. The sample app can be run on the following host PCs:

Notes:

Running the Sample App on a Windows PC

A sample app (C:\Program Files\HP webOS\PDK\share\samples\simple) is provided with the PDK to verify your setup. You can run this app in one of two ways:

  1. From the command line - the sample app runs directly on the device.

  2. In the Visual Studio IDE - the sample app is run on the desktop.

When launched in Visual Studio, a red, multi-sided, rotating shape appears in its own app window. When run from the command line, the same rotating shape displays on the device.

image

Note:

To validate your setup, you only need to run the sample app in one of the described ways. If you are using Visual Studio, you may want to try both, as you will need to do both to develop and test your app.

Running the sample app on the device from the command-line

  1. Make sure the device is USB connected, powered and has developer mode enabled.

  2. Open a command prompt.

  3. Go to the C:\Program Files\HP webOS\PDK\share\samples\simple\windows\ directory.

  4. Execute the runit.cmd script. This script builds the app, then installs and runs it on the device.

In a few seconds, or less, the red, multi-sided, rotating shape displays fullscreen on the device.

Running the sample app in Visual Studio (desktop)

Note:

This procedure steps you through the configurations necessary for developing a desktop app in Visual Studio. Any version of Visual Studio that supports C/C++ should work for developing apps - 2003, 2005 and 2008 have been tested.

To run the sample app in Visual Studio:

  1. Launch Visual Studio.

  2. Configure the Visual Studio library and header search path to point to HP webOS PDK include header files and code libraries:

    1. Select Tools > Options.

    2. In the Options dialog box, expand the Projects and Solutions menu.

    3. Select VC++ Directories.

    4. In the Show Directories for drop-down list box, select Library files.

    5. Click your mouse below the last entry in the main text box (or click the Add New Line button).

    6. In the entry box that appears, type "C: Files webOS". (Doing this allows Visual Studio projects to link with PDK libraries for host PC development.)

    7. In the Show Directories for drop-down list box, select Include files.

    8. Repeat steps e and f to add entries for "C: Files webOS" and "C: Files webOS".

    9. Click OK.

  3. Open the simple project file (not backward compatible with 2003):

    C:\Program Files\HP webOS\PDK\share\samples\simple\windows\simple.sln.

  4. Build and run the project (Debug > Start Without Debugging).

A red, multi-sided rotating shape appears in an app window.

Note

In simple.cpp, you can see a few calls needed to use the GLES library:

Since these are only necessary in the desktop environment, they are enclosed in #if WIN32 directives.
In the future, these will be merged into the Windows SDL library and no longer be visible.

Running the sample app on the device from Visual Studio

Completing this procedure is not necessary for verifying your set-up, but running an app directly on the device from Visual Studio can be useful during the development process. Note that this bypasses the normal creating and installing a package on the device method.

  1. Launch Visual Studio.

  2. Complete the previous procedure - Running the Sample app in Visual Studio - and have the simple app open as your current project.

  3. Select Tools > External Tools. The External Tools dialog box appears.

  4. Click Add.

  5. For Title, enter "Run on Device".

  6. Next to the Command textbox, click the ... button.

  7. Browse to the ...\share\samples\simple\windows\ directory and select runit.cmd.

  8. For Initial Directory, select Solution Directory from the menu.

  9. Select the Use Output Window check box.

  10. Click OK.

  11. Make sure the device is powered, has developer mode enabled and is USB-connected.

  12. Select Tools > Run on Device.

The red, multi-sided rotating shape should appear fullscreen on the device. For more information about how it was built and transferred, inspect the runit.cmd script.

Running the Sample app on a Mac

A sample app (/opt/PalmPDK/share/samplecode/simple/) is provided with the PDK to test your setup. You can run this app in one of two ways:

  1. From the Terminal app - the sample app runs directly on the device.

  2. From the Xcode IDE - the sample app runs on the desktop.

Note:

To validate your setup, you only need to run the sample app in one of the described ways. If you are using Xcode, you may want to try both, as you will need to do both to develop and test your app.

Running the sample app on the device

To run the sample app on the device:

  1. Make sure the device is USB connected, powered and has developer mode enabled.

  2. Launch the Terminal app.

  3. Go to /opt/PalmPDK/share/samplecode/simple/mac.

  4. Execute the runit.sh script - "./runit.sh" or "sh runit.sh".

  5. When prompted for a password, press ENTER.

In a few seconds, or less, a red, multi-sided, rotating shape appears fullscreen on the device.

Running the sample app in the Xcode IDE (desktop)

To run the sample app from the Xcode IDE:

  1. Launch Xcode.

  2. Open /opt/PalmPDK/share/samplecode/simple/mac/simple.xcodeproj.

  3. Click the Build and Run button.

An app window, displaying a red, multi-sided, rotating shape appears.

Note:

Currently, you cannot run apps on the device from Xcode.