Flex 3:Release Notes
From Adobe Labs
| Table of contents |
|
3.1 Installing Flex Builder 3 Beta 3 3.2 Installing Flex SDK 3 Beta 3 |
Overview
Welcome to the Adobe® Flex™ 3 Beta 3 release!
Adobe Flex 3 was formerly known as the Moxie release.
NOTE: Beta 3 is the final preview of the Flex 3 release. Please try out this beta and if you find bugs, please report them to the public bugbase (http://bugs.adobe.com/flex).
Adobe® Flex™ Builder™ 3 is Adobe's professional Flex IDE built on Eclipse™. It can run either as a standalone tool or as a plug-in to an existing Eclipse installation. Flex SDK includes the Flex framework (also known as the Flex class library), Flex command-line compilers, Adobe AIR™ framework, Adobe AIR command-line compilers, the Flex debugger, the ASDoc utility, and the debugger version of Flash Player. Use Flex SDK to develop, compile, and deploy Flex applications that connect to XML and SOAP web services with no additional charges or server licensing required. This release also includes Data Visualization features (formerly Flex Charting).
NOTE: Flex Builder 3 automatically installs a copy of Flex SDK 3. It also includes a copy of Flex SDK 2.0.1 as part of its support for multiple Flex SDKs.
WARNING: Do not install Flex Builder 3 Beta 3 on top of an existing installation of Flex Builder 2 or a previous Beta version of Flex Builder 3. In particular, do not install the plug-in version of Flex Builder 3 Beta 3 into an Eclipse installation that is already running the plug-in version of Flex Builder 2.
System requirements
These are the configurations tested for this beta release. Others may be added at a later date.
NOTE: Flex 3 applications will run on any version of Flash Player 9, although size optimization through signed RSLs is only supported on Flash Player 9 (Version: 9,0,60,235) or later. Flex 3 Beta 3 includes the Adobe Flash Player 9 Update 3 (9.0.115.0) debug players.
Flex Builder 3 for Windows
- Intel® Pentium® 4 processor
- 1GB of RAM recommended
- Microsoft® Windows® XP (with Service Pack 2)
- Microsoft Vista™ Home Premium or higher
- 500MB (Stand alone) and 500 MB (Plug-in) of available hard-disk space to install
- Java™ Virtual Machine: Sun® JRE 1.4.2, Sun JRE 1.5 (included), IBM® JRE 1.5, Sun JRE 1.6
- Eclipse 3.2.2 or higher for Plug-in install (Eclipse 3.3 recommended for Windows Vista)
- New Flex Builder 3 projects create applications that require users to have Flash Player 9 (9.0.30) or higher. You can change this to an earlier version of Player 9 in the Flex Compiler section of your project's Properties.
- BEA Workshop 10.1
- IBM Rational Software Architect 7.0.0.3 (Eclipse 3.3 plug-in configuration only). Known issue: There is a conflict between the version of Xerces that Flex uses and the one that is included with the IBM JVM. In order to use the IBM JVM 1.4.2 with the Flex command-line compilers you need to make sure that the VM loads the version of Xerces supplied with Flex instead of the one in the IBM JVM. For more information on this issue, review this TechNote.
Flex Builder 3 for Mac OS X
- G4 1.25GHz PowerPC or Intel-based Mac
- OS X 10.4.7 through 10.4.10, OS X 10.5.x
- 1GB of RAM recommended
- 500 MB of available hard-disk space to install
- Java Virtual Machine: JRE 1.5 or JRE 1.6 from Apple®
- Eclipse 3.2.2 or higher for Plug-in install
- New Flex Builder 3 projects create applications that require users to have Flash Player 9 (9.0.30) or higher. You can change this to an earlier version of Player 9 in the Flex Compiler section of your project's Properties.
Flex 3 SDK
- Windows 2000 Server, XP, or Server 2003 (x86, x64 compiler only)
- Mac OS X 10.4.x, Mac OS X 10.5.x, Java 1.5
- Java 1.6 (Sun), Java 1.5 (Sun) or Java 1.4.2 (Sun, IBM, or BEA)
- Red Hat® Enterprise Linux® 3 or 4, SUSE™ Enterprise 10, Java 1.4 (Sun, IBM, or BEA) or 1.5 (Sun) (x86)
- Solaris™ SPARC® 9, 10, Java 1.4.2, 1.5, 1.6 (Sun) Compilers only
- 512MB of RAM, 1GB recommended
- 200MB of free disk space
Installation Instructions
Installing Flex Builder 3 Beta 3
This release contains the following versions of Flex Builder:
- Stand-alone Flex Builder IDE (built on Eclipse)
- Flex Builder Eclipse Plug-in
- Additionally, both the Stand-alone and Plug-in versions of Flex Builder now contain two Flex SDKs; Flex 3 (Beta 3) and Flex 2.0.1 Hotfix 3.
NOTE: You can run Flex Builder 2.0.1 and Flex Builder 3 Beta 3 on the same system. You do not have to uninstall Flex Builder 2.0.1.
WARNING: Do not install Flex Builder 3 Beta 3 on top of an existing installation of Flex Builder 2 or a previous Beta version of the Flex Builder 3. In particular, do not install the plug-in version of Flex Builder 3 Beta 3 into an Eclipse installation that is already running the plug-in version of Flex Builder 2.
When using Flex Builder 3 Beta 3 with a workspace from a previous beta, please clean and reinitialize the workspace. Note that this operation does not remove or alter Eclipse projects residing the workspace in any way.
Windows:
- Go to the install directory; drive:\Program Files\Adobe\Flex Builder 3, or the root of the Eclipse install directory if using the Flex Builder Plug in
- Edit FlexBuilder.ini or Eclipse.ini in a text editor
- Add the following to the top of the file (not the bottom)
- -clean
- Launch Flex Builder or Eclipse
- Remove –clean after exiting Flex Builder or Eclipse
OS X:
- Go to the install directory; /Applications/Adobe Flex Builder 3, or the root of the Eclipse install directory if using the Flex Builder Plug in
- Right click on the Flex Builder application or Eclipse application and choose Show Package Contents
- Open Contents > MacOS
- Edit FlexBuilder.ini or Eclipse.ini in a text editor
- Add the following to the top of the file (not the bottom)
- –clean
- Launch Flex Builder or Eclipse
- Remove –clean after exiting Flex Builder or Eclipse
Installing Flex Builder stand-alone
To install Flex Builder on Windows:
The default location of the installation directory for Flex Builder stand-alone is C:\Program Files\Adobe\Flex Builder 3.
- Prior to installing, remove any prerelease versions of Flex Builder 3.
- Download Flex Builder Win SA from the Adobe Labs site.
- Open or double-click the installer executable file.
- Accept the license agreement and follow the prompts.
- By default, the debugging version of the Flash Player 9 browser plug-in is selected for installation.
- The debugging version of Flash Player is Flash Player 9 (9.0.115.0)
- This version is required for viewing and debugging applications developed with Adobe Flex Builder.
- You must select separate installs of the Flash Player plug-in for Internet Explorer and for Firefox and Netscape browsers.
- (Optional) You can select the following to install:
- ColdFusion Extensions for Flex Builder
- JSEclipse - JavaScript plug-in (not available in Japanese)
- Follow the prompts to complete the installation.
- Review the Release Notes.
- Start Flex Builder using its shortcut in the Start menu under Adobe.
- When prompted choose the Trial option.
To install Flex Builder on Mac OS X:
- Prior to installing, remove any prerelease versions of Flex Builder 3.
- Download Flex Builder Mac SA from the Adobe Labs site.
- Open or double-click the installer DMG file. The installer image will be mounted.
- Open or double-click the installer application to begin the Flex Builder installation process.
- Accept the license agreement and follow the prompts.
- By default, the debugging version of the Flash Player 9 browser plug-in is selected for installation.
- The debugging version of Flash Player is Flash Player 9 (9.0.115.0)
- This version is required for viewing and debugging applications developed with Adobe Flex Builder.
- (Optional) You can select the following to install:
- ColdFusion Extensions for Flex Builder
- JSEclipse - JavaScript plug-in (not available in Japanese)
- Follow the prompts to complete the installation.
- Review the Release Notes.
- To start Flex Builder, locate and double-click the executable file in /Applications/Adobe Flex Builder 3.
- When prompted choose the Trial option.
Installing Flex Builder plug-in
NOTE: Flex Builder is only supported on Eclipse 3.2.2 or Eclipse 3.3.
WARNING: Do not install the plug-in version of Flex Builder 3 Beta 3 into an Eclipse installation that is already running the plug-in version of Flex Builder 2.
To install the Flex Builder Eclipse plug-in on Windows:
- Prior to installing, remove any prerelease versions of Flex Builder 3.
- Download Flex Builder Win plugin from the Adobe Labs site.
- Open or double-click the installer executable file. Accept the license agreement and follow the prompts.
- By default, the debugging version of the Flash Player 9 browser plug-in is selected for installation.
- The debugging version of Flash Player is Flash Player 9 (9.0.115.0)
- This version is required for viewing and debugging applications developed with Adobe Flex Builder.
- You must select separate installs of the Flash Player plug-in for Internet Explorer and for Firefox and Netscape browsers.
- (Optional) You can select the following to install:
- ColdFusion Extensions for Flex Builder
- JSEclipse - JavaScript plug-in (not available in Japanese)
- Follow the prompts to complete the installation.
- Review the Release Notes.
- Start Flex Builder using its shortcut in the Start Menu under Adobe.
- When prompted choose the Trial option.
NOTE: You must create a new workspace before beginning. Select File > Switch Workspace from the menu bar and enter a new directory name. If the directory does not exist, Eclipse creates it.
To install the Flex Builder Eclipse plug-in on Mac OS X:
- Prior to installing, remove any prerelease versions of Flex Builder 3.
- Download Flex Builder Mac plugin from the Adobe Labs site.
- Open or double-click the installer DMG file. The installer image will be mounted.
- Open or double-click the installer app to begin the Flex Builder installation process.
- When prompted select the existing Eclipse installation directory.
- Accept the license agreement and follow the prompts.
- By default, the debugging version of the Flash Player 9 browser plug-in is selected for installation.
- The debugging version of Flash Player is Flash Player 9 (9.0.115.0)
- This version is required for viewing and debugging applications developed with Adobe Flex Builder.
- (Optional) You can select the following to install:
- ColdFusion Extensions for Flex Builder
- JSEclipse - JavaScript plug-in (not available in Japanese)
- Follow the prompts to complete the installation.
- Review the Release Notes.
- To start Flex Builder, locate and double-click the executable file in /Applications/Adobe Flex Builder 3.
- When prompted choose the Trial option.
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.
Installing Flex SDK 3 Beta 3
When you install Flex Builder, the Flex SDK is also installed, but if you do not want to install Flex Builder, you can install Flex SDK separately. The Flex SDK install, which is delivered as a ZIP file, contains the Flex framework, Adobe AIR framework, and command-line tools, such as the mxmlc command-line utility, Adobe AIR command-line utility, the ASDoc utility, the Flex command-line debugger, and the debugger version of Flash Player.
Uninstall Current Flash Player
Prior to installing the Flex SDK you must first uninstall your current Flash Player.
Windows—Internet Explorer
Due to security features in the Adobe Flash Player ActiveX Control, you must first remove all existing installations of Flash Player from your Windows system before installing prerelease versions of the Flash Player ActiveX Control. To do this:
- Download the Uninstaller.
- Open the Windows Command Prompt ( Run > cmd ).
- Navigate to the directory where the uninstaller was downloaded to.
- Execute the following command:
uninstall_flash_player.exe /clean
Windows—Plugin-based browsers
Run the appropriate uninstaller available from this TechNote.
Macintosh
Run the appropriate uninstaller available from this Technote.
Linux
Manual removal (for users who installed the plug-in via Install script):
- Delete the libflashplayer.so binary and the flashplayer.xpt file in directory /home/<user>/.mozilla/plugins/
RPM removal:
- As root, enter in the following command:
# rpm -e flash-plugin
- Click Enter and follow the prompts.
Installing the Flex SDK
To install the Flex SDK:
- Download Flex SDK ZIP file from the Adobe Labs site.
- Create a directory to contain Flex SDK.
- Extract the Flex SDK ZIP file to this directory. The Flex SDK contains the following directories:
- /ant — Contains Flex Ant Tasks.
- /asdoc — Contains helper files for the ASDoc tool that creates HTML documentation from your MXML and ActionScript source code.
- /bin — Contains the mxmlc, compc, asdoc, and fdb utilities. The bin directory also contains the jvm.config file, which specifies Java settings that you can modify, if necessary.
- /frameworks — Contains compiled framework classes, configuration files, and framework source code.
- /lib — Contains JAR files used by the utilities.
- /runtimes — Contains installers for the Adobe AIR runtime inside the air directory and installers for debug versions of Flash Player 9 inside the player directory.
- /samples — Contains sample applications.
- /templates — Contains HTML templates for Flash Player detection and browser integration and inside the air folder, a sample Adobe AIR application.xml file.
- Review the Release Notes.
- Ensure that the Java Runtime Environment (JRE) is installed on the computer and that the java_home/bin directory is defined in the system path. JRE 1.4, 1.5, or 1.6 is required. For 1.4, JRE 1.4.2_06 or later is required.
- Install the appropriate Flash Player from the install_root/runtimes/player/platform directory.
- (Optional) When the Flash Player installation finishes, restart your computer to ensure that the updated Flash Player browser plug-in is enabled.
- Continue by reviewing the samples. To run the samples, you must first compile them running the install_root/samples/build-samples.bat (Windows) or install_root/samples/build-samples.sh (UNIX and Mac OS X) files. For more information on the Flex compilers, see the "Using the Flex Compilers" chapter in the Building and Deploying Flex Applications manual. For example, to compile the install_root/samples/explorer/explorer.mxml file, open a console window, navigate to the install_root/bin directory and issue the following command:
install_root\bin>mxmlc ../samples/explorer/explorer.mxml
Installing and Configuring Flex Automated Testing
To use Flex Automated Testing, you must install Flex Builder 3. You cannot use Flex Automated Testing with only the Flex 3 SDK. If you do not have a Flex Builder Professional license, your test scripts are limited to 30 actions. If you exceed 30 actions in a test without the Pro license, you will receive a warning that your license is not present.
Flex Automated Testing SWC files are installed by default with Flex Builder 3. They are located in the /frameworks/libs directory with the other SWC files. You can begin using Flex Automated Testing and build your own custom agents without any further installation.
To use run-time automated testing (recommended):
- Open a command prompt.
- Navigate to the flex_builder_root/sdks/3.0.0/templates/automation-runtimeloading-files directory.
- Execute the build.bat file. This compiles the runtimeloading.mxml file into a SWF file.
- Copy the runtimeloading.swf and RunTimeLoading.html file to your web server. Copy the Flex application that you want to test to this server as well (the application need not be compiled with automation libraries).
- Request the RunTimeLoading.html file and pass your Flex application as the automationswfurl query string parameter; for example:
http://localhost/RunTimeLoading.html?automationswfurl=MyApp.swf
To compile your applications with static automation support:
- Start Flex Builder.
- Create a new Flex Project.
- Select your new Flex project in the Navigator.
- Select Project > Properties > Flex Compiler.
- In the "Additional compiler arguments" field, enter the following:
-include-libraries "flex_builder_dir\sdks\3.0.0\frameworks\libs\automation.swc" "flex_builder_dir\sdks\3.0.0\frameworks\libs\automation_agent.swc" "flex_builder_dir\sdks\3.0.0\frameworks\libs\qtp.swc" "flex_builder_dir\sdks\3.0.0\frameworks\libs\automation_dmv.swc"
The -include-libraries compiler option is relative to the Flex Builder installation directory; the default on Windows is "C:\Program Files\Adobe\Flex Builder 3\".
- 6. Click the OK button to save your changes and OK to close the project Properties dialog box.
- 7. Compile your Flex application.
Examples and documentation for using custom agents can be found at Custom Agents.
To use Flex Automated Testing with the Flex 3 Plug-in for Mercury QuickTest Pro, you must perform additional steps. The rest of this section describes how to install and use the Flex 3 Plug-in for Mercury QuickTest Pro.
Requirements for Using the QTP Plug-in
To test applications with Flex Automated Testing and the QTP agent, you must install the following:
- Mercury QuickTest Professional 9.1 or later (no support for Smart Identification)
- Mercury QuickTest Professional 9.2 and patch 1701 if you want Smart Identification support
- Adobe Flex 3 Plug-in for Mercury QuickTest Pro
- Microsoft Internet Explorer, version 6 or later
- Flash Player ActiveX control, version 9.0.28.0 or higher
Installing the Plug-in
This section describes the steps necessary for a QC testing professional to configure QTP to work with Flex applications. You must install QTP and the plug-in.
To install QTP:
- Install Flash Player 9 ActiveX control (9.0.28.0 or higher) for Microsoft Internet Explorer. This is currently the only supported browser/player.
- Install QTP 9.1 or later if you do not require support for Smart Identification. If you want to use Smart Identification, install QTP 9.2 and patch 1701. You must get QTP 9.1 from Mercury.
- If you are using Mercury QTP on Microsoft Windows Vista you need to turn off the User Account Control (UAC) feature. Instructions to turn off UAC are available here
- Restart your computer.
To install the Flex 3 Plug-in for Mercury QuickTest Pro:
- Run the flex_builder_root/Installers/QTP_Plugin_Installer.exe.
- Start QTP.
- Close QTP.
In addition to the plug-in's DLLs and XML files, the plug-in installer includes the following in the installation directory:
- /demo — Contains a Flash movie that describes the basics of using the plug-in. Be sure to enable audio on your computer.
- /Uninstall Adobe Flex 3 Plug-in for Mercury QuickTest Pro — Contains the uninstaller.
Using the Plug-in
- Start QTP again after installing the plug-in. The Add-in Manager lists the Flex plug-in.
- Select the Flex plug-in in the Add-in Manager.
- Select New > Test and click the Record button.
NOTE: Flex application testing with QTP currently supports only Microsoft Internet Explorer with the ActiveX Flash Player.
For more information on these tasks and using QTP to test Flex applications, see Testing with QTP.
For information on the operations and properties of Flex objects in QTP, see QTP Object Type Information.
Samples for Automated Testing
Sample custom agents are available at Custom Automation Agents.
An application ready for testing with QTP can be found at Flexstore AT. This sample can be used to test if the QTP plugin installation was successful.
An example for automating custom components can be found at Automating Custom Component.
Using automation with the Adobe Flex Component Kit for Flash CS3
You can create Flex controls, containers, skins, and other assets in Flash CS3 Professional, and then import those assets into your Flex application. When you want to automate an application that uses such assets, you must include the automation_flashflexkit.swc library.
If you are using run-time loading, re-compile the runtimeloading.swf file by using the build.bat file in flex_builder_root\sdks\3.0.0\templates\automation-runtimeloading-files\. The batch file includes the necessary libraries.
If you are compiling automation support into your application, add the automation_flashflexkit.swc to your include-libraries compiler option. This is in addition to the other automation SWC files. The SWC files are located in the flex_builder_root\sdks\3.0.0\frameworks\libs directory.
Uninstalling
Uninstalling Flex Builder
Uninstalling Flex Builder 3 on Windows:
- Select Start > Settings > Control Panel.
- Select Add or Remove Programs.
- Click the Adobe Flex Builder version to uninstall (Flex Builder, Flex Builder Plug-in only).
- Click the Uninstall button in the uninstaller dialog box.
- Click Done.
Uninstalling Flex Builder 3 on Mac OS X:
- Go to the flex_builder_root/Uninstall Adobe Flex Builder 3 folder.
- Double-click "Uninstall Adobe Flex Builder 3".
- Click the Uninstall button in the uninstaller dialog box.
- Click Done.
Uninstalling Flash Player
If you intend to debug your applications, use the debugger version of Flash Player that is included with either Flex Builder 3 or the Flex 3 SDK. If you are currently using a previously released Flash Player, you will need to uninstall that Player before installing the new debugger version of Flash Player.
Flash Player Uninstallation Instructions
- If you are using Flex Builder 3, the installer tries to uninstall your old Player before installing the appropriate debug Player.
- If you are using the Flex 3 SDK or did not install the new debug Flash Player when installing Flex Builder, use the following instructions:
Windows—Internet Explorer
- Due to security features in the Adobe Flash Player ActiveX Control, you must first remove all existing installations of Flash Player from your Windows system before installing prerelease versions of the Flash Player ActiveX Control. To do this:
- Download the Uninstaller.
- Open the Windows Command Prompt ( Run > cmd ).
- Navigate to the directory where the uninstaller was downloaded to.
- Execute the following command:
uninstall_flash_player.exe /clean
Windows—Plugin-based browsers
- Run the appropriate uninstaller available from this TechNote.
Macintosh
- Run the appropriate uninstaller available from this TechNote.
Linux
Manual removal (for users who installed the plug-in via Install script):
- Delete the libflashplayer.so binary and the flashplayer.xpt file in the /home//.mozilla/plugins/ directory.
RPM removal:
- As root, enter in terminal:
# rpm -e flash-plugin
- Click Enter and follow the prompts.
Documentation
Getting Started
If you are new to Flex or AIR, check out the following resources:
Before using the documentation, please refer to the feature pages on the Adobe Labs. These pages include descriptions and samples for features that are new to Flex 3.
Usage Information
Usage documentation is available in the Flex Builder online Help, from LiveDocs, or as a ZIP file. This ZIP file includes PDF versions of the following documentation resources:
- Flex topics
- Flex Data Visualization Developer Guide
- Developing AIR Applications with Flex
- Programming ActionScript 3.0
The ZIP file also contains the following books in PDF form:
- Developing AIR Applications with HTML and Ajax
- Developing AIR Applications with with Adobe Flash CS3
NOTE: For information on additional Adobe AIR documentation, including information on building Ajax applications with Adobe AIR, see the AIR Release Notes
Reference
The ASDoc-generated class reference documentation is available here:
- Flex ActionScript Language Reference (includes AIR classes)
Compatibility Issues
Adobe AIR
- If you are using Flex Builder 3 with Adobe AIR, you may encounter issues not covered in these release notes. Please take time to review the AIR release notes.
Flex SDK
- There are a number of Flex SDK backwards compatibility changes where you can return the behavior to Flex 2.0.1 using a new compiler argument -compatibility-version. To get the full details go to: Backwards Compatibility
- The DataGrid control's rowCount and lockedRowCount properties no longer include the header.
- The order of DataGrid children (such as the vertical scroll bar) has changed. This affects custom components that may have subclassed the DataGrid control and used the getChildAt() method to manipulate various children of the DataGrid control.
- The flashType CSS property has been deprecated. Components should use the advancedAntiAliasing property instead.
Flex Builder
- The Query Builder included in the ColdFusion Extensions for Flex Builder is not supported on the Mac OS X platform.
- Eclipse 3.2.1 is not supported on Vista.
- Flex Design Extensions for CS3 are not supported on non-English OSs
- With Flex Builder database wizards you can now generate sample code that will connect to your database tables through a server technology. The currently-supported platforms are:
- Java using the LiveCycle Data Services 2.5 server
- Java using REST(XML over HTTP) transport
- PHP using REST (XML over HTTP) transport (only for MySQL)
- ASP.NET (C# and VBScript) using WebServices (only for SQL Server)
Flash Player
- On Mac OS X, Flash Player now looks for the mm.cfg file in your home directory(~), generally, /Users/<username>. If one is not found, it looks for mm.cfg in /Library/Application Support/Macromedia. For previous versions of Flash Player, Flash Player ignored an mm.cfg file in your home directory /Users/<username>. For some users with an mm.cfg in their home directory, tracing to the flashlog.txt file will not work.
Flex 2 Charting
If you have a licensed version of Flex 2 Charting and want to use those components in Flex Builder 3, you must copy your serial number from the Flex 2 license.properties file to the Flex Builder 3 license.properties file for the SDK 2.0.1. In addition, to use Flex 2 Charting with Flex Builder 3, you must select the 2.0.1 SDK when compiling your applications in Flex Builder 3.
- Copy the following line from your Flex 2 Charting license.properties file and paste it into the flex_builder_root/sdks/2.0.1/frameworks/license.properties file:
charting=serial_number
- Select the SDK 2.0.1 in Flex Builder 3 by selecting Project > Properties > Flex Compiler. Select the Use a Specific SDK option, and select Flex 2.0.1 Hotfix 3 from the drop-down list.
- You must get a separate Flex 2 Charting serial number to use Flex 2 Charting components.
Known Issues
This section contains a product-specific list of known issues in the Flex 3 Public beta. Flex 3 uses a public bug system (http://bugs.adobe.com/flex) and most bugs in these lists contain a link to more detail in this bug system. You can also use the public bug system to post bugs you find in the beta 3 release.
When using the public bug system, you should start by clicking on the Bug Standards / Community Process link to learn more about the bug system (be sure to check the section at the bottom). Then go back, register for your account and you should be able to view and define bugs.
Flex SDK issues
Adobe AIR Support
- SDK-11066 If you try to set something on the stage before the creationComplete event from <mx:WindowedApplication>, it will throw an RTE saying you cannot access a property or method of a null object reference.
- SDK-12150 <mx:WindowedApplication> and <mx:Window> now have a visible property which you can set to false to prevent the window from showing. You no longer use the visible property setting in the application.xml file. You should set the visible property in application.xml to false so that all the layout processing can occur without redraws.
- SDK-12694 PrintDataGrid does not lay out well in <mx:WindowedApplication> without an explicit width and height. The workaround is to set an explicit height and width for PrintDataGrid.
Compiler
- SDK-9438 If you have a 2.0.1-style configuration file which specifies the locale, you will get an "Unexpected CDATA" error on the line that contains <locale>ja_JP</locale>. To avoid this error, change the <locale> tag to <locale><locale-element>ja_JP</locale-element></locale>.
- Also, if you use a command line similar to mxmlc -locale ja_JP MyApp.mxml where -locale is the last option before the target file, you must change it to either mxmlc -locale=ja_JP MyApp.mxml or mxmlc -locale ja_JP -- MyApp.mxml.
- SDK-12685 There is an issue where the line number of an error is completely wrong, usually beyond the end of a file. This is not a bug. The source file was probably saved in UNIX format, where line feeds/line endings are marked differently than on Windows (DOS formatting) and Mac (Mac formatting). There are trailing newline characters which the compiler correctly counts as blank lines, and some editors (like Flex Builder) display as blank lines, and other editors (like Vi) will display as control characters ("^M"). Resave your file in a DOS format to fix this (for example, copy and paste it from Notepad to Flex Builder and resave).
- SDK-11629 SWC libraries can now declare what metadata the linker should preserve when linking in code from that library. When a library is used to build an application, the application preserves the union of metadata from all the libraries that contributed to the application. You can preserve the metadata by using the -keep-as3-metadata compiler option when compiling a library. The use of -keep-as3-metadata option remains unchanged from the previous release when compiling an application.
- SDK-12262 Some embedded SVGs with opacity are blurry. This is an external issue where the SVG transcoder prematurely rasterizes elements with opacity, so Flash Player receives a bitmap instead of vector. Possible workarounds include:
- If you do not need runtime scaling, re-encode your image in a non-vector format such as PNG.
- Do not use opacity on blurry elements.
- If you can import your vectors into the Flash authoring IDE as symbols, you can access the image from the SWF using @Embed.
Components
- When dragging and dropping items in a DataGrid with locked rows, items may disappear or become duplicated. These issues will be fixed in the final release.
- SDK-11279 Panel only officially supports the "default" borderStyle. If you use an unsupported borderStyle, use padding values or absolute positioning to place your content in the correct place.
- SDK-13490 FormItemLabel has been deprecated. If you want the functionality of FormItemLabel, just use a regular Label. The recommended way to style a FormItem label is through the labelStyleName style on FormItem.
- SDK-13771 After a context menu has been shown in AIR, buttons and List-classes may experience problems with dealing with rollover/rollout.
- SDK-12732 Objects are not garbage collected after an explicit purge.
- SDK-10969 ComboBox selection using the mouse does not work on Firefox 1.5 with Flash Player r60.
- SDK-12159 DataGrid multiple selection does not work with wmode=opaque in Firefox with Flash Players r16, r28, and r47. It does work with Flash Player r60.
- SDK-12155 The dropdownFactory style set in MXML for the DateField control does not get applied. To work around the issue, set the style in an <mx:Style> tag or call setStyle() on the creationComplete event of the DateField.
- SDK-11469 Line breaks do not work in attribute text. In ActionScript strings use \n for line breaks. In XML text and attribute values, use .
- SDK-9452 Filter/sort on HVC is not implemented.
- SDK-13552 The Masked TextInput causes a compile error because of some Flex 3 changes to enable versioning. The error is related to adding or getting an IUITextfield. To fix the error, you need to cast the textfield to a DisplayObject. (e.g. addChildAt(embedTextField,getChildIndex(DisplayObject(textField))); )
- SDK-873 Launching popups from modules causes a runtime error if you do not import the shared resources in the main application. Add the following two lines to your main Application:
import mx.managers.IPopUpManager; private var iPopUpManager:IPopUpManager;
- SDK-13812 When using an embedded image with scale9Grid as the skin for a Button (or its subclasses), the label and icon positions will be adjusted by the scale9Grid values.
- SDK-13807 Items disappear as you drag and drop items into the very last empty node in the Tree. This problem will be fixed in the final release.
Deep Linking
- SDK-9632 Currently, deep linking support for Opera is limited. You can copy and paste a URL into Opera and the application should start in the appropriate state, but the URL is not subsequently updated with additional navigation.
- SDK-9628 You cannot have a # in the setFragment() method call. It is considered an invalid fragment.
- SDK-11349 To use deep linking with multiple SWF files on one HTML page, you must set the JavaScript variable BrowserHistory_multiple and make sure that the URL changes are unique to each individual SWF file.
Profiler
- SDK-9421, SDK-12655, and SDK-12638 In some cases the profiler may not show any back references for loitering objects. This happens mostly for non-heap objects, like String created during ABC decoding. To investigate loitering objects without back references, refer to the allocation trace, which must be enabled via the Launch Dialog.
- SDK-13616 Sometimes the profiler may create a project called "Adobe Flex Profiler" in the workspace. This project is used to assist the open source operation in the profiler if the related source files are not already open. It is safe to delete this project after profiling is complete.
- SDK-13688 Performance Profiling is not supported on Mac PPC hardware
- SDK-11179 If you need to change the browser preference for applications launched from Flex Profiling perspective, the preference should be changed from Windows -> Preferences -> Flex -> Profile -> Browser/Player.
- SDK-11131 Concurrent profiling on Mac OS might result in Flash Player crashing.
- SDK-13197 Profiler may stop working with an incorrect workspace entry in mm.cfg for PreloadSWF. To workaround this issue, first delete the contents of the mm.cfg file. Next, quit the browser in which your application was running and relaunch FlexBuilder. Finally, create a new workspace with a new project and begin profiling.
Other
- Only signed RSLs are included in the builds. To create an optimized RSL, please following these steps:
1. Extract Library.swf from the SWC. 2. Run the optimize tool to remove debug information and metadata. Specify the metadata you want to keep by using the –keep-as3-metadata option. 3. Optionally, run the digest tool to update the SWC digest information since the RSL has been modified.
Alternatively, here is an Ant task that runs the steps. The task assumes your SWC is a file, not a directory.
<?xml version="1.0"?>
<project name="myproject" default="create-my-rsls" basedir=".">
<target name="create-my-rsls" description="Build RSLs">
<macrodef name="create-rsl">
<attribute name="rsl-dir"/>
<attribute name="swc-dir"/>
<attribute name="swc-name"/>
<sequential>
<unzip src="@{swc-dir}/@{swc-name}.swc"
dest="@{rsl-dir}" >
<patternset>
<include name="library.swf" />
</patternset>
</unzip>
<java jar="${basedir}/lib/optimizer.jar" fork="true" failonerror="true">
<jvmarg line="-ea -DAS3 -DAVMPLUS -Dflexlib=${basedir}\frameworks -Xms32m -Xmx384m -Dsun.io.useCanonCaches=false"/>
<arg line="'@{rsl-dir}/library.swf' --output '@{rsl-dir}/@{swc-name}_3.0.${build.number}.swf'
--keep-as3-metadata='Bindable,Managed,ChangeEvent,NonCommittingChangeEvent,Transient' "/>
<delete file="@{rsl-dir}/library.swf"/>
<java jar="${basedir}/lib/digest.jar" fork="true" failonerror="true">
<jvmarg line="-ea -DAS3 -DAVMPLUS -Xms32m -Xmx384m -Dsun.io.useCanonCaches=false"/>
<arg line="--digest.rsl-file @{rsl-dir}/@{swc-name}.swf --digest.swc-path @{swc-dir}/@{swc-name}.swc"/>
</java>
</sequential>
</macrodef>
<!-- myswc RSL -->
<create-rsl rsl-dir="c:\myproject\rsls" swc-dir="c:\myproject\libs" swc-name="myswc"/>
</target>
</project>
- SDK-9788 The ASDoc tool does not work on Windows (e.g. with Japanese locale) if the absolute path to the code contains any unicode characters (the path seperator excluded). This is an open Java issue for all Windows versions of the JRE. Workaround: Replace all unicode path elements (including the file name) with ASCII characters, or don't use Windows.
- SDK-13751 If you install the flex module in a path containing 2-byte chars the Apache server will fail to restart.
- SDK-8877 Some PNGs do not maintain transparency when @Embed is used. This is an external issue. Possible workarounds:
- Run MXMLC/FB with JRE 1.5.
- Use a loader, do not embed.
- Re-encode your PNGs with Photoshop, try different formats.
- Re-encode the PNGs to GIFs.
- If you have the Flash authoring IDE, you can convert the PNG to a SWF file and use the SWF file in [Embed].
- SDK-11722 Wipe effects on Flash components can have unexpected side effects, including a runtime error. The solution is to add a boundingBox symbol to the Flash component, or to place the Flash component inside a Flex container and apply the effect to the container.
- SDK-12787 First history state is not stored when using HistoryManager.
- SDK 9223 If you use gzip compression for the web server that is hosting your Flex application, your web clients might experience problems loading your application. Turn off gzip compression to resolve the issue.
- SDK-9485 When skin styles are set for Button controls, these take precedence over the default skin styles for the ColorPicker and ComboBox controls. To work around this, you can explicitly set the skins for ComboBox and ColorPicker with the following:
<mx:Style>
ColorPicker {
upSkin: ClassReference("mx.skins.halo.ColorPickerSkin");
overSkin: ClassReference("mx.skins.halo.ColorPickerSkin");
downSkin: ClassReference("mx.skins.halo.ColorPickerSkin");
disabledSkin: ClassReference("mx.skins.halo.ColorPickerSkin");
}
ComboBox {
upSkin: ClassReference("mx.skins.halo.ComboBoxArrowSkin");
overSkin: ClassReference("mx.skins.halo.ComboBoxArrowSkin");
downSkin: ClassReference("mx.skins.halo.ComboBoxArrowSkin");
disabledSkin: ClassReference("mx.skins.halo.ComboBoxArrowSkin");
}
</mx:Style>
- SDK-11020 When Button skins are different sizes, the Button may have resizing issues.
- SDK-12798 When using an ObjectProxy with XML data that has a "<uid>" tag, the CDATA value may be irretrievable at runtime. ObjectProxy is a hashmap (a dynamic class), this allows properties to be added/retrieved at runtime; XML returned from an ObjectProxy in this way. To implement the IUID interface, ObjectProxy has to implement a public getter/setter, ObjectProxy.uid, which shadows the underlying XML data and makes it irretrievable at runtime. The workaround is to pre-process your XML to replace instances of <uid> with something else (e.g. <myUID>); you can do this in ActionScript using E4X.
If you are embedding static XML in a mx:Model, you may get a compiler error such as:
Method 'flex2.compiler.mxml.rep.MxmlDocument.getDefinitionIterator': invocation exception during codegen: java.lang.Integer
The CDATA of <uid> is not being resolved as a String (ObjectProxy.uid is a String getter/setter), such as <uid>12345</uid>. To get rid of this error, for the Integer case above, add a non-numeric character, such as surrounding quotes: <uid>"12345"</uid>, or prefix the number with a zero: <uid>012345</uid>. You will still have trouble retrieving this value, so a better solution is to rename all instances of the <uid> tag in the static XML.
Japanese Flex SDK
- SDK-13860 Some strings appear in English in the Profiler's Memory Usage tab after Flex Builder is restarted in Profiler view.
- SDK-13532 Cannot enter project name in Japanese if "Use Default Location" checkbox is checked on Macintosh.
Flex Builder issues
AIR
- FB-10592 Debugging AIR application always fails once before succeeding
- FB-11294 When signing AIR applications with a digital certificate, do not save the digital signature file (ends with .p12) inside the project's source folder or it will be embedded into the AIR app itself, which is a security risk.
Profiler
See Profiler section of the Flex SDK release notes.
ActionScript Editor
- FB-10804 Organize Imports does not verify whether or not the file is writable.
- FB-6060 if you auto-complete trace() it will add an import for trace which doesn't compile
Installer
- FB-9038 UNC homedrive and homepath leads to win install failure. Workaround: Use a local user account.
- FB-10052 Flex Builder does not run in 64-bit eclipse
Design View
- FB-11043 Undo changes to scale grid are not reflected in CSS DV until file is closed and reopened
- FB-11046 Mac only: Sometimes the Design Area label and dropdown is not redrawn/white on the document toolbar
- FB-11252 A custom component with nothing but a constructor freezes Flex Builder in Design View. A workaround is to add a dummy updateDisplayList method that just calls the super method.
Project
- FB-10212 No way to add an air project nature
- FB-11116 The Flex SDK version is set to "Use server's SDK" if you use a linked resource as the root folder. Workaround: Go to Flex Compiler property page and change the SDK used.
- FB-11064 Pre-2.5 server project defaults to incompatible client SDK. Workaround: Go to Flex Compiler property page and change the SDK used.
- FB-10826 Unable to specify a Content Folder that is more than one directory level deep. Workaround: Update the .setting files and flex build configuration for libraries, src, etc.
- FB-8947 Output folder URLs with "file:///C:" are not recognized as valid.
- FB-5692 Flex Builder wraps Eclipse linked resource names in dollar curly brace, e.g. ${FOO}.
- FB-11171 You can't create an ASP.NET project if you don't have any Development Server installed. If you tried to create an ASP.NET project quit the New Flex Project Wizard before trying to create another project. Workaround: Install Visual Studio or Visual Web Developer Express Edition, 2005 or higher.
Refactoring
- FB-11168 Refactoring classes and interfaces from SWC Projects currently does not work unless the refactoring is started from within originating SWC Project.
- FB-11132 Mark occurence not working in as file
ColdFusion Extensions for Eclipse
- FB-10914 Using the ColdFusion/Flex wizard with and exisiting Flex Project that uses Cold Fusion server overwites the additional compiler arguments. Workaround: Change the additional compiler argument back to the one used before using the ColdFusion/Flex wizard.
- FB-10913 Using the ColdFusion/Flex wizard with and exisiting Flex Project that uses Cold Fusion server changes the output folder. Workaround: Go to Project -> Properties -> Flex Build Path and set the output folder and the output folder URL.
- FB-10907 Projects created with the ColdFusion/Flex wizard don't have server properties. Workaround: Use the Flex project wizard to create a CF project using as a default location a folder on your Web Root and then use the ColdFusion/Flex wizard, selecting on the last step to use the existing flex project.
- FB-9616 Exception when closing Flex Builder after using CF RDS
- FB-9888 Cannot install ColdFusion Flex Builder Extension into BEA 10.2
- 70945 - Unable to make an AIR application created using Flex Builder3 work with the ColdFusion Flex Wizard. The workaround is as follows:
- Copy <application>-app.xml from "<Project root>/src_old" to "<Project root>/src".
- Rename the copied <application>-app.xml to main-app.xml.
- In main.mxml change the "mx:Application" to "mx:WindowedApplication".
- Add "endpoint="http://localhost/flex2gateway/"" attribute to <mx:RemoteObject tag in <Project rooot>/src/com/cfgenerated/views/master/<Name of Page>.mxml. (You need to add endpoint url (Step 4) for all pages in master/detail forms)
- Compile and run the project
Flex Skin Design Extensions for CS
- FB-11006 Flash Skinning Templates: Library and exported SWC contain a few symbols with non-canonical names
- FB-11003 Photoshop Skinning Extension: Only individual layers are exported, causing problems for nested layers
Japanese Flex Builder
- FB-6026 Double-byte workspace name gets corrupted on Macintosh, causing Run/Debug to fail. Components icons are not displayed correctly.
- FB-10838 Japanese version of sample Explorer project must be updated for Flex 3.
- FB-11057 Flex Builder cannot be uninstalled in English locale if it was originally installed in Japanese locale on double-byte path.
- FB-10411 Cannot create Output folder with double-byte name on Macintosh.
- FB-10021 Duplicate folder with a corrupted name is created if Workspace folder name contains double-byte characters with diacritics on Macintosh.
- FB-10124 Flex Builder crashes when installed on a path containing certain double-byte character on Windows.
- FB-10088 Flex Skin Design Extensions for Illustrator and Photoshop do not function with CS3 Japanese Edition
- Flexdocs-303 Blank Help window is displayed when search is conducted on "Programming ActionScript 3.0" help set.
Data Management and Visualization issues
Advanced DataGrid
- FLEXDMV-1449 Setting a custom sort renderer at runtime does not work
- FLEXDMV-1438 Vertically scrolling while doing multiple cell selection does not work properly
- FLEXDMV-1117 ADG Summary Rows may move to the top when a column is sorted
- FLEXDMV-1417 Setting sortExpertMode of PADG does not render the sort display properly
- FLEXDMV-1382 Sort indication shown in sort icon area is incorrect when user wants to change the sort order (ascending/decending) on already sorted column
- FLEXDMV-1347 MXML completion does not take DefaultProperty into account
- FLEXDMV-1171 Cell highlight incorrect on keyboard navigation using ENTER key
- FLEXDMV-784 Drag and drop non functional when selectionMode="multipleCells"
- FLEXDMV-1300 Flex Builder Design View goes blank after refresh when an AdvancedDataGrid with "groupedColumns" is used
Other
- SDK-11539 adding datavisualization.swc as an rsl causes run time errors.
To workaround the issue modify the Flex Project's properties. Choose "Flex Build Path", then select the "Library Path" tab. Select the framework.swc entry in the Flex SDK. The framework.swc library needs to be linked as an RSL and moved up in the library order before datavisualization.swc. To make framework RSL load before the datavisualization RSL this press the "Up" button until the framework.swc entry comes before the datavisualizatoin.swc entry.
By default framework.swc is configured with the correct RSL properties. To enable linking as an RSL change the "Framework Linkage" combo to "Runtime Shared Library (RSL)".
Flash Player issues
- If FlashPlayerTrust is mistakenly created as a file, the Flex profiler will crash. Please ensure FlashPlayerTrust is properly configured as a directory (bug#203879).
Documentation Issues
- FLEXDOCS-282 'Create Self-Signed Digital Certificate' help button does not open a help topic
