BlackBerry Tablet OS SDK for Adobe AIR

Version: 1.0.2
Release Notes

Published: 2011-06-01 SWD-1361168-0601113545-001

Contents
1 Product information......................................................................................................................................... BlackBerry Tablet Simulator product information............................................................................................ 2 New in this release............................................................................................................................................ 3 Fixed issues....................................................................................................................................................... 4 Known issues.................................................................................................................................................... Simulator known issues.................................................................................................................................... 5 Legal notice....................................................................................................................................................... 2 2 4 5 6 9 12

Release Notes

Product information

Product information
This section lists information about the BlackBerry® Tablet OS SDK for Adobe® AIR® 1.0.2.

1

BlackBerry Tablet OS SDK Plug-in for Flash Builder product information
The BlackBerry Tablet OS SDK plug-in for Adobe® Flash Builder® is compatible with Flash Builder 4.0.1 and 4.5.0. For a complete list of system requirements, see the BlackBerry Tablet OS SDK for Adobe AIR Getting Started Guide.

Distributing your application to BlackBerry App World
To submit an application to the BlackBerry App World™ storefront, you must export a Release build of your application from Flash Builder and choose to sign it. For more information, see the BlackBerry Tablet OS SDK for Adobe AIR Development Guide. In the command line, compile the application without using the debug option, and package the application without specifying debug options. For more information on compiling your application from the command line for distribution through the BlackBerry App World storefront, see the BlackBerry Tablet OS SDK for Adobe AIR Development Guide.

Documentation
For more information about developing applications for the BlackBerry Tablet OS, visit www.blackberry.com/ developers/tabletos to read the following resources: • • • • • • • BlackBerry Tablet OS SDK Feature and Technical Overview API reference for the BlackBerry Tablet OS SDK for Adobe AIR API reference for Adobe ActionScript BlackBerry Tablet OS SDK for Adobe AIR Getting Started Guide for Windows Developers BlackBerry Tablet OS SDK for Adobe AIR Getting Started Guide for Mac Developers BlackBerry Tablet OS SDK for Adobe AIR Getting Started Guide for Linux Developers UI Guidelines for the BlackBerry PlayBook Tablet

BlackBerry Tablet Simulator product information
This section lists product information for the BlackBerry® Tablet Simulator 1.0.2. The BlackBerry Tablet Simulator does not include default applications, except for the browser. This is by design. The simulator's default password is 'playbook' (no quotations). The simulator will automatically start in development mode.

2

Release Notes

BlackBerry Tablet Simulator product information

Flash Builder Plugins are only compatible with Flash Builder 4.0.1 (not 4.0), 4.5 Standard, and 4.5 Premium. To delete your application from the simulator, use the command line tools. You must reboot the simulator after deletion. If you build your application using a debug launch configuration, you must launch the application from Adobe® Flash Builder®. To launch your application without debugging using Flash Builder, create a run launch configuration. For more information, see the BlackBerry Tablet OS SDK for Adobe AIR Getting Started Guide. To close your application in the simulator, use your mouse to swipe up from the bottom of the screen. This minimizes the application. Swipe up again or press the close button (X) to close the application. For more information on supported gestures, see the BlackBerry Tablet OS SDK for Adobe AIR Getting Started Guide.

3

Release Notes

New in this release

New in this release
This section lists new features for the BlackBerry® Tablet OS SDK for Adobe® AIR® 1.0.2. Feature Command line tool improvements Installer improvements Description •

2

The blackberry-airpackager command line tool now has a -debugToken option to populate the author and author id fields of the .bar file manifest for debugging.

Various improvements have been made to the installer. The installer now: • • • • • Supports console install mode Supports Adobe® Flash Builder® 4.5.1. Only asks for the AIR SDK when integrating with Flash Builder 4.0.1. Does not copy the Adobe® Flex® SDK when integrating with Flash Builder 4.5.0 or 4.5.1. Supports integration with Eclipse when integrating with Flash Builder 4.5.0 or 4.5.1.

4

Release Notes

Fixed issues

Fixed issues
This section lists fixed issues for the BlackBerry® Tablet OS SDK for Adobe® AIR® 1.0.2. The BlackBerry Tablet OS SDK did not integrate with Flash Builder 4.0.1 (98650) The default option in the installer for "Integration with Eclipse" shouldn't have been "Yes". (98397) The installer asked for integration with Eclipse when you have not integrated with Flash Builder (98305) When the project had underscores (_) in its name, an invaild ID was generated for the package. (97991) It was possible to use invalid characters in the device name, causing debug token creation to fail. (97978) The device list did not refresh after new test devices were added. (97977) The blackberry-airpackager command line tool did not update the debug host on target. (97920)

