Flash Builder 4.0 Release Notes

Welcome to Adobe® Flash® Builder™ 4. This document contains late-breaking product information, updates, and troubleshooting tips not covered in the Flash Builder 4 documentation.

Minimum system requirements

What’s included

Install your software

Uninstall your software

Trial software

Electronic licensing

Registration information

Known issues

Customer care

Other resources

Minimum system requirements

For the latest system requirements, please visit www.adobe.com/go/flashbuilder4_systemreqs

What’s included

DVD:

The Flash Builder 4 DVD includes the following:

Flash Builder 4 Standalone install folder
Flash Builder 4 Eclipse Plug-in install folder
Extras folder that includes: *
LiveCycle Data Services 3.0 installer
Adobe Application Modeling Plug-in for Eclipse 3.4
Adobe Application Modeling Plug-in for Eclipse 3.5
LiveCycle Service Discovery Plug-in for Flash Builder 4.0
Flex 4 Test Automation Plug-in **
Flash Builder 4 Readme
* The contents of the Extras folder is not included in the Electronic Software Distribution (ESD) download.

** Not included in the Electronic Software Distribution (ESD) download, but available as a separate download at www.adobe.com/go/flex_plugin

Install your software

1. Before you install, quit all browsers and close all 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. Uninstall any previously installed versions of Flash Builder 4.

2. You must have administrative privileges or be able to validate as an administrator.

3. Do one of the following:

Install Flash Builder 4 Standalone on Windows:

a. Log in as the Windows Administrator or as a computer administrator (a user account with administrator privileges).

Note: If you attempt to install without administrator privileges, the installation will complete with flagged issues. However, you will have installed an incomplete version of Flash Builder that you will not be able to run.

b. Prior to installing, uninstall any prerelease versions of Flash Builder 4.

c. Insert the DVD in your drive, and follow the on-screen instructions. If the installer does not launch automatically, navigate to the Adobe Flash Builder 4 Standalone folder found at the root level on the DVD and double-click Set-up.exe to start the installation process.

If you downloaded the software from the web, the installer will self-extract after the folder to copy the installer is selected and launch automatically. If the installer does not launch automatically, open the folder, navigate to the Adobe Flash Builder 4 Installer folder, double-click Set-up.exe, and then follow the on-screen instructions.

d. Accept the user license agreement. When prompted, enter your serial number or choose the trial option. Select a language if not selected.

e. If you are installing as an upgrade, the installer will check your system to find the valid upgrade product. If it cannot find it, it will ask you to input the serial number of the product being upgraded. You can also install the software in trial, then input your new and previous serial numbers in the serialization screen shown during launch.

Install Flash Builder 4 Plug-in on Windows:

NOTE: Flash Builder 4 is only supported on Eclipse 3.4 or higher.

CAUTION: Do not install the plug-in version of Flash Builder 4 into a copy of Eclipse that is already hosting Flex Builder 3 plug-in. If you want to continue running Flex Builder 3 plug-in, download a new copy of Eclipse and use that when installing Flash Builder 4 plug-in, or choose bundled Eclipse option in the installer. In addition, be sure to use separate Eclipse workspaces for each installation.

a. Log in as the Windows Administrator or as a computer administrator (a user account with administrator privileges).

Note: If you attempt to install without administrator privileges, the installation will complete with flagged issues. However, you will have installed an incomplete version of Flash Builder that you will not be able to run.

b. Prior to installing, uninstall any prerelease versions of Adobe Flash Builder 4 Eclipse Plug-in.

c. Insert the DVD in your drive, and follow the on-screen instructions. If the installer does not launch automatically, navigate to the Adobe Flash Builder 4 Eclipse Plug-in folder found at the root level on the DVD and double-click InstallFlashBuilder4Plugin.bat to start the installation process.

If you downloaded the software from the web, the installer will self-extract after the folder to copy the installer is selected and launch automatically. If the installer does not launch automatically, open the folder, navigate to the Adobe Flash Builder 4 Plugin Installer folder, double-click InstallFlashBuilder4Plugin.bat, and then follow the on-screen instructions.

d. Accept the license agreement and follow the prompts.

e. If you are installing as an upgrade, the installer will check your system to find the valid upgrade product. If it cannot find it, it will ask you to input the serial number of the product being upgraded. You can also install the software in trial, then input your new and previous serial numbers in the serialization screen shown during launch.

Install Flash Builder 4 Standalone on Mac:

a. Log in as the Administrator or as a computer administrator (a user account with administrator privileges).

b. Prior to installing, uninstall any prerelease versions of Flash Builder 4.

