Specifications

CHAPTER 10
218
The following example shows the configuration file that loads a framework RSL:
<runtime-shared-library-path>
<path-element>libs/framework.swc</path-element>
<rsl-url>framework_3.0.${build.number}.swz</rsl-url>
<policy-file-url></policy-file-url>
<rsl-url>framework_3.0.${build.number}.swf</rsl-url>
</runtime-shared-library-path>
The configuration file uses a {build.number} token in the name of the RSLs. The compiler replaces this with a
build number during compilation. The name of the framework RSL depends on the build number of Flex that you
are using.
You can specify a signed SWZ file as the framework RSL and not specify an unsigned SWF file as a failover RSL.
In this case, the application will not work in any Flash Player of version earlier than 9.0.115. The compiler will
throw a warning, though, unless you set the
target-player compiler option to 9.0.115 or later. This instructs
the compiler to ignore the fact that there is no failover that will work with older Players. You can detect and
upgrade users to the newest Player in the HTML wrapper by using the Express Install feature. For more infor-
mation, see “Using Express Install” on page 333.
When you deploy your application, you must be sure to deploy the SWZ file to the location you specified on the
command line. You must also be sure that the crossdomain.xml file is in place at the RSL’s domain. To ensure that
your Flex application can support older versions of Flash Player, you should also deploy the unsigned framework
RSL SWF file (in addition to the signed SWZ file), and specify that file as a failover RSL.
About the Player cache
The Player cache stores signed RSLs, such as the framework RSLs. You can manage the settings of the Player cache
with the Settings Manager. The use of the RSLs in the Player cache is secure; no third party can inject code that
will be executed. Only Adobe can sign RSLs; therefore, only Adobe RSLs can be stored in the Player cache.
The default size of the framework cache is 20MB. When the aggregate size of the cached RSLs in this directory
meets or exceeds 20MB, Flash Player purges the cache. Files are purged on a least-recently-used basis. Less-used
files are purged before files that have been used more recently. Purging continues until the cache size is below 60%
of the maximum size. By default, this is 12MB.
The Global Storage Settings panel in the Settings Manager lets the user turn off the caching feature and increase
or decrease its size. The Settings Manager is a special control panel that runs on your local computer but is
displayed within and accessed from the Adobe website. If the user disables the Player cache, then Flash Player will
not load SWZ files. Flash Player will load failover RSLs instead.