3

Debug Token Request deleted the contents of a folder, when the folder name was specified instead of a .bar file name. (96876, 1247706) Changes made to the default debug host IP were not recognized by the targets after you restarted Flash Builder. (96564) The link to developer documentation in the installer was not clickable. (96306) The packaging process used an icon in the app.xml file instead of the icon in the blackberry-tablet.xml file. (96266) Test tablets were not saved until the Preferences dialog box is closed. (96263) The BlackBerry Tablet OS SDK for AIR installer on Linux® asked for Flash Builder integration even though Flash Builder isn't available on Linux. (95848) The blackberry-deploy command-lne tool did not print the correct error message after five failed authentication attempts. (95919)

5

Release Notes

Known issues

Known issues
This section lists known issues for the BlackBerry® Tablet OS SDK for Adobe® AIR® 1.0.2.

4

BlackBerry Tablet OS SDK Plug-in for Adobe Flash Builder
If you are running Adobe® Flash Builder® 4.5 "Burrito" on a computer that is running Windows® 7 or Windows Vista®, after you install the BlackBerry Tablet OS SDK for AIR, the plug-in does not work. (81780) Impact: You cannot use the plug-in. Workaround: To launch the plug-in for the first time, log in to a user account that is in the Administrator group. Right-click the Flash Builder Burrito icon and click Run as administrator. You only need to do this once. An error appears when trying to create a developer certificate in a pre-existing location. (92476) Impact: You cannot create a developer certificate in the same location as an existing developer certificate. Workaround: Delete the existing developer certificate before creating the new developer certificate. You might get a validation error when launching the BlackBerry Tablet OS Example project when using Flash Builder 4.5 Premium and version 2.5 or earlier of AIR. (94743) Impact: You cannot package and launch the example project. Workaround: When integrating with an AIR SDK during installation, choose to integrate with the 4.5 "Hero" SDK that is packaged with Flash Builder 4.5 Premium. In Flash Builder 4.5 "Burrito", it is impossible to export a release build to the bin-release folder. (93136) Impact: You cannot export a release build. Workaround: Do not use the bin-release folder as the export folder. If you are using Flash Builder 4.0.1, when you delete the BlackBerry Tablet OS SDK version 0.9.2 from the Adobe SDK folder, it remains the default SDK. (85033) Impact: You cannot use the SDK. Workaround: In Flash Builder 4.0.1, navigate to Window > Preferences > Flash Builder > Install Flex SDKs. Remove the BlackBerry Tablet OS SDK, and change the default SDK back to Flex 4.1. If you are using Flash Builder 4.5 and you remove the BlackBerry Tablet OS SDK after creating a launch configuration for your application, you cannot use Flash Builder. (82447) Impact: You cannot use Flash Builder after removing the BlackBerry Tablet OS SDK.

6

Release Notes

Known issues

Workaround: For each BlackBerry Tablet OS SDK application, delete the project associated with the launch configuration. If you create an Adobe® Flex® mobile project for your application using Flash Builder 4.5 "Burrito", the BlackBerry Tablet OS SDK libraries are not included in the project. If you manually add the libraries, the Design view in Flash Builder does not work. Impact: You cannot use the Design view with BlackBerry Tablet OS SDK UI components. Workaround: If you want to use the Design view, do not manually import the libraries to the project. If you are using Flash Builder 4.0.0, an internal error occurs when you debug or launch your application: "com.adobe.flexide.launching.air.ApolloLaunchConfiguration.getAIRProfile()Ljava/lang/String;". Impact: You cannot launch your application. Workaround: Upgrade to Flash Builder 4.0.1 or 4.5.

Packaging and signing tools
When using the blackberry-deploy command, an error message appears after the fifth failed login attempt. (95919) Impact: An error message appears. The error message does not provide sufficient information for the user to continue. Workaround: After the fifth failed login attempt, a dialog box appears on the tablet. The user must provide a response in the dialog box before attempting to authenticate using blackberry-deploy. When launching an application that prompts for permissions, an error message might appear if the permissions dialog box is not closed within 30 seconds. (95823) Impact: It will appear as though your application did not launch successfully. Workaround: If you are launching an application that prompts for permissions, dismiss the permissions dialog box within 30 seconds On a computer that is running Windows, the packaging process can fail if you use spaces in directory paths for your projects. (86259) Impact: Packaging an application fails. Workaround: Do not use spaces in the directory paths for your projects. When packaging an application using the command line tool, you can receive the error: Error: unknown protocol: c. (85571) Impact: You cannot generate a bar file.

