Article History

From: Overview In this tutorial, you use Adobe® Flash Builder® “Burrito” and Adobe® Flex® “Hero” to build a simple, yet fully functional employee directory application for the BlackBerry® PlayBook™ tablet. “Burrito” is the code name for the next version of Flash Builder, and “Hero” is the code name for the next version of the Flex SDK. You don’t need a BlackBerry PlayBook tablet to complete this tutorial: you can use the BlackBerry PlayBook tablet simulator to run and debug the application. The Employee Directory application allows you to: • Search for employees • View employee details • Navigate up and down the org chart • Call, text, and email employees To: Overview In this tutorial, you use Adobe® Flash Builder® 4.5 to build a simple, yet fully functional employee directory application for the BlackBerry® PlayBook™ tablet. You don’t need a BlackBerry PlayBook tablet to complete this tutorial: you can use the BlackBerry PlayBook tablet simulator to run and debug the application. The Employee Directory application allows you to: • Search for employees • View employee details • Navigate up and down the org chart • Call, text, and email employees From: Before you start Before you start, you will have to download and install the following products: • Flash Builder Burrito • The BlackBerry® Tablet OS SDK Beta 2 for Adobe® AIR® • The BlackBerry PlayBook tablet simulator Beta • The “Flex for the BlackBerry PlayBook in 90 Minutes” tutorial files Download and installation instructions are provided below. To: Before you start Before you start, you will have to download and install the following products: • Flash Builder 4.5 • The latest BlackBerry® Tablet OS SDK for Adobe® AIR® • The BlackBerry PlayBook Tablet simulator • The “Flex for the BlackBerry PlayBook in 90 Minutes” tutorial files Download and installation instructions are provided below. From: Additional Resources • Language Reference • Developing Mobile Applications with Flex Hero To: Additional Resources • Language Reference • Developing Mobile Applications with Flex 4.5 From: Installing Flash Builder Burrito 1. Download Flash Builder Burrito here: http://labs.adobe.com/technologies/flashbuilder_burrito 2. Log in as an Administrator or as a user with administrator privileges. If you attempt to install without administrator privileges, the installation will complete, but you will not be able to run Flash Builder. 3. Close all browsers and applications currently running on your system—including other Adobe applications, chat applications and Microsoft® Office applications. It is also recommended to temporarily turn off virus protection during the installation process. 4. Start the installer you downloaded in step 1: double-click flashbuilder_burrito_287807.exe (Windows) or flashbuilder_burrito_287807.dmg (Mac) 5. Accept the user license agreement. When prompted, either enter your existing Flash Builder 4 serial number or install the product as a trial. 6. Select a language if not selected. To: Installing Flash Builder Burrito 1. Download Flash Builder 4.5 here: https://www.adobe.com/cfusion/tdrc/index.cfm?product=flash_builder 2. Log in as an Administrator or as a user with administrator privileges. If you attempt to install without administrator privileges, the installation will complete, but you will not be able to run Flash Builder. 3. Close all browsers and applications currently running on your system—including other Adobe applications, chat applications and Microsoft® Office applications. It is also recommended to temporarily turn off virus protection during the installation process. 4. Start the installer you downloaded in step 1: double-click FlashBuilder_4_5_LS10.exe (Windows) or FlashBuilder_4_5_LS10.dmg (Mac) 5. Accept the user license agreement. When prompted, either enter your existing Flash Builder 4 serial number or install the product as a trial. 6. Select a language if not selected. From: Installing the BlackBerry Tablet OS SDK The BlackBerry Tablet OS SDK can be installed “standalone” or as a plug-in on top of Flash Builder Burrito. In this tutorial, we use the plug-in approach for an integrated development environment. 1. Download the BlackBerry Tablet OS SDK Beta 2 for Adobe AIR for your operating system at http://us.blackberry.com/developers/tablet/ 2. Start the installer: • On Windows®, double-click BlackBerryTabletSDK-Air-Installer-0.9.1-Win.exe • On Mac, unzip BlackBerryTabletSDK-Air-Installer-0.9.1-Mac.zip, and run the installer 3. Accept the terms of the license agreement and click Next. 4. On the Integration with Adobe Flash Builder screen, select Yes and click Next. 5. On the Choose Install Folder screen, do *not* accept the default folder which points to a typical Flash Builder 4 location. Instead, provide the location of Flash Builder Burrito (4.5) and Click Next. The default location of Flash Builder Burrito is: • Windows: C:\Program Files\Adobe\Adobe Flash Builder Burrito • Mac: /Applications/Adobe Flash Builder Burrito 6. On the Choose Adobe AIR SDK Install Folder screen, provide the location of the Adobe AIR 2.5 SDK and click Next. The default location is: • Windows: C:\Program Files\Adobe\Adobe Flash Builder Burrito\sdks\4.5.0 • Mac: /Applications/Adobe Flash Builder Burrito/sdks/4.5.0 7. On the Pre-Installation Summary screen, verify your installation settings and click Install. To: Installing the BlackBerry Tablet OS SDK The BlackBerry Tablet OS SDK can be installed “standalone” or as a plug-in on top of Flash Builder Burrito. In this tutorial, we use the plug-in approach for an integrated development environment. 1. Download the latest BlackBerry Tablet OS SDK for Adobe AIR for your operating system at http://us.blackberry.com/developers/tablet/ 2. Start the installer: • On Windows®, double-click BlackBerryTabletSDK-Air-Installer-x.x.x-Win.exe • On Mac, unzip BlackBerryTabletSDK-Air-Installer-x.x.x-Mac.zip, and run the installer 3. Accept the terms of the license agreement and click Next. 4. On the Integration with Adobe Flash Builder screen, select Yes and click Next. 5. On the Choose Install Folderscreen, select "Yes" in order to integrate with Flash Builder 4.5. Instead, provide the location of Flash Builder Burrito (4.5) and Click Next. The default location of Flash Builder Burrito is: • Windows: C:\Program Files\Adobe\Adobe Flash Builder 4.5 • Mac: /Applications/Adobe Flash Builder 4.5 6. On the Integration with Eclipse screen, please select "No" unless you have integrated Flash® Builder® with Eclipse. 7. On the Insall Folder screen, please select the detault folder for installing the BlackBerry Tablet OS SDK. 8. The BlackBerry PlayBook Tablet simulator will be located in the BlackBerry Tablet OS SDK folder and will be in Development Mode upon launch. The initial password for the PlayBook Simulator is "playbook". 9. On the Pre-Installation Summary screen, verify your installation settings and click Install. From: Install the BlackBerry PlayBook Simulator After installing the BlackBerry Tablet OS SDK, the BlackBerry PlayBook Simulator will be located in the 1. Download the BlackBerry PlayBook Simulator Beta for your operating system athttp://us.blackberry.com/developers/tablet/ 2. Follow the installation instructions on one of the following pages: Windows or Mac (“Configure a virtual machine for the BlackBerry Tablet Simulator” section) To: Install the BlackBerry PlayBook Simulator After installing the BlackBerry Tablet OS SDK, the BlackBerry PlayBook Simulator will be located in the BlackBerryPlayBookSimulator-x.x.x folder in your SDK directory. In order to launch the simulator, you will need to open the file BlackBerryPlayBookSimulator.vmdk from using VMware® Player. The password to access the simulator is "playbook". Please follow the below instruction to manually download and install the BlackBerry PlayBook Simulator. 1. Download the BlackBerry PlayBook Simulator for your operating system athttp://us.blackberry.com/developers/tablet/ 2. Follow the installation instructions on one of the following pages: Windows or Mac (“Configure a virtual machine for the BlackBerry Tablet Simulator” section) From: Part 2: Using a Mobile Item Renderer In this section, you define a mobile item renderer for the list of employees. An item renderer is used to define how each item in a list is visually presented to the user. Mobile item renderers are lightweight classes optimized for mobile devices. Steps 1. Open EmployeeDirectoryHome.mxml and define an inline itemRenderer for the List. The item renderer displays the first name and the last name of the employee on the first line and the tile of the employee on the second line. To: Part 2: Using a Mobile Item Renderer In this section, you define an item renderer for the list of employees. An item renderer is used to define how each item in a list is visually presented to the user. Spark Item renderers are lightweight classes optimized for mobile devices. Steps 1. Open EmployeeDirectoryHome.mxml and define an inline itemRenderer for the List. The item renderer displays the first name and the last name of the employee on the first line and the tile of the employee on the second line. From: Step 2: Opening the Details View Open EmployeeDirectoryHome.mxml and provide the List with a change handler used to open the details view for the selected employee: To: Step 2: Opening the Details View Open EmployeeDirectoryHome.mxml and provide the List with a change handler used to open the details view for the selected employee: From: Step 4: Persisting the Search Results Although a view is destroyed when it becomes inactive, its “data” attribute is persisted and re-assigned when the view is re-instantiated. To persist the search results leveraging the data attribute: 1. Add a result event handler to the HTTPService in which you assign the lastResult of the HTTP service invocation to the data attribute of the view. 1. Bind the List to data attribute of the view. 1. Run and test the application. To: Step 4: Persisting the Search Results Although a view is destroyed when it becomes inactive, its “data” attribute is persisted and re-assigned when the view is re-instantiated. To persist the search results leveraging the data attribute: 1. Add a result event handler to the HTTPService in which you assign the lastResult of the HTTP service invocation to the data attribute of the view. 1. Bind the List to data attribute of the view. From: Step 4: Persisting the Search Results Although a view is destroyed when it becomes inactive, its “data” attribute is persisted and re-assigned when the view is re-instantiated. To persist the search results leveraging the data attribute: 1. Add a result event handler to the HTTPService in which you assign the lastResult of the HTTP service invocation to the data attribute of the view. 1. Bind the List to data attribute of the view. 1. Run and test the application. To: Step 4: Persisting the Search Results Although a view is destroyed when it becomes inactive, its “data” attribute is persisted and re-assigned when the view is re-instantiated. To persist the search results leveraging the data attribute: 1. Add a result event handler to the HTTPService in which you assign the lastResult of the HTTP service invocation to the data attribute of the view. 2. Bind the List to data attribute of the view. 3. Run and test the application. From: 1. Display the list of actions: Below the closing tag, add a List component bound to the actions list. To: 4. Display the list of actions: Below the closing tag, add a List component bound to the actions list. From: 1. Implement DirectReports.mxml as follows: To: 1. Implement DirectReports.mxml as follows:

Fixed broken links.