V0.1 BlackBerry HTML5/WebWorks Applications for the BlackBerry ® PlayBook Tablet BlackBerry...

v0.1

BlackBerry HTML5/WebWorks Applications for the BlackBerry® PlayBook™ Tablet BlackBerry Academic Program

Module 2- Tools Installation

© 2012 Research In Motion Limited

Overview


Objectives This module will cover the following topics:

•Which tools are required for BlackBerry HTML5/WebWorks development for the BlackBerry PlayBook tablet

•How to install the following tools:

• Adobe® Air® SDK

• BlackBerry® WebWorks™ SDK for Tablet OS

• Ripple™ Emulator

• VMware® Player

• BlackBerry PlayBook Simulator

3Overview of BlackBerry WebWorks


Prerequisites For this module, the recommended prerequisite skills and areas of knowledge are:

• Basic computing knowledge

• Application development terminology (Ex. GUI, IDE and USB)

• Navigation (Ex. installing software, working with archives, locating and deleting files and folders)

•Internet use (Ex. browsing web sites, using a web browser on a computer)

4Course Code


Prerequisites Continued For this module, the recommended prerequisite skills and areas of knowledge are:

• File types (Ex. JPG, PNG, DOC, PDF and ZIP)

• Basic text editing knowledge (Ex. entering text, copying and pasting)

• End-user experience/familiarity with a smartphone

5Course Code


Technical Requirements For this module, the following hardware is recommended for technical setup:

• Intel® Pentium® 4 or AMD Athlon™ desktop processor 2 GHz or faster

• 1 GB or more available hard disk space

• 2 GB RAM or more

• Computer monitor with resolution of 1024 x 768 or higher

• Windows® XP SP3, Windows Vista® Ultimate or Enterprise, or Windows®7

• Java® Runtime Environment JRE 1.6

6Course Code


Technical Requirements For this module, the following tools will need to be downloaded and installed on a student’s computer before development can begin:

• Adobe AIR SDK v2.7 or above

• BlackBerry WebWorks SDK for Tablet OS

• Ripple Emulator

• BlackBerry PlayBook Simulator

• VMware (required to run the BlackBerry PlayBook Simulator)

7Course Code


Note about OS Options for Tools If students would like to download tools to develop on the Mac OS, they will require the following tools:

•Adobe AIR SDK

•BlackBerry WebWorks SDK for Tablet OS for Mac

•VMware Fusion®

Tools can be downloaded from BlackBerry Developer Zone

8Course Code


Installing the Adobe AIR SDK



10Course Code

Figure 1: Selecting appropriate OS for SDK download

Go to http://www.adobe.com/special/products/air/sdk/ to download Adobe Air SDK v 2.7 or above.



11Course Code

Figure 2: Saving content to program files


Extracting the Adobe AIR SDK Files

12Course Code

Figure 3: Extracting the SDK Files


Extracting the Adobe AIR SDK Files

13Course Code

Figure 4: Extracting the SDK Files


Installing the BlackBerry WebWorks SDK


Installing the BlackBerry WebWorks SDK for Tablet OS

15Course Code

Go to the HTML5/WebWorks microsite to the “Downloads” page http://wbt20ykf/html5/download/sdk

Figure 5: WebWorks SDK versions for smartphone or tablet



16Course Code

Figure 6: WebWorks SDK download options



17Course Code

Figure 7: Start of the Installation Wizard



18Course Code

Figure 8: The Installation Wizard



19Course Code

Figure 9: Accepting the terms and conditions



20Course Code

Figure 10: Selecting a folder to install the SDK



21Course Code

Figure 11: Pre-Installation summary for the BlackBerry WebWorks SDK



22Course Code

Figure 12: Installation of the BlackBerry HTML5 WebWorks SDK


The Ripple Emulator


What is the Ripple Emulator? • A multi-platform mobile environment emulator

• Custom-tailored to mobile HTML5 application development and testing

• Can be used to perform JavaScript debugging, HTML DOM inspection, automated testing in real time

•Can be used to emulate multiple device and screen resolutions in real-time without redeploying the application or restarting the emulator

•Reduces the challenges faced by mobile developers caused by platform fragmentation in the marketplace

24Course Code


What is Included in the Ripple Emulator? The panels and settings in the Ripple emulator allow you to perform many actions, including the following:

•Change device types and platform versions.

•Simulate accelerometer actions.

•Modify location information, including latitude, longitude, and altitude coordinates.

•Determine how an application responds to events by choosing specific events to trigger.

•Validate the elements and attributes in the configuration file for your application.

•Trigger phone call events.

