Specifications

319ADOBE FLEX 3

Building and Deploying Adobe Flex 3 Applications

Adding features to the wrapper

The default wrapper that Flex Builder creates includes deep linking and support for Express Install. The Browser-

Manager lets users navigate through a Flex application using the web browser’s Back and Forward buttons.

Express Install detects if the client has the required version of Flash Player to run the application and installs a

newer player on the client if necessary.

Each of these features requires additional files to be deployed with your application, as described here. For

additional information on implementing these features, see “Deep Linking” on page 1065 in Adobe Flex 3

Developer Guide and “Using Express Install” on page 333.

Before adding additional functionality to your custom wrapper, you should understand the issues described in

“Customizing the wrapper” on page 319.

A simple application uses only the main wrapper plus a JavaScript file that embeds the Flex application’s SWF file.

Customizing the wrapper

Use the following guidelines when you create a custom wrapper.

• You can use the HTML templates in the /templates directory as guides to adding new features to the wrapper.

For information about the templates, see

“About the HTML templates” on page 312.

• You must embed the SWF file and not the MXML file. Set the value of the src property of the <object> tag

mxml_filename.mxml.swf if you use the web-tier compiler. If you use the command-line compiler or Flex

Builder, set the value of the

src property to mxml_filename.swf.

The following example defines the src property of the <object> tag for an MXML application called

MyApp.mxml:

The <embed> tag uses the src property to define the source of the SWF file:

src='MyApp.mxml.swf'

• Do not include periods or other special characters in the id and name properties of the <object> and

nalInterface API. This API lets Flex communicate with the wrapper, and vice versa. For more information about

using the ExternalInterface API, see

“Communicating with the Wrapper” on page 1035 in Adobe Flex 3 Developer

Guide.