v0.1
BlackBerry HTML5/WebWorks Applications for the BlackBerry® PlayBook™ Tablet BlackBerry Academic Program
Module 2- Tools Installation
© 2012 Research In Motion Limited
Overview
© 2012 Research In Motion Limited
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
© 2012 Research In Motion Limited
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
© 2012 Research In Motion Limited
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
© 2012 Research In Motion Limited
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
© 2012 Research In Motion Limited
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
© 2012 Research In Motion Limited
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
© 2012 Research In Motion Limited
Installing the Adobe AIR SDK
© 2012 Research In Motion Limited
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.
© 2012 Research In Motion Limited
Installing the Adobe AIR SDK
11Course Code
Figure 2: Saving content to program files
© 2012 Research In Motion Limited
Extracting the Adobe AIR SDK Files
12Course Code
Figure 3: Extracting the SDK Files
© 2012 Research In Motion Limited
Extracting the Adobe AIR SDK Files
13Course Code
Figure 4: Extracting the SDK Files
© 2012 Research In Motion Limited
Installing the BlackBerry WebWorks SDK
© 2012 Research In Motion Limited
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
© 2012 Research In Motion Limited
Installing the BlackBerry WebWorks SDK for Tablet OS
16Course Code
Figure 6: WebWorks SDK download options
© 2012 Research In Motion Limited
Installing the BlackBerry WebWorks SDK for Tablet OS
17Course Code
Figure 7: Start of the Installation Wizard
© 2012 Research In Motion Limited
Installing the BlackBerry WebWorks SDK for Tablet OS
18Course Code
Figure 8: The Installation Wizard
© 2012 Research In Motion Limited
Installing the BlackBerry WebWorks SDK for Tablet OS
19Course Code
Figure 9: Accepting the terms and conditions
© 2012 Research In Motion Limited
Installing the BlackBerry WebWorks SDK for Tablet OS
20Course Code
Figure 10: Selecting a folder to install the SDK
© 2012 Research In Motion Limited
Installing the BlackBerry WebWorks SDK for Tablet OS
21Course Code
Figure 11: Pre-Installation summary for the BlackBerry WebWorks SDK
© 2012 Research In Motion Limited
Installing the BlackBerry WebWorks SDK for Tablet OS
22Course Code
Figure 12: Installation of the BlackBerry HTML5 WebWorks SDK
© 2012 Research In Motion Limited
The Ripple Emulator
© 2012 Research In Motion Limited
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
© 2012 Research In Motion Limited
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
© 2012 Research In Motion Limited
Downloading the Ripple Emulator Download from the BlackBerry Jam “HTML5/WebWorks” site
26Course Code
Figure 13: Downloading the Ripple Emulator
© 2012 Research In Motion Limited
Installing the Ripple Emulator
27Course Code
Figure 14: Installation Wizard for the Ripple Emulator
© 2012 Research In Motion Limited
Installing the Ripple Emulator
28Course Code
Figure 15: Software License Agreement for Ripple Emulator installation
© 2012 Research In Motion Limited
Installing the Ripple Emulator
29Course Code
Figure 16: Selecting an installation folder
© 2012 Research In Motion Limited
Installing the Ripple Emulator
30Course Code
Figure 17: Installation Summary
© 2012 Research In Motion Limited
Installing the Ripple Emulator
31Course Code
Figure 18: Ripple Emulator installation has completed
© 2012 Research In Motion Limited
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
© 2012 Research In Motion Limited
Configuring the Ripple Emulator
33Course Code
Figure 19: Ripple Emulator for Tablet OS
© 2012 Research In Motion Limited
Installing VMware Player
34Course Code
© 2012 Research In Motion Limited
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
© 2012 Research In Motion Limited
Installing VMware Player
36Course Code
Figure 20: Downloading the VMware Player
© 2012 Research In Motion Limited
Installing VMware Player
37Course Code
Figure 21: Beginning installation of the VMware Player
© 2012 Research In Motion Limited
Installing VMware Player
38Course Code
Figure 22: Launching the installation of VMware Player
© 2012 Research In Motion Limited
Installing VMware Player
39Course Code
Figure 23: VMware Player installation
© 2012 Research In Motion Limited
Installing VMware Player
40Course Code
Figure 24: Successful installation of the VMware Player
© 2012 Research In Motion Limited
Installing VMware Player
41Course Code
Figure 25: Installation of the VMware Player
© 2012 Research In Motion Limited
Installing VMware Player
42Course Code
Figure 26: Restarting your computer to finalize installation
© 2012 Research In Motion Limited
BlackBerry PlayBook Simulator Set-up
© 2012 Research In Motion Limited
BlackBerry PlayBook Simulator Set-up
44Course Code
Figure 27: Navigating to the PlayBook Simulator
© 2012 Research In Motion Limited 45Course Code
BlackBerry PlayBook Simulator Set-up
Figure 28: Navigating to the PlayBook Simulator
© 2012 Research In Motion Limited 46Course Code
BlackBerry PlayBook Simulator Set-up
Figure 29: Launching the BlackBerry PlayBook Simulator using VMware Player
© 2012 Research In Motion Limited 47Course Code
BlackBerry PlayBook Simulator Set-up
Figure 30: BlackBerry PlayBook Tablet virtual machine
© 2012 Research In Motion Limited 48Course Code
BlackBerry PlayBook Simulator Set-up
Figure 31: BlackBerry PlayBook Tablet OS start-up
© 2012 Research In Motion Limited 49Course Code
BlackBerry PlayBook Simulator Set-up
Figure 32: BlackBerry PlayBook Tablet Simulator home screen
© 2012 Research In Motion Limited
Summary and Next Steps
© 2012 Research In Motion Limited
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
© 2012 Research In Motion Limited
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
© 2012 Research In Motion Limited
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
Top Related