Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
577 lines (425 sloc) 24.1 KB
<!-- Actual Content Starts Here -->
<div id="main" class="clearfix two-columns-right">
<div id="intro">
<ol class="hp-breadcrumbs">
<li><a href=
"https://web.archive.org/web/20130130211140/https://developer.palm.com/content/home.html"
target="_top" onfocus="blurLink(this);">Home</a></li>
<li><a href=
"https://web.archive.org/web/20130130211140/https://developer.palm.com/content/resources.html"
target="_top" onfocus="blurLink(this);">Resources</a></li>
<li class="ctx-last">SDK-PDK Download</li>
</ol>
<h1 class="page-title">SDK-PDK Download</h1>
<ul class="inline-icon-list">
<li><a onclick="window.print(); return false;" href="javascript:%20void(0);"
class="icon-print">Print</a></li>
<li><a href=
"https://web.archive.org/web/20130130211140/https://developer.palm.com/content/resources/develop/sdk_pdk_download.html"
target="_top" class="icon-mail addthis_button_email at300b" title=
"Email"><span class="at16nc at300bs at15nc at15t_email at16t_email"><span class=
"at_a11y">Share on email</span></span>Email</a></li>
<li class="last">
<div class="addthis_toolbox addthis_default_style">
<a class="icon-share addthis_button_compact at300m" href="#"><span class=
"at16nc at300bs at15nc at15t_compact at16t_compact"><span class=
"at_a11y">More Sharing Services</span></span>Share</a>
<div class="atclear"></div>
</div>
</li>
</ul>
</div>
<div id="content" class="col-content">
<div class="default-content article-content">
<a id="c23262" name="c23262"></a>
<div class="csc-textpic-text">
<h2 class="intro">Downloading and Installing the 3.0.5&nbsp;SDK and PDK</h2>
<p class="bodytext"><img src="assets/RTEmagicC_ref-sdk.png" alt="" width="118"
height="117" align="right">The HP webOS 3.0.5 SDK (<a href=
"https://web.archive.org/web/20130130211140/https://developer.palm.com/content/api/release-notes.html">release
notes here</a>)&nbsp;contains the libraries necessary to do both JavaScript
development and C/C++ development. For JavaScript development, the SDK includes
the command line tools needed to package, download, and debug applications, as
well as sample code, reference code, and reference documentation. For C/C++
development, the SDK also includes the Plug-in Development Kit (PDK), which
includes a GCC compiler, SDL and OpenGL code libraries, project templates,
sample source code, scripts, utilities, documents. You will be given an
opportunity to opt out of installing the PDK during the installation
process.</p>
<p class="bodytext">You can install the SDK on Windows, OS X, and Ubuntu Linux
host PCs. For C/C++ development, the SDK integrates with Visual Studio on
Windows, and Xcode on OS X, although you can use command-line tools if you
prefer. (App templates are currently only available for Xcode 3.6 and
earlier.)</p>
<p class="infobox"><b>Note:</b> PDK development is now supported for Linux. See
the Linux download section below for more information.</p>
<p class="bodytext">The SDK tools are also command-line based, but if you
prefer to use an integrated development environment (IDE) there are some options:
<ul>
<li>HP provided a <a href="eclipse.html">webOS plug-in for the Eclipse IDE</a>.
<li>Hobby developer, Jonathan Wise, is working on <a href="https://github.com/codepoet80/webos-vscode-extensions">VisualStudio Code extensions for webOS</a>.
</p>
<p class="bodytext">Ready to get to work? Click below on your platform of
choice to download:</p>
<ul class="def-list">
<li><a href="#windows">Windows</a></li>
<li><a href="#osx">OS X</a></li>
<li><a href="#linux">Ubuntu Linux</a></li>
</ul>
<div class="hr"></div>
</div>
<div style="height:20px;">
<!-- -->
</div><a id="c23272" name="c23272"></a>
<h2>Installing the SDK and PDK on a Windows PC</h2>
<div class="csc-textpic-text">
<p class="bodytext"><a name="windows" id="windows"></a></p>
<h3>Uninstall any existing SDK or PDK installations</h3>
</div><a id="c23292" name="c23292"></a>
<div class="note important">
<div class="inner">
<div class="content">
<h4>Warning:</h4>
<p><strong>SAVE YOUR DATA!</strong>&mdash;Uninstalling the SDK and PDK will
delete the directories in which they are installed. If you have project
source code in those directories <strong>it will be deleted!</strong></p>
<p>Your project source should <strong>not</strong> be stored in the SDK or
PDK installation directories.</p>
</div>
</div>
</div><a id="c28502" name="c28502"></a>
<div class="csc-textpic-text">
<ol>
<li>Uninstall the previous SDK (if present) using the Windows <i>Add/Remove
Program</i> control panel.</li>
<li>Uninstall the previous PDK (if present) by running <i>c:\Program
Files\Palm\PDK\uninstallpdk.exe.</i>
<ul class="def-list">
<li>When prompted, make sure you also un-install the Novacom driver.</li>
</ul>
</li>
</ol>
<h3>Install Java</h3>
<p class="nomargin">Download and install the latest version of Java&trade;.<br>
To verify that Java is installed, go to the Command Prompt and type:</p>
<pre>java -version</pre>
<p class="bodytext">If Java is installed, Java version information appears.</p>
<p class="def-button"><a href="https://www.java.com/en/download/" target=
"_blank">Download Java</a></p>
<h4>Note:</h4>
<p class="bodytext">If you are using a 64-bit version of Windows, you will need
to download Java&nbsp;from <a href="https://www.java.com/en/download/" target=
"_blank">https://www.java.com/en/download/</a>.&nbsp;You MUST do this in
Internet Explorer. Other browsers do not show the 64-bit Java Runtime
Environment installer. From here, follow the instructions for&nbsp;"Windows 7,
XP Offline (64-bit)". You can also download it directly from&nbsp;<a href=
"https://www.java.com/en/download/faq/java_win64bit.xml" target=
"_blank">https://www.java.com/en/download/faq/java_win64bit.xml</a>.</p>
<h3>Install Drivers</h3>
<p class="bodytext">The Novacom drivers are available for all supported platforms.</p>
<p class="def-button"><a href="https://1drv.ms/u/s!Av5IQUxnr8DUjN4jRgScLZJq_tn1ag" target="_blank">Download Drivers</a>
<h3>Install VirtualBox</h3>
<p class="bodytext">The webOS emulator is built on VirtualBox&trade;, virtual
machine software that you can download free from Oracle&reg;. VirtualBox is
required before installing the HP webOS SDK. <b>Note:</b> The webOS emulator
now runs on Virtualbox 4.0.36 r71416 and 4.1.0 r73009.</p>
<p class="def-button"><a href=
"https://www.virtualbox.org/wiki/Download_Old_Builds" target="_blank">Download
VirtualBox</a></p>
<h3>Install the HP webOS SDK for Windows</h3>
<ol>
<li>Download the appropriate Windows SDK installer (Windows Vista and Windows
7 only):
<p><a class="def-button" href=
"https://1drv.ms/u/s!Av5IQUxnr8DUjN4DdfeLRwQglBA31A" target=
"_tab">Download</a>&nbsp; SDK/PDK for 32-bit machines.</p>
<p><a class="def-button" href=
"https://1drv.ms/u/s!Av5IQUxnr8DUjN4B4tMmRI--EZeddQ" target=
"_tab">Download</a>&nbsp; SDK/PDK for 64-bit machines.</p>
</li>
<li>Ensure VirtualBox is not running before starting the webOS SDK
Installer.</li>
<li>Double-click the webOS SDK Installer file.</li>
<li>Proceed through the licensing agreements.</li>
<li>Click "Finish" to complete the installation.</li>
</ol>
<h3>Download the CodeSourcery Toolchain (PDK only)</h3>
<p class="bodytext">Perform this step only if you intend to do plug-in or other
C/C++ development.</p>
<p class="bodytext">If not already installed, download the CodeSourcery
Toolchain&mdash;Sourcery G++ Lite for ARM GNU/Linux.&nbsp;You can download this
from the <a href="http://www.codesourcery.com/" target=
"_blank">CodeSourcery</a>&nbsp;website.</p>
<p class="bodytext">To download the CodeSourcery Toolchain, go to:</p>
<p class="bodytext"><a href=
"https://sourcery.mentor.com/sgpp/lite/arm/portal/subscription3057" target=
"_blank">https://sourcery.mentor.com/sgpp/lite/arm/portal/subscription3057</a></p>
<p class="bodytext">Click on the "Sourcery G++ Lite 2009q1-203" link, and
download the&nbsp;Windows Installer.</p>
<p class="bodytext">If you have problems with this version, you can also try
version 2007q3-51.&nbsp;This is an older version for developers who&nbsp;run
into the following problems:</p>
<ul class="def-list">
<li>C++ exception handling &mdash; Unresolved links to versioned
symbols.</li>
<li><span class="inline_code">_libc_csu_init/fini</span> calls &mdash;
Unresolved links to versioned symbols.</li>
<li><span class="inline_code">__isoc99_sscanf</span> &mdash; Symbol added in
GLIBC 2.7 that gets used for calls to <span class="inline_code">sscanf</span>
unless you use <span class="inline_code">_USE_GNU</span> in your code. This
issue also requires a header file change and can not be fixed with just
changing libraries. This is also true of other <span class=
"inline_code">__isoc99</span> calls.</li>
</ul>
<h3>Verify the SDK Installation</h3>
<ol>
<li>Start the webOS emulator.</li>
<li>Click OK to dismiss the dialog boxes.</li>
<li>Create or choose a directory to use as your development workspace.</li>
<li>Open a Command Prompt window, and then type:
<pre>palm-generate</pre>
<p>to verify that the tools are installed:</p>
<ul class="def-list">
<li>If help information appears, the tools are correctly installed.</li>
<li>If palm-generate is not recognized as a command, the tools are not
correctly installed.</li>
<li>If java is not recognized as a command, Java is not correctly
installed</li>
</ul>
</li>
<li>Exit both the Command Prompt window and the emulator.</li>
</ol>
<div class="hr"></div>
</div>
<div style="height:20px;">
<!-- -->
</div><a id="c23352" name="c23352"></a>
<h2>Installing the SDK and PDK on a Mac</h2>
<div class="csc-textpic-text">
<p class="bodytext"><a name="osx" id="osx"></a></p>
</div><a id="c23362" name="c23362"></a>
<div class="csc-textpic-text">
<h3>Install Java</h3>
<p class="nomargin">Download and install the latest version of Java&trade; supported on your version of OS X.<br>
<p class="def-button"><a href="https://support.apple.com/en-us/HT204036" target=
"_blank">Download Java</a></p>
<h3>Install Drivers</h3>
<p class="bodytext">The Novacom drivers are available for all supported platforms.</p>
<p class="def-button"><a href="https://1drv.ms/u/s!Av5IQUxnr8DUjN4jRgScLZJq_tn1ag" target="_blank">Download Drivers</a>
<h3>Install VirtualBox&trade;</h3>
<p class="bodytext">The webOS emulator is built on VirtualBox, virtual machine
software that you can download free from Oracle&reg;. VirtualBox is required
before installing the HP webOS SDK. <b>Note:</b> The emulator now
supports Virtualbox 4.0.36 r71416 and 4.1.0 r73009.</p>
<p class="def-button"><a href=
"https://www.virtualbox.org/wiki/Download_Old_Builds" target="_blank">Download
VirtualBox</a></p>
<h3>Download the SDK/PDK disk image file</h3>
<p class="def-button"><a href=
"https://1drv.ms/u/s!Av5IQUxnr8DUjN4Eqq0T0WWYOWuZ8g" target="_blank">Download
SDK/PDK</a></p>
<h3><br>
Uninstall any existing SDK/PDK installations</h3>
</div><a id="c23382" name="c23382"></a>
<div class="note important">
<div class="inner">
<div class="content">
<h4>Warning:</h4>
<p><strong>SAVE YOUR DATA!</strong> &mdash;Uninstalling the SDK and PDK
will delete the directories in which they are installed. If you have
project source code in those directories <strong>it will be
deleted!</strong></p>
<p>Your project source should <strong>not</strong> be stored in the SDK or
PDK installation directories.</p>
</div>
</div>
</div><a id="c23392" name="c23392"></a>
<div class="csc-textpic-text">
<ol>
<li>Open the Mac disk image file.</li>
<li>Double click the <i>uninstall-previous-sdk.command</i> script.</li>
<li>Answer &ldquo;yes&rdquo; when prompted.</li>
<li>Enter your admin password when prompted.</li>
</ol>
<h3><br>
Install the HP webOS SDK/PDK for Mac</h3>
<ol>
<li>Ensure VirtualBox is not running before starting the webOS SDK
Installer.</li>
<li>Open the Mac disk image file if you haven't already.</li>
<li>Double-click the webOS SDK Installer file and follow the
instructions.</li>
<li>During installation, you will be given the option to install the PDK as
well. <i>Note that this option is selected by default.</i></li>
</ol>
<p class="bodytext">Once the SDK is installed:</p>
<ul class="def-list">
<li>The webOS emulator becomes available in the Applications folder.</li>
<li>The webOS command-line tools become available from the Terminal.</li>
</ul>
<p class="bodytext">We recommend that OS X users run the ssh-key-init script
for each device they use. This avoids being requested for a password when files
are transferred to the device using a shell.</p>
<div class="hr"></div>
</div>
<div style="height:20px;">
<!-- -->
</div><a id="c28522" name="c28522"></a>
<h2>Installing the SDK on Ubuntu Linux</h2>
<div class="csc-textpic-text">
<p class="bodytext"><a name="linux" id="linux"></a></p>
</div><a id="c28542" name="c28542"></a>
<div class="csc-textpic-text">
<p class="infobox"><b>A note about PDK development on Linux:</b> The current
SDK for Linux includes headers and libraries needed to do PDK development for
the device and for the emulator. It also includes an arm-gcc toolchain for
compiling applications for the device. If you are running a 32-bit i686 Linux
desktop, you should be able to use the standard&nbsp;g++ compiler. (On x64
Linux, the native desktop toolchain will generate x64 code, which will not work
in the emulator.)</p>
<p><b>Note:</b> These instructions have been updated for Ubuntu 14.04.5 LTS (Trusty Tahr)</p>
<h3>Update the Package Repository Information</h3>
<pre>sudo apt-get update</pre>
<h3>Install Java&trade;</h3>
<p class="bodytext">Download and install the OpenJRE Java Runtime Environment
(JRE). The SDK is incompatible with the default Ubuntu GNU Compiler for Java
(GCJ), and the Java JRE is no longer available. Example:</p>
<pre>sudo apt-get install openjdk-8-jr</pre>
<p class="bodytext">To set Oracle JDK8 as default, install the "oracle-java8-set-default" package.
<pre>sudo apt install oracle-java8-set-default</pre>
On Ubuntu systems, oracle-java8-set-default is most probably installed
automatically with this package.
</p>
<h3>Install VirtualBox</h3>
<p class="bodytext">The webOS emulator is built on VirtualBox&trade;, virtual
machine software that you can download free from Oracle. VirtualBox is required
before installing the HP webOS SDK. <b>Note:</b> The webOS emulator
now works with Virtualbox 4.0.36 r71416 and 4.1.0 r73009.</p>
<h5>Installing or Upgrading VirtualBox</h5>
<ol>
<li>
<p>If you are upgrading from a previous version of VirtualBox, follow the
instructions to "Uninstall the webOS Emulator and Virtual Machine" on
<a href=
"https://web.archive.org/web/20130130211140/https://developer.palm.com/content/resources/develop/uninstalling_the_sdk_and_pdk.html">
this page</a>.</p>
</li>
<li>
<p><b>Note:</b> While VirtualBox 4.1 won't run on newer distros, you'll need it to create emulator images.
Install 4.1 and create the images, then uninstall. Install a newer VirtualBox to actually run the emulator
from the VirtualBox UI.
</li>
</ol>
<p class="bodytext">Download and install VirtualBox 4 manually
here:&nbsp;<span style="color: blue; text-decoration: underline;"><a href=
"https://www.virtualbox.org/wiki/Download_Old_Builds_4_1"
target="_blank">https://www.virtualbox.org/wiki/Download_Old_Builds_4_1</a></span>.</p>
<p class="bodytext">Download recent VirtualBox versions <a href=
"http://www.virtualbox.org/wiki/Linux_Downloads" target="_blank">here</a> to go
directly to the VirtualBox Linux page.</p>
<h3>Install ia32-libs (on 64-bit systems only)</h3>
<div class="padding">
<p class="nomargin">If you are installing on a 64-bit system, perform the
following additional step before installation:</p>
<pre>sudo apt-get install ia32-libs</pre>
<p class="nomargin"><b>Note:</b> On newer Linux distros, <a href="https://stackoverflow.com/questions/23182765/how-to-install-ia32-libs-in-ubuntu-14-04-lts-trusty-tahr">this thread</a> may help</a></p>
<p class="nomargin">If you happen to have installed palm-novacom before
installing ia32-libs, then you must restart palm-novacomd:</p>
<pre>sudo stop palm-novacomd<br>sudo start palm-novacomd</pre>
</div>
<h3>Install the SDK for Linux</h3>
<p class="def-button"><a href=
"https://1drv.ms/u/s!Av5IQUxnr8DUjN4Gcj3d5y4dLHwKRQ" target="_blank">Download
Novacom - 32-bit</a></p>
<p class="def-button"><a href=
"https://1drv.ms/u/s!Av5IQUxnr8DUjN4FYpKlaCyGz5wYvA" target="_blank">Download
Novacom - 64-bit</a></p>
<p class="bodytext"><b>and</b></p>
<p class="def-button"><a href=
"https://1drv.ms/u/s!Av5IQUxnr8DUjN4MY-1s_XNL3ninqQ" target=
"_blank">Download SDK</a></p>
<div class="padding">
If you are installing on a 32-bit system, perform the following steps to
install the SDK:
<pre>sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br>sudo dpkg -i palm-novacom_1.0.80_i386.deb</pre>
<p class="nomargin">If you are installing on a 64-bit system, perform the
following steps to install the SDK:</p>
<pre>sudo dpkg -i --force-architecture palm-sdk_3.0.5-svn528736-pho676_i386.deb<br>sudo dpkg -i --force-architecture palm-novacom_1.0.80_amd64.deb</pre>
<b>Note:</b> If you experience installation issues, try a clean install. To
uninstall, follow the uninstall instructions.<br/>
&nbsp;<br/>
</div>
<div class="hr"></div>
<div style="height:20px;">
<!-- -->
</div><a id="c39926" name="c39926"></a>
<h2>Other Emulator Images</h2>
<div class="csc-textpic-text">
<p class="bodytext">It is sometimes necessary to test your software on other
versions of webOS. Use the links below to download VMDKs for these versions.
(Be sure to right-click and use "Save As..." to save these as binaries.)</p>
<ul class="def-list">
<li><a href="https://1drv.ms/u/s!Av5IQUxnr8DUjN4HKKXvhe6vFg15rQ" target=
"_blank">1.3.5</a></li>
<li><a href="https://1drv.ms/u/s!Av5IQUxnr8DUjN4KBCzdCrwztZR1Sw" target=
"_blank">1.4.0</a></li>
<li><a href="https://1drv.ms/u/s!Av5IQUxnr8DUjN4J8VBdsWqrlm8nmQ" target=
"_blank">1.4.1</a></li>
<li><a href="https://1drv.ms/u/s!Av5IQUxnr8DUjN1_mS4My43gmlpVaA" target=
"_blank">1.4.5</a></li>
<li><a href="https://1drv.ms/u/s!Av5IQUxnr8DUjN4IkNP1rxZrMujPFw" target=
"_blank">2.1.0</a></li>
<li><a href="https://1drv.ms/u/s!Av5IQUxnr8DUjN4L5f9TVEbmmU2dxQ" target=
"_blank">2.2.0</a>&nbsp;(Pre<sup>3</sup>&nbsp;format only)</li>
<li><a href="https://1drv.ms/u/s!Av5IQUxnr8DUjN4ALoKmE2Os_p8tqg" target=
"_blank">2.2.4</a> (Pre2 and Pre<sup>3</sup> format)</li>
</ul>
<p class="bodytext">Once you have downloaded the zip file, you will need to
"install" the image using the palm-emulator command from the command line. For
example:</p>
<pre>palm-emulator --install "~/Downloads/SDK 2.1.0.519.vmdk.zip"</pre>
<div class="hr"></div>
</div>
<div style="height:20px;">
<!-- -->
</div><a id="cScreenSize" name="cScreenSize"></a>
<h2>Screen-size Notes</h2>
<p class="bodytext">
<ul>
<li><b>Pre3: </b>To avoid the letterbox bar that will show on
the Pre<sup>3</sup>&nbsp;if your app retains it's Pre/Pre2-based aspect ratio,
add the following to your index.html:
<pre>&lt;meta name='viewport' content='height=device-height'&gt;</pre>
</li>
<li><b>TouchPad: </b>To avoid the phone simulator frame that will show on
the TouchPad if your app retains it's Pre/Pre2-based aspect ratio, add the following to your appinfo.json:
<pre>"uiRevision": "2",</pre>
</li>
</ul>
</p>
</div>
</div>
</div>
<!-- Actual Content Ends Here -->
<!-- Content Nav Starts Here -->
<div class="col-aside">
<div class="sidebox">
<h3>Contents</h3>
<ol class="article-nav">
<li class="current last">
<a href=
"https://web.archive.org/web/20130130211140/https://developer.palm.com/content/resources/develop/sdk_pdk_download.html"
target="_top">SDK-PDK Download</a>
<ol class="level-1">
<li><a href="#c23272" target="_top">Installing the SDK and PDK on a Windows PC</a></li>
<li><a href="#c23352" target="_top">Installing the SDK and PDK on a Mac</a></li>
<li><a href="#c28522" target="_top">Installing the SDK on Ubuntu Linux</a></li>
<li><a href="#c28522" target="_top">Other Emulator Images</a></li>
<li class="last"><a href="#cScreenSize" target="_top">Screen-size Notes</a></li>
</ol>
</li>
</ol>
</div>
</div>
<!-- Content Nav Ends Here -->
</div>
You can’t perform that action at this time.