You can use the target-player compiler option to specify the version of Flash Player that you want to target with the application. Features requiring a later version of Flash Player are not compiled into the application. Currently, this feature applies only to RSLs.

The command has the following syntax:

-target-player=player_version

The player_version parameter has the following format:

major_version.minor_version.revision

The major_version is required while minor_version and revision are optional. The minimum value is 9.0.0. If you do not specify the minor_version or revision, the compiler uses zero.

If you do not explicitly set the value of this option, the compiler uses the default from the flex-config.xml file. This option is commented out in the default flex-config.xml configuration file.

This option is used with framework RSLs. It helps ensure that an application is compiled correctly. For example, if you specify that your application should use a signed RSL but you do not specify a failover RSL, users of older versions of Flash Player will not load a signed framework RSL and will therefore experience errors when they try to run your application. If you don't set the target-player option or set it to some value less than 9.0.115, the compiler throws a warning. You must be sure that your users request your application only with a recent version of Flash Player. One way to do this is to include logic in your HTML wrapper that specifies a minimum required version of Flash Player. For more information, see Adding the Express Install script to the wrapper.

If you do not specify a failover RSL, but set the target-player option to some value greater than or equal to 9.0.115, the compiler will not throw a warning because players later than that version will load a signed framework RSL and therefore do not generally need a failover RSL.