Specifications

CHAPTER 10
210
Compile with standard or cross-domain RSLs on the command line
To use standard or cross-domain RSLs in your application on the command line, you use the runtime-shared-
library-path
application compiler option. This option has the following syntax:
-runtime-shared-library-path=path-element,rsl-url[,policy-file-url,failover-url,...]
The following table describes the runtime-shared-library-path arguments:
Argument Description
path-element
Specifies the location of the SWC file or open directory to compile against. For example, c:\flexsdk\frame-
works\libs\framework.swc. The compiler provides compile-time link checking by using the library specified
by this option.
This argument is required.
rsl-url
Specifies the location of the RSL SWF file that will be loaded by the application at run time. The compiler
does not verify the existence of the SWF file at this location at compile time. It does store this string in the
application, however, and uses it at run time. As a result, the SWF file must be available at run time but not
necessarily at compile time. You specify the location of the SWF file relative to the deployment location of
the application. For example, if you store the library.swf file in the web_root/libraries directory on the web
server, and the application in the web root, you specify libraries/library.swf for the RSL SWF file.
This argument is required.
You must know the deployment location of the RSL SWF file relative to the application when you compile
it. You do not have to know the deployment structure when you create the library SWC file, though, because
components and classes are compiled into a SWC file and can be used by any application at compile time.
The value of the rsl-url argument can be a relative URL, such as “../libraries/library.swf”, or an absolute
URL, such as “http://www.mydomain.com/libraries/library.swf”. If it is on a different server, it must be a cross-
domain or framework RSL. Standard RSLs can only be loaded from the same domain as the application.
The default name of the RSL SWF file is library.swf, but you can change it to any name you want after you
extract it from the SWC file. If you change it, then you must change the name you specify in the
rsl-url
option.