Specifications

312
CHAPTER 16
Adobe® Flex® Builder™and the Flex module for Apache and IIS generate a wrapper that embeds your Flex appli-
cation. The Flex Builder wrapper include support for Express Install and deep linking by default, although you
can disable these features or configure them to your specifications. Deep linking lets users navigate the history of
their interactions within the Flex application using the browser’s Forward and Back buttons, and it lets users read
and write to the browser’s address bar. Express Install ensures that your users have a good upgrade experience if
their Players require an update. The wrapper created by the Flex module for Apache and IIS does not support
Express Install or deep linking.
The mxmlc command-line compiler does not generate a wrapper. You must write it manually using the instruc-
tions in “Creating a simple wrapper” on page 315. You can start out with a simple wrapper that just embeds your
Flex application. You can then add deep linking and Express Install support to your wrapper.
About the Flex Builder wrapper
To view the wrapper generated by Flex Builder, run the current project. Flex Builder generates an HTML page in
the same directory as the project’s root MXML file. This directory also includes the supporting files such as the
history.css, history.js, historyFrame.html, and AC_OETags.js files.
You can configure the wrapper by using the Flex Compiler properties dialog box in Flex Builder. Configuration
settings include:
• Enable or disable wrapper generation
• Set the minimum required version of Flash Player
• Use Express Install
• Enable deep linking and history management support
For more information, see the Flex Builder documentation.
About the HTML templates
Flex SDK includes a set of HTML templates in the flex_install_dir/templates directory. For Flex Builder, these files
are located in the install_dir/sdks/3.0.0/templates directory. These templates provide a basic wrapper, as well as
wrappers that implement various features. The following table describes the templates:
Directory Description
client-side-detection Provides scripts that detect the version of the client’s player and return alternate content if
the client’s player does not meet the minimum required version.
client-side-detection-with-history Provides the same scripts as those in the client-side-detection directory, but adds deep
linking support.
express-installation Provides scripts that support Express Install, which includes client-side version detection.