•Access to the Web Inspector tool

25Course Code


Downloading the Ripple Emulator Download from the BlackBerry Jam “HTML5/WebWorks” site

26Course Code

Figure 13: Downloading the Ripple Emulator


Installing the Ripple Emulator

27Course Code

Figure 14: Installation Wizard for the Ripple Emulator



28Course Code

Figure 15: Software License Agreement for Ripple Emulator installation



29Course Code

Figure 16: Selecting an installation folder



30Course Code

Figure 17: Installation Summary



31Course Code

Figure 18: Ripple Emulator installation has completed


Configuring the Ripple Emulator•When the installation is complete, open the Ripple Emulator and:

•On the “Devices” options menu, select “BlackBerry PlayBook”

•Ensure that under the “Platform” menu, select the “WebWorks-Tablet OS” option

•To open Ripple, navigate to the C:\Program Files\Research In Motion\Ripple folder

•To develop WebWorks applications for BlackBerry smartphones such as the BlackBerry Bold 9900 or the BlackBerry Torch 9800, select the “WebWorks” option on the “Platform” menu

32Course Code


Configuring the Ripple Emulator

33Course Code

Figure 19: Ripple Emulator for Tablet OS


Installing VMware Player

34Course Code


Installing VMware Player • The VMware Player is required to run the BlackBerry PlayBook simulator

•Visit VMware Player website to download the VMware tool

•A VMware account is required to download the tool

•If you do not have a VMware account, register for a free account

•It is recommended that you have a minimum 1GHz processor and 1GB RAM to effectively host the operating system

35Course Code



36Course Code

Figure 20: Downloading the VMware Player



37Course Code

Figure 21: Beginning installation of the VMware Player



38Course Code

Figure 22: Launching the installation of VMware Player



39Course Code

Figure 23: VMware Player installation



40Course Code

Figure 24: Successful installation of the VMware Player



41Course Code

Figure 25: Installation of the VMware Player



42Course Code

Figure 26: Restarting your computer to finalize installation


BlackBerry PlayBook Simulator Set-up



44Course Code

Figure 27: Navigating to the PlayBook Simulator

© 2012 Research In Motion Limited 45Course Code


Figure 28: Navigating to the PlayBook Simulator



Figure 29: Launching the BlackBerry PlayBook Simulator using VMware Player



Figure 30: BlackBerry PlayBook Tablet virtual machine



Figure 31: BlackBerry PlayBook Tablet OS start-up



Figure 32: BlackBerry PlayBook Tablet Simulator home screen


Summary and Next Steps


Summary and Next Steps In this module, the following topics were covered:

•Which tools are required for BlackBerry HTML5/WebWorks development for the tablet

•How to install the following tools:

• Adobe Air SDK

• BlackBerry WebWorks SDK for Tablet OS

• VMware Player

• BlackBerry PlayBook simulator

•Next steps including writing, packaging and loading an application onto the BlackBerry PlayBook Simulator

51Course Code


Additional Resources •HTML5 WebWorks Boot Camp Explanation – Mobile World Congress 2011

•Building your first BlackBerry Application using HTML5 WebWorks

•PhoneGap and Ripple Demo

52Course Code


Legal Disclaimer© 2012 Research In Motion Limited. All rights reserved. BlackBerry®, RIM®, Research In Motion® and related trademarks, names and logos are the property of Research In Motion Limited and are registered and/or used in the U.S. and countries around the world. Adobe and AIR are trademarks of Adobe Systems Incorporated.; Ripple is a trademark of tinyHippos, Inc.; VMware is a trademark of VMware, Inc. ; Intel and Pentium are trademarks of Intel Corporation; AMD Athlon is a trademark of Advanced Micro Devices, Inc; Windows is a trademark of Microsoft Corporation.; Java is a trademark of Oracle America, Inc.; Ripple is a trademark of tinyHippos, Inc.; Mac OS is a trademark of Apple Inc.; Web Inspector is a trademark of Wintriss Engineering Corporation.; PhoneGap is a trademark of Adobe Systems Incorporated .All other trademarks are the property of their respective owners. This documentation is provided "AS IS" and without condition, endorsement, guarantee, representation or warranty, or liability of any kind by Research In Motion Limited and its affiliated companies, all of which are expressly disclaimed to the maximum extent permitted by applicable law in your jurisdiction.

53Course Code

53

Date post:	26-Mar-2015
Category:	Documents
Upload:	matthew-gardner
View:	216 times
Download:	0 times

V0.1 BlackBerry HTML5/WebWorks Applications for the BlackBerry ® PlayBook Tablet BlackBerry...

Documents