Specifications

CHAPTER 10
200
The type of caching used by an RSL is based on the type of RSL. Standard or cross-domain RSLs are stored in the
browser’s cache. If the user clears their cache, the RSLs are removed and must be downloaded again the next time
they are needed. Unsigned framework RSLs are also stored in the browser’s cache.
Signed framework RSLs are stored in the Player cache. This is a special cache that is maintained by Flash Player.
To clear this cache, clients must invoke the Settings Manager. RSLs stored in this cache are signed and therefore
can be used by any Flex application without the need for a cross-domain policy file.
For more information about the framework cache, see “About the Player cache” on page 218.
Creating libraries
To use standard or cross-domain RSLs, you must first create the library that will be used as an RSL. If you want to
use framework RSLs, the libraries are already created for you. In that case, all you need to do is compile against
them and then deploy the SWZ or SWF file with your Flex application.
A standard or cross-domain RSL is a library of custom components, classes, and other assets that you create. You
can create a library using either Flex Builder or the compc command-line compiler. A library is a SWC file or open
directory that contains a library.swf file and a catalog.xml file, as well as properties files and other embedded
assets. You can use any library as an RSL, but libraries do not need to be used as RSLs.
Creating libraries in Flex Builder
In Flex Builder, you create a new library by selecting File > New > Flex Library Project. You add resources to a
library by using the Flex Library Build Path dialog box. When you select Build Library or Build All, Flex Builder
creates a SWC file. This SWC file contains the library.swf file.
Creating libraries on the command line
On the command line, you create a library by using the compc compiler. You add files to a library by using the
include-classes and include-namespaces options when you compile the SWC file.
The following command-line example creates a library called CustomCellRenderer.swc with the compc compiler:
compc -source-path ../mycomponents/components/local
-include-classes CustomCellRendererComponent
-directory=true
-debug=false
-output ../libraries/CustomCellRenderer