Developer Resources: Board support packages; Foundry27 projects; Forums

QNX Technical Articles

QNX® SDK for HTML5 1.0: Installation Note

Electronic edition published: Thursday, February 27, 2014

Host OS: You can install this package on one of the following development hosts:

Microsoft Windows 8 Professional 64-bit, Windows 7 Professional 64-bit, or XP Professional SP3
Red Hat Enterprise Linux 6 64-bit or Ubuntu Workstation LTS 12.04 32- and 64-bit

Installing the archive

To install this archive:

Log in to your myQNX account on our website, then go to the Download area.
Download the archive html5sdk-datestamp.zip.
Verify that the checksum of the package matches the one given in the Download area.
Unzip the archive into base_directory, the directory where you installed the QNX SDK for Apps and Media.
- On Linux:
  unzip html5sdk-datestamp.zip -d base_directory
- On Windows, use winzip.

Getting started with the QNX SDK for HTML5

This SDK provides the command-line packaging utilities and core Apache Cordova components required to create HTML5 apps that can be deployed on targets running the QNX SDK for Apps and Media 1.0 and/or QNX CAR Platform for Infotainment 2.1 reference images. The SDK also contains additional Cordova plugins for accessing APIs specific to the QNX CAR platform, so you can extend your applications to integrate with the platform's automotive services.

After you install the SDK, you'll need to do the following:

Install Node.js (current version is v0.10.24) if you don't already have it installed. Follow these OS-specific instructions:

Host OS	Command/instruction
Ubuntu Linux	The default `apt` repository for Ubuntu 12.04 has an old version (0.6.x) of Node.js. To obtain the required version (0.9.9 or higher), you may have to install Node.js manually or use an alternate `apt` repository. For the current instructions, go to http://nodejs.org/download/ and click "Installing from package managers".
Red Hat Enterprise Linux	Note: You must run the following command as the root user—run `su -` before executing the command. `# yum install nodejs`
Windows	Download the Node.js installer from http://nodejs.org/. Run the installer to install Node.js on your Windows host.

Add the packaging tools included with the SDK to your system path:
For Linux:
Run the following in a command-line shell:
```
# cd SDK_extract_location
# cd html5sdk
# export PATH='pwd'/tools/packaging/linux/bin:$PATH
```
Note: In Linux distributions, the above commands will temporarily modify your path until you close the console session. To permanently modify your path, add the following command to your bash profile, located at ~/.profile:

export PATH=SDK_extract_location/tools/packaging/linux/bin:$PATH
For Windows:
```
C:\>cd SDK_extract_location
C:\SDK_extract_location>cd htmlsdk
C:\SDK_extract_location\htmlsd>set PATH=%CD%\tools\packaging\win32\bin;%PATH%
```

Where to go for more information

The following table may help you get started with the documentation for some common tasks.

Note: All documentation references are to titles in your IDE help (Help > Help Contents). The documentation is also available on our website:

http://www.qnx.com/developers/docs/

To find out about:	Go to:
Creating a project	QNX SDK for Apps and Media > HTML5 Developer's Guide > Developing HTML5 Apps > Creating an HTML5 app
Building an app	QNX SDK for Apps and Media > Application and Window Management > Packaging, Installing, and Launching Apps
Deploying an app	QNX SDK for Apps and Media > Application and Window Management > Packaging and Installing Apps > Installing a packaged app on the target
Running an app on the QNX CAR platform	QNX CAR Platform for Infotainment > User's Guide > A Guided Tour of the HMI > Apps Section
Running an app programmatically on the QNX SDK for Apps and Media	QNX SDK for Apps and Media > Application and Window Management > Creating Your Own Application Window Manager > Application management > Starting an application
Running an app from the command line on the QNX SDK for Apps and Media	QNX SDK for Apps and Media > Application and Window Management > Packaging, Installing, and Launching Apps > Launching an app on the target
Debugging an app	QNX SDK for Apps and Media > HTML5 Developer's Guide > Debugging Web Apps
Cordova plugins for the QNX CAR platform	QNX CAR Platform for Infotainment > HMI Development Guides > HTML5 and JavaScript Framework > Cordova JavaScript Plugins
Creating plugins to extend your app's functionality	QNX SDK for Apps and Media > HTML5 Developer's Guide > Creating Your Own Cordova Plugin

Managing plugins with plugman

To manage plugins, you can use the plugman tool (minimum version 0.18.0), which is available via the Node.js package manager (npm):

npm install -g plugman

The following table summarizes the plugman commands you'll likely use most often:

To:	Use this command:
add a plugin	`plugman install --platform blackberry10 --project . --plugin <id\|path\|url> [--variable NAME=name]`
list all installed plugins	`plugman ls`
remove a plugin	`plugman uninstall --platform blackberry10 --project . --plugin <id>`

For more commands, see "Using Plugman to Manage Plugins" on the Apache Cordova site.