7

Release Notes

Known issues

Workaround: Do not use spaces in the directory name where your files are. For example use c:/tmp instead. The BlackBerry® PlayBook™ tablet 1.0.1 and the BlackBerry Tablet Simulator 1.0.1 support AIR 2.5 only. (83868) Impact: You cannot deploy applications that use AIR 2.6 or later. Workaround: When compiling your application, you must compile with the -swf-version=10 option. If you are using Adobe® ActionScript® and are not using Flex, you can change your application descriptor file to target AIR 2.5 instead. This can be done for the packaging process only, and can be done by specifying the option forceAirRuntime 2.5 in the packager tool. If your application requires AIR 2.6, your application will not run properly. When you launch an application that is connected to the debugger, if the application does not open within 30 seconds (for example, if you put a breakpoint before the window opens), the application closes. (79976) Impact: Your application might not launch. Workaround: Avoid inserting breakpoints before the window opens. You can only view application tracing on the console when running in debug mode. Workaround: None.

BlackBerry PlayBook tablet
If the package name exceeds 42 characters, the application's functionality is compromised. (96118) Impact: You cannot rotate the application, or delete it from the device. Workaround: Use package names less than 42 characters long. If you need to delete an application with a 42 character or more package name, use the SDK's command line tools. To rotate an application, minimize it first, then rotate the device. When you deploy your application, an error occurs indicating that you cannot connect. Impact: You cannot deploy your application. Workaround: Try performing the following actions: • • • Verify that the IP address is correct. Verify that you have specified a password, and that your password matches the one set on the device. If you are connected to your computer over a VPN connection, try to ping the device using the device's IP address. If you cannot successfully ping the device, this can indicate an issue with your network connection or an invalid IP address.

The expiration date shown under About > Security > Development mode for a debug token is incorrect if your time zone is not GMT. Impact: The expiration date is incorrect.

8

Release Notes

Simulator known issues

Workaround: To see the correct expiration date, change your time zone to GMT. When launching your application remotely, if enter your password incorrectly five times, triggering a prompt on the device to enter your password, and then enter it incorrectly another five times, the device wipes itself. (82627) Impact: You cannot deploy your application. You cannot recover your data from the tablet. Workaround: When the prompt is triggered, do not enter an incorrect password.

APIs
SegmentedControl can be used even when it has been disabled. (95999)

Impact: SegmentedControl is available even if it has been disabled. Workaround: None.
Picker lists continue to scroll even after they have been removed from stage. (90549)

Impact: Picker lists do not stop scrolling. Workaround: None. The following APIs are currently not implemented on the simulator, but work on the device. (80891) • • •
Camera CameraUI Geolocation

You cannot set a default action for the ENTER key for an active dialog box, such as submitting a form. (80302) Impact: When a user presses the ENTER key, nothing happens. Workaround: None.

Simulator known issues
This section lists known issues for the BlackBerry® Tablet Simulator 1.0.2.

Simulator
After you accept permissions for your application, you cannot change them on the simulator. Impact: You cannot add, remove, or change permissions for an application, even after uninstalling it. Workaround: Reinstall the simulator, or revert to its original snapshot, or change the application's package name.

9

Release Notes

Simulator known issues

You cannot upload files to the simulator using Samba share. (96180) Impact: You cannot upload test files to shared folders. Workaround: Upload files to shared folders using SCP or SFTP. The navigator becomes unresponsive when you try to uninstall an application from the simulator. (95925) Impact: You cannot use the simulator after you try to uninstall an application. Workaround: Restart the simulator. Use the command line tool to uninstall the application. The simulator loses mouse coordinates after changing the orientation to portrait. (95795) Impact: Clicking within the application might not produce the expected result. Workaround: Click within the application again to reset mouse coordinates. When launching your application remotely, if enter your password incorrectly five times, triggering a prompt on the simulator to enter your password, and then enter it incorrectly another five times, the simulator stops functioning. (82627) Impact: You cannot deploy your application. Workaround: Reinstall the simulator. Gesture events that are generated by the BlackBerry® Tablet OS SDK for Adobe® AIR® are not dispatched in the simulator. Impact: You cannot programmatically dispatch gestures to the simulator. Workaround: None In Windows® 7, the default user cannot start the simulator. Impact: You cannot start the simulator. Workaround: Run the installer as root, or choose a different folder. In Windows 7, the default user cannot open and run the VMware® image. Impact: You cannot start the simulator. Workaround: Change permissions on the simulator to allow access for the default user, or copy the files to another location as a regular user.