c. Insert the DVD in your drive, and follow the on-screen instructions. If the installer does not launch automatically, navigate to the Adobe Flash Builder 4 Standalone folder found at the root level on the DVD and double-click Install.app to start the installation process.
If you downloaded the software from the web, open the folder, navigate to the application folder, double-click Install.app, and then follow the on-screen instructions.

d. Accept the license agreement and follow the prompts.

e. If you are installing as an upgrade, the installer will check your system to find the valid upgrade product. If it cannot find it, it will ask you to input the serial number of the product being upgraded. You can also install the software in trial, then input your new and previous serial numbers in the serialization screen shown during launch.

Install Flash Builder 4 Plug-in on Mac:

NOTE: Flash Builder 4 is only supported on Eclipse 3.4 or higher.

CAUTION: Do not install the plug-in version of Flash Builder 4 into a copy of Eclipse that is already hosting Flex Builder 3 plug-in. If you want to continue running Flex Builder 3 plug-in, download a new copy of Eclipse and use that when installing Flash Builder 4 plug-in, or choose bundled Eclipse option in the installer. In addition, be sure to use separate Eclipse workspaces for each installation.

a. Log in as the Administrator or as a computer administrator (a user account with administrator privileges).

Note: If you attempt to install without administrator privileges, the installation will complete with flagged issues. However, you will have installed an incomplete version of Flash Builder that you will not be able to run.

b. Prior to installing, uninstall any prerelease versions of Adobe Flash Builder 4 Eclipse Plug-in.

c. Insert the DVD in your drive, and follow the on-screen instructions. If the installer does not launch automatically, navigate to the Adobe Flash Builder 4 Eclipse Plug-in folder found at the root level on the DVD and double-click FB4_Plugin_Mac_Installer app to start the installation process.

If you downloaded the software from the web, open the folder, navigate to the Adobe Flash Builder 4 Plugin Installer folder, double-click FB4_Plugin_Mac_Installer app, and then follow the on-screen instructions.

d. Accept the license agreement and follow the prompts.

e. If you are installing as an upgrade, the installer will check your system to find the valid upgrade product. If it cannot find it, it will ask you to input the serial number of the product being upgraded. You can also install the software in trial, then input your new and previous serial numbers in the serialization screen shown during launch.

NOTE: You must create a new workspace before beginning. Select File > Switch Workspace from the menu bar and enter a new folder name. If the folder doesn’t exist, Eclipse creates it.

4. For detailed installation instructions for Flex 4 Automation Plug-in, go to www.adobe.com/go/flex_plugin

Note: In order to install additional components or reinstall your software after your original installation, you will need access to the original installer (CD, DVD or the download from the web). Repair is not an available option.

Uninstall your software

Before you uninstall, quit all browsers and close all applications currently running on your system–including other Adobe applications, chat applications and Microsoft Office applications.

In Windows XP, open the Windows Control Panel and double-click Add or Remove Programs. Select the product that you want to uninstall, click Change/Remove, and then follow the on-screen instructions.
In Windows Vista and Windows 7, open the Windows Control Panel and double-click Programs and Features. Select the product that you want to uninstall, click Uninstall, and then follow the on-screen instructions.
IMPORTANT: Mac OS has new uninstall functionality. DO NOT drag applications to the trash to uninstall them. To safely uninstall on Mac OS X, double-click on the Uninstall alias located in the Application folder. Select Remove Preferences, then Authenticate as an administrator and follow the on-screen instructions.
Note: If you want to install the product on a different computer, you must first deactivate the software on your computer. To deactivate, choose Help > Deactivate Flash Builder.

Trial software
Entering a serial number

Enter the serial number for the software you purchased in the serialization screen. The serialization screen will load the first time you launch the application (if using the Adobe Flash Builder 4 Eclipse Plugin, it may take more than one launch for the serialization screen to appear).

Only applications running as a trial will recognize the new serial number. If any of the applications have already been serialized with a different serial number, it will continue to use that serial number until you remove the older serial number using the Help > Deactivate Flash Builder. Then on the next launch of the application, it will recognize the new serial number.

Volume licensing

Volume licensing customers cannot purchase from a trial directly. Please contact your reseller or authorized Adobe licensing center to place an order for a volume license. To find a reseller in your area, go to http://partners.adobe.com/resellerfinder/na/reseller.jsp.

Electronic licensing
You must accept the license agreement and warranty terms to use this product. See www.adobe.com/go/eulas for details. This product may automatically attempt to activate over the Internet. See www.adobe.com/go/activation for details.

Registration information

Creating an Adobe ID registers your software. Please register to get up-to-date product information, training, newsletters, and invitations to Adobe events and seminars.

Known issues

Please refer to http://www.adobe.com/go/flex4_sdk_releasenotes for Flex 4 SDK known issues

AIR: Project
FB-25251 Can’t install AIR file exported from Builder – “Air file is damaged” error when previous version of AIR application is installed

