Flex Release Notes

Flex 2 SDK and Flex Charting 2 Release Notes

This page contains release notes for:

This page includes the following sections:

Related topics:

Flex 2 SDK

Flex 2 SDK includes the Flex framework (also known as the Flex class library), Flex command-line compilers, the Flex debugger, 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.

Note: Adobe® Flex™ Builder™ 2 and Flex Data Services 2 automatically install a copy of Flex 2 SDK.

This discussion includes the following sections:

For instructions on installing Flex 2 SDK, see the Flex 2 Installation Instructions.

What's new

The following list shows some of the major new features and changes for Flex 2 SDK. See the Flex Developer Center more information on new features.

  • New Components and component features: The Flex framework includes many new components to make user navigation and interaction easier, such as:

    • Popup Menu Button
    • ButtonBar
    • PrintDataGrid
    • Media Component
    • Application ControlBar
    • Rich Text Editor
    • Skinning
  • Localization/Internationalization - Enhancements to localization and internationalization features include:

    • IME support
    • Localized MXMLC errors
    • Runtime strings and errors
  • CSS-based skinning - You can now apply graphical or programmatic skins with style sheets.
  • Event model - The Flex 2 event model now closely matches the DOM event standard. You can now bubble and capture events, and prioritize them.
  • Accessibility Improvements -
  • Item Renderer (formerly called cell renderer) improvements - Flex 2 makes it easier to customize the appearance and behavior of cells in list-based data provider controls.
  • Component Templating - By using a general data type to define component properties, you can create highly reusable components that can work with many different types of objects.
  • Effects Enhancements - Enhancements to effects in Flex 2 include using Flash Player filters and easing functions that let you fine tune animations to allow for acceleration, deceleration, bouncing, and other types of motion.
  • Constraint-based layout - Manage component size and position simultaneously by using constraint-based layout, where you anchor the sides or center of a component to positions relative to the container.
  • Collections - Collections store data that you can access, sort, filter, and modify. Types of collections include Array collections, XML List Collections, and Hierarchical Collections.
  • View states - Let you change the interface based on the task the user is performing.
  • Transitions - With transitions, you can define a smooth visual change from one state to the next, in which the change occurs over a period of time.
  • Updated Aeon look and feel - Flex includes an all-new default theme, Aeon, and its graphical source files. Flex 2 also includes the source for the Halo theme, for those designers who want to use the "classic" look.
  • Filters - You can now apply drop shadows, glows, bevels, and other bitmap effects to text, controls, or other graphical objects.
  • Scale-9 (also known as 9-slicing) - Lets you define sections of an image that scale independently; for images with borders or fancy corners; this provides more flexibility than full-graphic scaling.
  • Languages: MXML and ActionScript 3.0 - MXML is the language that developers use to define the interface of an application. ActionScript 3.0 is the language that defines the application's logic.
  • Serverless deployment - You can now compile and deploy your Flex applications without a server. No server is required for data access components (such as WebService, HTTPService, and RemoteObject), history management, or Flash Player version detection.
  • Additional themes - Flex includes several additional themes including Ice, Smoke, Institutional, and Wooden.
  • FlashType fonts - Flex can embed FlashType fonts, which use a text rendering engine that provides clear, high-quality text rendering in SWF files.
  • Source code - The source code for the Flex framework is included, making it easier to customize and extend Flex classes and controls.
  • Express Install - Flex HTML wrapper templates include support for Express Install, the new Flash Player version detection method.
  • Sample applications - Flex 2 includes a rich set of sample applications including a photo viewer, restaurant finder, dashboard, and all-new Flex store.
  • ColdFusion/Flex Connectivity - Flex applications can leverage the easy data connectivity capabilities of ColdFusion with the ColdFusion/Flex Connectivity components.

Compatibility issues

Flex 2 SDK is a major upgrade from Flex 1.5 and you must migrate Flex 1.5 applications before compiling them under Flex 2. For more information, see Migrating Applications to Flex 2.

Known issues

Flash Player and debugging

  • fdb returns a "Failed to connect; session timed out" error - If you compile your Flex application with debugging enabled, run fdb, and after two minutes it returns a "Failed to connect; session timed out" error message, ensure that you are running the content debugger version of the Flash Player.

    The condition can exist if you installed the standard Flash Player, version or higher, from the Adobe download site and later installed the Flash Player that ships with Flex 2 SDK; or you installed the Flash Player from Flex 2 SDK and then updated the Flash Player to standard Flash Player or higher from the Adobe download site.

    To resolve this issue, see the instructions at


  • To use the IBM JVM 1.4.2 with the Flex command-line compilers, you must ensure that the JVM loads the version of xerces supplied with Flex instead of the one in the IBM JVM.

Windows users:
Add the following JVM argument to the bin/jvm.config:

For example:

UNIX users:
Add the following JVM argument to the bin/mxmlc and compc scripts:

For example:


  • If you have a data collection set up with paging and use that collection as the dataProvider for a DataGrid, pushing the End key sometimes results in an uncaught ItemPendingError.
  • If replacing data while editing a selection, the editor moves to the title bar of the same column
  • If the user is able to rearrange the columns of a DataGrid, the columns array of each DataGrid cannot be bound to the item renderer's data. Instead, the columns' array must be defined elsewhere.


  • If you use the Rotate effect and then scroll in an MXML application, the component moves its position.
  • Effects specified on the root tag are not executed.


  • Removing an item from the dataprovider shows the wrong selectedIndex, even though it is bound