Installer
In Ubuntu 10.4, the default user cannot install the simulator in the default folder location. (95604)

10

Release Notes

Simulator known issues

Impact: You cannot install the simulator or the BlackBerry Tablet OS SDK forAIR . Workaround: Install the simulator as a root folder or a different folder. If you install the simulator as a root folder, after the installation is complete, copy an image of the simulator and paste it into a folder that is accessible by the default user. Any applications that you install after you have uninstalled an application will not launch. (96312, 96209) Impact: You cannot launch an application. Workaround: Restart the simulator or BlackBerry® PlayBook™ tablet.

11

Release Notes

Legal notice

Legal notice

5

©2011 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, Adobe AIR, ActionScript, Flash, Flash Builder, and Flex are trademarks of Adobe Systems Incorporated. Android is a trademark of Google Inc. Linux is a trademark of Linus Torvalds. Mac is a trademark of Apple Inc. PayPal is a trademark of PayPal, Inc. Windows 7 and Windows Vista are trademarks of Microsoft Corporation. All other trademarks are the property of their respective owners. This documentation including all documentation incorporated by reference herein such as documentation provided or made available at www.blackberry.com/go/docs is provided or made accessible "AS IS" and "AS AVAILABLE" and without condition, endorsement, guarantee, representation, or warranty of any kind by Research In Motion Limited and its affiliated companies ("RIM") and RIM assumes no responsibility for any typographical, technical, or other inaccuracies, errors, or omissions in this documentation. In order to protect RIM proprietary and confidential information and/or trade secrets, this documentation may describe some aspects of RIM technology in generalized terms. RIM reserves the right to periodically change information that is contained in this documentation; however, RIM makes no commitment to provide any such changes, updates, enhancements, or other additions to this documentation to you in a timely manner or at all. This documentation might contain references to third-party sources of information, hardware or software, products or services including components and content such as content protected by copyright and/or third-party web sites (collectively the "Third Party Products and Services"). RIM does not control, and is not responsible for, any Third Party Products and Services including, without limitation the content, accuracy, copyright compliance, compatibility, performance, trustworthiness, legality, decency, links, or any other aspect of Third Party Products and Services. The inclusion of a reference to Third Party Products and Services in this documentation does not imply endorsement by RIM of the Third Party Products and Services or the third party in any way. EXCEPT TO THE EXTENT SPECIFICALLY PROHIBITED BY APPLICABLE LAW IN YOUR JURISDICTION, ALL CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS, OR WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS OR WARRANTIES OF DURABILITY, FITNESS FOR A PARTICULAR PURPOSE OR USE, MERCHANTABILITY, MERCHANTABLE QUALITY, NON-INFRINGEMENT, SATISFACTORY QUALITY, OR TITLE, OR ARISING FROM A STATUTE OR CUSTOM OR A COURSE OF DEALING OR USAGE OF TRADE, OR RELATED TO THE DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN, ARE HEREBY EXCLUDED. YOU MAY ALSO HAVE OTHER RIGHTS THAT VARY BY STATE OR PROVINCE. SOME JURISDICTIONS MAY NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES AND CONDITIONS. TO THE EXTENT PERMITTED BY LAW, ANY IMPLIED WARRANTIES OR CONDITIONS RELATING TO THE DOCUMENTATION TO THE EXTENT THEY CANNOT BE EXCLUDED AS SET OUT ABOVE, BUT CAN BE LIMITED, ARE HEREBY LIMITED TO NINETY (90) DAYS FROM THE DATE YOU FIRST ACQUIRED THE DOCUMENTATION OR THE ITEM THAT IS THE SUBJECT OF THE CLAIM.

12

Release Notes

Legal notice

TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, IN NO EVENT SHALL RIM BE LIABLE FOR ANY TYPE OF DAMAGES RELATED TO THIS DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NONPERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN INCLUDING WITHOUT LIMITATION ANY OF THE FOLLOWING DAMAGES: DIRECT, CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, INDIRECT, SPECIAL, PUNITIVE, OR AGGRAVATED DAMAGES, DAMAGES FOR LOSS OF PROFITS OR REVENUES, FAILURE TO REALIZE ANY EXPECTED SAVINGS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, LOSS OF BUSINESS OPPORTUNITY, OR CORRUPTION OR LOSS OF DATA, FAILURES TO TRANSMIT OR RECEIVE ANY DATA, PROBLEMS ASSOCIATED WITH ANY APPLICATIONS USED IN CONJUNCTION WITH RIM PRODUCTS OR SERVICES, DOWNTIME COSTS, LOSS OF THE USE OF RIM PRODUCTS OR SERVICES OR ANY PORTION THEREOF OR OF ANY AIRTIME SERVICES, COST OF SUBSTITUTE GOODS, COSTS OF COVER, FACILITIES OR SERVICES, COST OF CAPITAL, OR OTHER SIMILAR PECUNIARY LOSSES, WHETHER OR NOT SUCH DAMAGES WERE FORESEEN OR UNFORESEEN, AND EVEN IF RIM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, RIM SHALL HAVE NO OTHER OBLIGATION, DUTY, OR LIABILITY WHATSOEVER IN CONTRACT, TORT, OR OTHERWISE TO YOU INCLUDING ANY LIABILITY FOR NEGLIGENCE OR STRICT LIABILITY. THE LIMITATIONS, EXCLUSIONS, AND DISCLAIMERS HEREIN SHALL APPLY: (A) IRRESPECTIVE OF THE NATURE OF THE CAUSE OF ACTION, DEMAND, OR ACTION BY YOU INCLUDING BUT NOT LIMITED TO BREACH OF CONTRACT, NEGLIGENCE, TORT, STRICT LIABILITY OR ANY OTHER LEGAL THEORY AND SHALL SURVIVE A FUNDAMENTAL BREACH OR BREACHES OR THE FAILURE OF THE ESSENTIAL PURPOSE OF THIS AGREEMENT OR OF ANY REMEDY CONTAINED HEREIN; AND (B) TO RIM AND ITS AFFILIATED COMPANIES, THEIR SUCCESSORS, ASSIGNS, AGENTS, SUPPLIERS (INCLUDING AIRTIME SERVICE PROVIDERS), AUTHORIZED RIM DISTRIBUTORS (ALSO INCLUDING AIRTIME SERVICE PROVIDERS) AND THEIR RESPECTIVE DIRECTORS, EMPLOYEES, AND INDEPENDENT CONTRACTORS. IN ADDITION TO THE LIMITATIONS AND EXCLUSIONS SET OUT ABOVE, IN NO EVENT SHALL ANY DIRECTOR, EMPLOYEE, AGENT, DISTRIBUTOR, SUPPLIER, INDEPENDENT CONTRACTOR OF RIM OR ANY AFFILIATES OF RIM HAVE ANY LIABILITY ARISING FROM OR RELATED TO THE DOCUMENTATION. Prior to subscribing for, installing, or using any Third Party Products and Services, it is your responsibility to ensure that your airtime service provider has agreed to support all of their features. Some airtime service providers might not offer Internet browsing functionality with a subscription to the BlackBerry® Internet Service. Check with your service provider for availability, roaming arrangements, service plans and features. Installation or use of Third Party Products and Services with RIM's products and services may require one or more patent, trademark, copyright, or other licenses in order to avoid infringement or violation of third party rights. You are solely responsible for determining whether to use Third Party Products and Services and if any third party licenses are required to do so. If required you are responsible for acquiring them. You should not install or use Third Party Products and Services until all necessary licenses have been acquired. Any Third Party Products and Services that are provided with RIM's products and services are provided as a convenience to you and are provided "AS IS" with no express or implied conditions, endorsements, guarantees, representations, or warranties of any kind by RIM and RIM assumes no liability whatsoever, in relation thereto. Your use of Third Party Products and Services shall be governed by and subject to you agreeing to the terms of separate licenses and other agreements applicable thereto with third parties, except to the extent expressly covered by a license or other agreement with RIM.

13

Release Notes

Legal notice

Certain features outlined in this documentation require a minimum version of BlackBerry® Enterprise Server, BlackBerry® Desktop Software, and/or BlackBerry® Device Software. The terms of use of any RIM product or service are set out in a separate license or other agreement with RIM applicable thereto. NOTHING IN THIS DOCUMENTATION IS INTENDED TO SUPERSEDE ANY EXPRESS WRITTEN AGREEMENTS OR WARRANTIES PROVIDED BY RIM FOR PORTIONS OF ANY RIM PRODUCT OR SERVICE OTHER THAN THIS DOCUMENTATION.

Research In Motion Limited 295 Phillip Street Waterloo, ON N2L 3W8 Canada Research In Motion UK Limited Centrum House 36 Station Road Egham, Surrey TW20 9LF United Kingdom Published in Canada

14