Workaround: Uninstall previous version of the AIR application

ASDebugger

FB-25724 Installed Adobe Flash Player Is Not a Debugger when Flash Pro CS5 is installed and using the standalone player (no HTML wrapper)

Workaround:Uninstall your current Flash Player and run the debugger player installer found atINSTALL_DIRECTORY/players/. For the standalone Flash Player, launch the Stand Alone Flash Player found in INSTALL_DIRECTORY/players/ and open a swf to re-associate that version of the standalone Player

FB-24607 When debugging in Internet Explorer 8 on Windows 7, Internet Explorer may display a dialog when your Flash application has halted at a breakpoint. This is caused by the fact that Internet Explorer thinks the Flash Player is hung, when in fact the Flash Player is simply waiting for a message from the Flash Builder debugger.

Workaround: You can disable this Internet Explorer warning by making a change to the Windows registry. (Note, this change will affect all Internet Explorer windows, not just ones being used to debug Flash Builder applications.)

– Run regedit.exe

– Navigate to the following registry key: HKEY_CURRENT_USER\Software\Microsoft\Internet Explorer\Main

– Edit > New > DWORD (32-bit) Value

– For the name of the new value, type “HangResistance”

– The value in the right-hand column will show up as zero; leave it with that value.

FB‐16779 Flash Player error may occur when debugging in Google Chrome. If you want to debug your Flash applications in the Chrome browser, Chrome may see the following message when you are halted at a breakpoint in the Flash Builder debugger:
The following plug-in is unresponsive: Shockwave Flash
Would you like to stop it?
It is normal for the Flash Player plug-in to be unresponsive when you are at a breakpoint. To prevent Chrome from displaying this message, modify the shortcut that you use to Chrome. In Windows, right-click on the shortcut and choose Properties. Go to the Shortcut tab, and append “–disable-hang-monitor” to the “Target:” field.

ASDoc – Display

FB-25623 No ASDoc for unsupported locales in plug in build using non bundled eclipse distros

Adobe Community Help

FB-26153 Context-sensitive help for ActionScript Language Reference is not displayed on first invocation. Workaround: Windows: Select Adobe Community Help > Edit > Preferences. Then select Local Content > ActionScript 3.0 Reference and click the update button. OS X: Launch Adobe Help > Preferences. Then select Local Content > ActionScript 3.0 Reference and click the update button.

Compiler

FB-26001 /SDK-25513 Incremental compiler fails to pick up metadata changes. Fix is scheduled for SDK 4.1. Workaround: Perform a full compile.

SDK-25619 Embedding font in a library throws compile time error. Fix is scheduled for SDK 4.1.

FB-25787 Cannot use the -static-rsls option in “Additional compiler arguments” input

Workaround:In the project’s properties dialog, go to “Flex Build Path” and choose “Merged into code”.

FB-24955 Compile error when a package named ‘style’ contains a CSS file that’s referenced by an MXML file in the same package as CSS

Workaround:Rename the the ‘style’ sub-package to something else, and there’s no error.

Installer

FB-21960 FB Plug-in doesn’t launch on certain machines

Workaround: in eclipse.ini file, change the memory allocation to;

-Xms80m

-Xmx256m

FB-26159 Uninstalling ColdFusion Builder deletes the Flash Builder RDS plugin. Workaround: Close ColdFusion Builder perspectives prior to uninstall or reinstall Flash Builder.

FB-26047 unable to install FB Plug-in into external eclipse 3.4.2 when language pack is not installed (Japanese Only)

Workaround: Install the Japanese Eclipse language pack.

FB-15844 FB Plug-in not supported on eclipse3.5 cocoa on mac

FB-25217 Flash Builder installation not supported on Windows OSs where the user name has 4-byte characters.

Project Definition

FB-12261 project that contains modules, and uses -resource-bundle-list compiler option do not list any bundle names derived from [ResourceBundle()] metadata tag

Workaround: if you build large project with many modules, edit the .actionScriptProperties file and comment the modules, build the to generate the bundles.txt. copy the bundles.txt to other location and uncomment the modules to compile the whole project without overwriting the bundles.txt. Everytime you add resourcebundle, you have to repeat this process

Project: Import/Export

FB-26119 FXP import does not update source path when using linked folders

Workaround:Fix .actionScriptProperties file manually or re-add the source path in the project properties UI. For a consumer of a new FXPL, this isn’t obvious.

Refactoring

FB-25769 ASDoc is not updated when using refactor>rename and rename textual matches is checked

Miscellaneous

FB-11184 If you experience crashes while embedding fonts in CSS design view, then try embedding the font using a URL to the ttf file instead of using the system font name.

