Palm Developer Center

Note:

Documentation for webOS 2.1 is included in a separate download, shown below. The download includes updated API documentation and sample code.


Install the HP webOS SDK on Ubuntu

1. Update the Package Repository Information

  1. Update the Package Repository Information to /etc/apt/sources.list:

    If you are using 10.04 (Lucid Lynx):

    deb http://download.virtualbox.org/virtualbox/debian lucid non-free

    If you are installing on 9.04 (Jaunty Jackalope):

    deb http://download.virtualbox.org/virtualbox/debian jaunty non-free
  2. Download and register the Oracle® public key for apt-secure:

    wget -q http://download.virtualbox.org/virtualbox/debian/oracle_vbox.asc -O- | sudo apt-key add -
  3. Refresh the package index files:

    sudo apt-get update

2. Install Java™

Download and install the Oracle Java Runtime Environment (JRE). The SDK is incompatible with the default Ubuntu GNU Compiler for Java (GCJ). Example:

sudo apt-get install sun-java6-jre

From time to time, typically after installing Ubuntu system updates, the default Java setting can get changed to something other than sun-java6. Ensure that sun-java6-jre is set as the default by typing 'sudo update-alternatives --config java', and select '/usr/lib/jvm/java-6-sun/jre/bin/java' if it is not already starred as the default. This may need to be done again in the future if the palm-emulator stops working or tells you that the default Java setting is not correct.

3. Install VirtualBox

The webOS emulator is built on VirtualBox™, virtual machine software that you can download free from Oracle. VirtualBox is required before installing the HP webOS SDK. Note that the webOS emulator does not yet support VirtualBox 4.0.

Installing or Upgrading VirtualBox
  1. If you are upgrading from a previous version of VirtualBox, follow the instructions to "Uninstall the webOS Emulator and Virtual Machine" on this page.

  2. Install the new version of VirtualBox:

    sudo apt-get install virtualbox-3.2 

Note: If virtualbox-ose is installed (or suggested) instead of virtualbox-3.2, this is a sign that apt-get did not properly parse the packages from download.virtualbox.org and is instead trying to pull an old VirtualBox 1.5 binary from Ubuntu's own repositories. Make sure to register the repository key before doing the update. If there is an issue with using the Ubuntu repository, you can also download and install VirtualBox manually here: http://www.virtualbox.org/wiki/Download_Old_Builds.

Click here to go directly to the VirtualBox Linux page.

4. Install ia32-libs (on 64-bit systems only)

If you are installing on a 64-bit system, perform the following additional step before installation:

sudo apt-get install ia32-libs

If you happen to have installed palm-novacom before installing ia32-libs, then you must restart palm-novacom:

sudo stop palm-novacom
sudo start palm-novacom

5. Install the HP webOS SDK for Linux

 

 

If you are installing on a 32-bit system, perform the following steps to install the SDK:

sudo dpkg -i palm-sdk_2.1.0-svn409992-pho519_i386.deb
sudo dpkg -i palm-novacom_1.0.64_i386.deb

If you are installing on a 64-bit system, perform the following steps to install the SDK:

sudo dpkg -i --force-architecture palm-sdk_2.1.0-svn409992-pho519_i386.deb
sudo dpkg -i --force-architecture palm-novacom_1.0.64_amd64.deb

6. Download the webOS 2.1 SDK documents

  1. Download the documents package.
  2. Unzip the package to a convenient location. Documentation is in a subfolder called "docs", and sample code is in the "samples" subfolder.
  3. From the "docs" subfolder, open the file "docs.html" in your browser to view the webOS 2.1 SDK documentation.

Note: If you experience installation issues, try a clean install. To uninstall, follow uninstall instructions.

What's Next?