MXML Compiler

  • Incremental compiling shows error after updating a resource bundle


  • Using an embedded font on the title of TitleWindow or Panel causes the Panel to have an unnecessary vertical scrollbar


  • A Runtime exceptioncan occur when tabbing through the Accordion example in the Explorer sample.

Tab Navigator

  • The textAlign style does not work for TabNavigator.


  • There are some instances where the valueCommit event is not dispatched, such as when setting selectedItem programmatically, and when closing the parent node of the currently selected item.
  • You may find issues related to deleting nodes at an index equal to the current vertical scroll position. For example, deleting the last node of a Tree if it contains enough children to display a scrollbar, causes problems withFlash Player.
  • If a Tree has showRoot=false and its contents are dragged out, then back in, the Tree structure will be flattened due to nodes not being re-appended to the root
  • Attempting to drag a node above the top-most node of a Tree with scrolling doesn't register drop position until move mouse cursor when reach desired drop location
  • Calling getChildren() on a tree's data descriptor resets the tree's selectedIndex to -1.
  • The allowMultipleSelection property has been disabled. The code compiles, but you cannot select multiple items.
  • Dragging from the bottom-most position of a tree with a scroll bar to another tree can cause problems with Flash Player.


  • The preloader will not display a background image that has been embedded by using @Embed. Only images that are loaded at run time are supported.
  • Using a relative path to set source of an Image, SWFLoader or Video doesn't show the resource.
  • Playing a video with no source attached generates a Runtime Exception.
  • Line endings in fdb use DOS carriage return/line feeds. To run fdb on Macintosh OS X, you must convert UNIX-style the line endings. To do this, use the dos2unix utility, as the following example shows:
dos2unix -o fdb 

Alternatively, you can use the following command and regularexpression:

cat fdb | tr -d '\r' > fdb 
  • The TextArea control uses UNIX-style line endings, which means that text data containing Windows-style carriage-return line-feed (that is, \r\n) formatting for new lines contain extra line breaks. You can use String.replace() with a regular expression to convert the text to UNIX-style line endings, as the following example shows:
private static const windowsCRLF:RegExp = /\r\n/gm; 


myTextString = myTextString.replace(windowsCRLF, "\n"); 

Documentation known issues

  • Incorrect locale - Some discussions in the usage documentation refer to a locale of en_EN. However, the correct locale is en_US.
  • themeColor - The Flex documentation describes a themeColor attribute for the mx:Application tag. However, this attribute is not supported by mx:Application.

Late-breaking news

Flex Charting 2

Flex Charting 2 lets you add data visualization components to any Flex application and is fully integrated into the Flex framework's general infrastructure for effects, styles, data binding, and drag and drop.

Flex Builder 2 and Flex Data Services 2 include trial versions of Flex Charting 2.

This discussion includes the following sections:

For instructions on installing Flex Charting 2, see the Flex 2 Installation Instructions.

What's new

The following list describes some of the major new features and changes for Flex Charting 2. For more information on new features, see the Flex Developer Center.

  • Complete control - Customize applications with total control over colors, fonts, and label styles through CSS.
  • Built-in support for data binding and data access - Flex Charting is fully integrated with the general infrastructure for effects, styles, data binding, and drag and drop in Adobe Flex, and works seamlessly with Flex Data Services.
  • Candlestick and Hi/Low/Open/Close charts - Flex 2 includes two new chart controls that represent financial data with the high, low, opening, and closing values of a data series.
  • Multiple axes - Charts can now show data along multiple axes, so that more than one data set can be shown on its own scale in the same chart.
  • Easier customization - With a redesigned API and support for renderers, you can write your own custom classes with Flex Charting much easier than before. If you purchase a license for Flex Charting 2, you can view the source code.
  • Date/Time axis - Lets you map time-based values, such as hours, days, weeks, or years, along a chart axis.
  • Logarithmic axis - Lets you map values to the axis logarithmically rather than linearly. Great for when the data in your chart has such a wide range that clusters of data points are lost to scale.
  • Exploding pie charts - You can explode wedges of a pie chart control, both uniformly and on a per-wedge basis.
  • Other improvements:

    • Improved stacking and clustering of data with bar, column, and area series.
    • You can now display multiple data tips at one time.

Compatibility issues

Flex Charting 2 is a major upgrade from Flex 1.5 and you must migrate Flex 1.5 applications before compiling them under Flex 2. For more information, see Migrating Applications to Flex 2.

Known issues

  • Charting uninstall - The Flex Charting uninstaller on Linux and Solaris does not remove the files. To uninstall Flex Charting on these platforms. manually remove the following files from the install root:

    • frameworks/libs/charts.swc
    • frameworks/locale /
    • frameworks/locale /charts_rb.swc
    • lib /charting-source.jar
    • samples /dashboard/ (all files in this directory)
    • samples/explorer/charts/ (all files in this directory)
    • readme_charting.htm
    • license_charting.htm

Getting Started


Application Development








Community Resources