FB-23727Flash Builder intermittently hangs while opening projects.

Workaround:

Exit Flash Builder
Edit INSTALL_DIRECTORY/plugins/com.adobe.flexide.editorcore_4.0.0.272416/.options
Set the value of com.adobe.flexide.editorcore/registerCodeModelProjectsAsynchronously to true
Re-launch Flash Builder
FB-23023 Line numbers wont scroll along with the rest of the text and breakpoints etc wont show up in the AS editor if on secondary screen

Workaround:Update and patch information here http://blogs.adobe.com/jasonsj/2010/02/patch_for_snow_leopard_line_number_scrolling_bug.html.

Eclipse Update Site Mechanism (P2)

In order to install additional plug ins on OS X and Windows XP, you need to be logged in to a user account with Administrator privileges.
In order to install additional plug ins on Windows Vista and Windows 7, you must launch Flash Builder via the “Run as Administrator” context menu option and authenticate if prompted
If you are installing ColdFusion Builder or the LCDS Modeler plug ins, you will need to run Flash Builder once using a user account that is in the Administrator group on OS X or XP or with “Run As Administrator” on Windows Vista and Windows 7.

Flex Unit

FB-25586 FlexUnit fails to compile if locale is not support by Flex SDKWorkaround:Set the -locale to en_US

Network Monitor

FB-23419Suspend on startup will not suspend the network calls

FB-25589 Network monitor on – not able to make requests

Profiler

FB-23384Loitering Objects Show Zero Object References

FB-23543Safari browser crashes running profiler for the second time

FB-24111 Flash Builder Profiler doesn’t report all methods for Spark components

FB-24109 Flash Builder Profiler doesn’t report all objects for Spark components

FB-25184 Profiler does not show back references in AIR

Third Party IDE Compatibility

FB-19703 Unable to install Flash Builder plug-in properly into Zend Studio 6.1.2 standalone. The recommended workaround is to install the Flash Builder plug-in into the All-In-One Eclipse PDT + Zend Debugger Plug-in (http://www.zend.com/en/community/pdt). An alternate workaround (not recommended) is to rename the “dropins” folder to “links” and restart Zend.

DCD: LCDS

FB-22755 Cannot use update method which has changes – public void updatePerson3Params(Person person, Person prev, ArrayList changes)

DCD: PHP Introspector

FB‐19657 optional arguments not displayed after introspection

FB-19046 PHP Introspector can fail when authentication is enabled on the web server (like IIS)

DCD: Configure Return Type

FB-22805 Auto guess not working when service is created using Generate a Sample link

FB-24640 : [WSDL] Configure Return Type and Test Operation for WebServices is not allowing Date input format

Flex Automation

FLEXENT-792: Very low level of control on the pointing hand movements if you use object spy and move over Flex components in an Air application.

DCD: Service Wizard

FB-24162: [SDK][Dependent][Static XML] RTE occurs as auto CRT incorrectly parses xmls with empty data type

GB18030 support for Windows XP

In order to support the display of all characters of the Chinese standard GB18030 on Windows XP systems, Adobe recommends the installation of the Microsoft GB18030 Support Package. This support package will update an XP system with, among other things, fonts and input-method-editors (IMEs) to correctly support GB18030. The support package is available as a download from the Microsoft website.

Customer care
Customer Service

Adobe Customer Service provides assistance with product information, sales, registration, and other non-technical issues. To find out how to contact Adobe Customer Service, please visit Adobe.com for your region or country and click on Contact.

Support Plan Options and Technical Resources

If you require technical assistance for your product, including information on complimentary and fee-based support plans and troubleshooting resources, more information is available at http://www.adobe.com/go/support/. Outside of North America, go to http://www.adobe.com/go/intlsupport/ click on the drop down menu under the question “Need a different country or region?”, choose a different country or region, then click GO. Alternatively, you can click on Change beside the country name at the top of the screen to select a different country or region.

Free troubleshooting resources include Adobe’s support knowledgebase, Adobe user-to-user forums, Adobe Support Advisor and more. We are continually making additional tools and information available online in order to provide you with flexible options for resolving issues as fast as possible.

Other resources

Online Resources

For complete Help plus community-based instruction, inspiration, and support, go to www.adobe.com/go/learn_Flex_support_en

Adobe Flash Builder Product Information

Flex Developer Center

Flex Developer Center Documentation

Free Flex-in-a-Week training

Tour de Flex – Sample code and Examples for Flex

3rd Party Products and Projects supporting Flex

Adobe TV

Flex User Forums

Adobe User Groups

Adobe Marketplace and Exchange

Training

Adobe Certification Program

Adobe Partner Programs

Find an Adobe Authorized Training Center

© 2010 Adobe Systems Incorporated. All rights reserved.