Sunday, January 15, 2012

HP webOS 3.0.5 SDK is here. Instructions for Downloading and Installing SDK and PDK. Release Notes.

WorldWide Tech & Science. Francisco De Jesús.


After the OTA HP webOS 3.0.5 update for your TouchPad here,  the 3.0.5 SDK is available for download here and details below.


The release notes below and here


       Release Notes - webOS SDK 3.0.5 (Build 676)

Welcome to the SDK for webOS 3.0.5. The following items have changed since the 3.0.4 release:

webOS Platform

  • A new Sensor API is available for PDK applications; see the documentation for details.
  • Fixed performance issue with SDL hybrid applications.
  • Fixed issue causing PDL_isAppLicensedForDevice to fail when app is started with no network connection.
  • In hybrid apps, the plugin defaults to using only one processor core. Add the line "processors":2 to appinfo.json to allow it to use both cores.
  • Fixed issue that could cause WebSQL calls to hang.
  • Full-screen HTML 5 video playback now works in all screen orientations.
  • Addressed audio playback issues observed when connecting to/disconnecting from the TouchPad's audio jack multiple times, or after waking from sleep.
  • In Media Indexer, fixed Ogg Vorbis tag parsing to correctly handle tags that aren't all uppercase.
  • Updated Text Assist UI to allow users to choose whether a double-space will be automatically replaced by a period.
  • Download Manager now alerts users when disk space is almost full and refuses to download more files.
  • Incorporated homebrew patch to support binary data in Bluetooth SPP service.

Enyo Framework

  • WebView controls now have a scroll indicator provided by the system.
  • Fixed issues causing PeoplePicker widget to not work in third-party apps.
  • Cross-launching the Camera app from Enyo.CrossAppUI now works.
  • The enyo.Video kind now takes a "poster" param to show a default image when video is not streaming.
  • Fixed issue causing spinning text in QuickOffice. Developers are advised to avoid placing their own content inside Spinner controls.

Known Issues and Limitations

SDK Tools

Apps generated using palm-generate may not run in Safari on Windows. In order to run in Google Chrome, Chrome must be launched with the --allow-file-access-from-files flag. On Windows, this may be specified in a desktop shortcut. On Mac, you can launch Chrome by typing the following in Terminal:
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --allow-file-access-from-files

You can also specify the file to open--e.g. after generating "enyotest", you can open it by typing
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --allow-file-access-from-files enyotest/index.html

Documentation

When viewing the documentation in the Chrome browser, links may not work correctly unless you have launched Chrome using the --allow-file-access-from-files command-line switch.     



From the HP webOS developer Blog:


We have just released webOS 3.0.5 as an over-the-air update for TouchPads, and the 3.0.5 SDK is now out of Early Access. Get the latest and greatest here.


Highlights include a new Sensor API, the ability to have plug-ins use both processor cores, and improvements to audio and video playback, plus various updates to Enyo we think you’ll like. We’ve also incorporated a homebrew patch to the Bluetooth SPP service to support binary data, so we expect to see some hardware hacks soon. (Hmm—new App Hack theme?)
Enjoy!



Downloading and Installing the 3.0.5 SDK and PDK

The HP webOS 3.0.5 SDK (release notes here) 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.

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.)

Note: PDK development is now supported for Linux. See the Linux download section below for more information.

The SDK tools are also command-line based, but if you prefer to use an integrated development environment (IDE), HP provides a webOS plug-in for the Eclipse IDE.

Ready to get to work? Click below on your platform of choice to download:

Installing the SDK and PDK on a Windows PC

Uninstall any existing SDK or PDK installations


Warning:

SAVE YOUR DATA! —Uninstalling the SDK and PDK will delete the directories in which they are installed. If you have project source code in those directories it will be deleted!
Your project source should not be stored in the SDK or PDK installation directories.

  1. Uninstall the previous SDK (if present) using the Windows Add/Remove Program control panel.
  2. Uninstall the previous PDK (if present) by running c:\Program Files\Palm\PDK\uninstallpdk.exe.
    • When prompted, make sure you also un-install the Novacom driver.

Install Java

Download and install the latest version of Java™.
To verify that Java is installed, go to the Command Prompt and type:

java -version

If Java is installed, Java version information appears.

Note:

If you are using a 64-bit version of Windows, you will need to download Java from http://www.java.com/en/download/manual.jsp. You MUST do this in Internet Explorer. Other browsers do not show the 64-bit Jave Runtime Environment installer. From here, follow the instructions for "Windows 7, XP Offline (64-bit)". You can also download it directly from http://javadl.sun.com/webapps/download/AutoDL?BundleId=47155.

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: The webOS emulator now runs on Virtualbox 4.0 and 4.1.

Install the HP webOS SDK for Windows

  1. Download the appropriate Windows SDK installer (Windows Vista and Windows 7 only): Download  SDK/PDK for 32-bit machines.
    Download  SDK/PDK for 64-bit machines.
  2. Ensure VirtualBox is not running before starting the webOS SDK Installer.
  3. Double-click the webOS SDK Installer file.
  4. Proceed through the licensing agreements.
  5. Click "Finish" to complete the installation.

Download the CodeSourcery Toolchain (PDK only)

Perform this step only if you intend to do plug-in or other C/C++ development.
If not already installed, download the CodeSourcery Toolchain—Sourcery G++ Lite for ARM GNU/Linux. You can download this from the CodeSourcery website.
To download the CodeSourcery Toolchain, go to:
Click on the "Sourcery G++ Lite 2009q1-203" link, and download the Windows Installer.
If you have problems with this version, you can also try version 2007q3-51. This is an older version for developers who run into the following problems:
  • C++ exception handling — Unresolved links to versioned symbols.
  • _libc_csu_init/fini calls — Unresolved links to versioned symbols.
  • __isoc99_sscanf — Symbol added in GLIBC 2.7 that gets used for calls to sscanf unless you use _USE_GNU 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 __isoc99 calls.

Verify the SDK Installation

  1. Start the webOS emulator.
  2. Click OK to dismiss the dialog boxes.
  3. Create or choose a directory to use as your development workspace.
  4. Open a Command Prompt window, and then type:
     palm-generate  
    to verify that the tools are installed:
    • If help information appears, the tools are correctly installed.
    • If palm-generate is not recognized as a command, the tools are not correctly installed.
    • If java is not recognized as a command, Java is not correctly installed
  5. Exit both the Command Prompt window and the emulator.

Installing the SDK and PDK on a Mac



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: The emulator now supports VirtualBox 4.0 and 4.1.


Download the SDK/PDK disk image file


Uninstall any existing SDK/PDK installations


Warning:

SAVE YOUR DATA! —Uninstalling the SDK and PDK will delete the directories in which they are installed. If you have project source code in those directories it will be deleted!
Your project source should not be stored in the SDK or PDK installation directories.

  1. Open the Mac disk image file.
  2. Double click the uninstall-previous-sdk.command script.
  3. Answer “yes” when prompted.
  4. Enter your admin password when prompted.


Install the HP webOS SDK/PDK for Mac

  1. Ensure VirtualBox is not running before starting the webOS SDK Installer.
  2. Open the Mac disk image file if you haven't already.
  3. Double-click the webOS SDK Installer file and follow the instructions.
  4. During installation, you will be given the option to install the PDK as well. Note that this option is selected by default.
Once the SDK is installed:
  • The webOS emulator becomes available in the Applications folder.
  • The webOS command-line tools become available from the Terminal.
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.

Installing the SDK on Ubuntu Linux


A note about PDK development on Linux: 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 g++ compiler. (On x64 Linux, the native desktop toolchain will generate x64 code, which will not work in the emulator.)

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

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.

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: The webOS emulator now supports VirtualBox 4.0 and 4.1.
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 version 4.0 of VirtualBox (optionally, you can install 4.1):
    sudo apt-get install virtualbox-4.0
Note: If virtualbox-ose is installed (or suggested) instead of virtualbox-4.0, 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: 


Click here to go directly to the VirtualBox Linux page.

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-novacomd:

sudo stop palm-novacomd
sudo start palm-novacomd

Install the SDK for Linux

and

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


sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb
sudo dpkg -i palm-novacom_1.0.80_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_3.0.5-svn528736-pho676_i386.deb
sudo dpkg -i --force-architecture palm-novacom_1.0.80_amd64.deb

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

Other Emulator Images


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.)
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:

palm-emulator --install "~/Downloads/SDK 2.1.0.519.vmdk.zip"

Note: To avoid the letterbox bar that will show on the Pre3 if your app retains it's Pre/Pre2-based aspect ratio, add the following to your index.html:

No comments:

Post a Comment