Adobe Flex 3 Help

Setting project properties

Project text encoding properties

Use the Info properties page to specify Flex, ActionScript, and Flex Library project text encoding properties.

Specify text encoding properties

  1. In the Flex Navigator view, select a project.
  2. Right-click (Control-click on Mac OS) to display the context menu and select Properties > Resource.
  3. Specify the following properties:

    Text File Encoding Sets the default text file encoding. You can select the file encoding of the application container (UTF-8) or other text encoding formats such as ASCII and UTF-16.

    New Text File Line Delimiter Sets the text file line delimiter, which can be inherited from the application container or by the selected type of operating system.

  4. Click OK.

Project compiler properties

Use the Compiler properties page to modify how Flex, ActionScript, and Flex Library projects are built.

Set project compiler properties

  1. In the Flex Navigator view, select a project.
  2. Right-click (Control-click on Mac OS) to display the context menu and select Properties > (Flex, ActionScript, or Flex Library) Compiler.
  3. You can set the following compiler properties:

    Copy Non-Embedded Files To Output Folder Copies all project assets (images for example) that are part of but not embedded into the SWF file into the output folder. For example, an image file that is embedded into the SWF file (<image source="@Embed('filename')"/>) is not copied to the output folder; it is compiled into the SWF file.

    Generate Accessible SWF File Enables accessibility features when compiling the application. For more information about creating accessible applications, see Creating Accessible Applications in the Adobe Flex 3 Developer Guide.

    Enable Strict Type Checking (-strict) Specifies that projects are compiled in strict mode. This option enforces typing and reports run-time verifier errors when projects are compiled. All errors appear in the Problems view. For more information about strict typing errors, see Viewing errors and warnings in Building and Deploying Adobe Flex 3 Applications.

    Enable Warnings (-warnings) Specifies that ActionScript projects are compiled in Warnings mode, which generates migration warnings. These include ActionScript syntax anomalies, obsolete or removed ActionScript 2.0 APIs, and differences in the behavior of ActionScript 2.0 and 3.0 APIs. Warnings appear in the Problems view. For more information about debugging your applications, see Running and Debugging Applications in Using Adobe Flex Builder 3. For more information about warnings, see Viewing errors and warnings in Building and Deploying Adobe Flex 3 Applications.

    Namespace URL and Manifest File (Flex Library projects only) You can create a custom namespace for the components contained within a library project by specifying a namespace URL and a manifest file. For more information, see Using compc, the component compiler in Building and Deploying Adobe Flex 3 Applications.

    Additional Compiler Arguments Allows you to add optional compiler arguments. For more information about using compiler arguments, see Using the Flex Compilers in Building and Deploying Adobe Flex 3 Applications.

Run-time web browser properties

For Flex and ActionScript projects, you can also set the following run-time web browser properties:

Generate HTML Wrapper File Automatically generates the HTML wrapper file when the project is compiled and places it in a folder called html-template within your project.

Require Flash Version Checks to see if the user has the specified version of Flash Player installed and if not prompts the user to install it.

Use Express Install Prompts the user to install the correct version of Flash Player using Express Install, which is a streamlined (quicker and easier) version of the Flash Player installer.

Enable Integration With Browser Navigation Enables your application to use the web browser's back button.

Modify the compiler properties as needed, and click OK.

Setting project application file properties

Use the Applications properties page to specify the Flex and ActionScript project files that should be compiled as applications. Flex

Set applications properties

  1. In the Flex Navigator view, select a project.
  2. Right-click (Control-click on Mac OS) to display the context menu and select Properties > Flex Applications (or ActionScript Applications).
  3. You can set the following compiler properties:

    Select the Runnable Application Files Selects the list of project files that have been set as runnable files.

    Add Allows you to select project files set as runnable application files (compiled as separate SWF files).

    Remove Removes the selected file from the list of runnable application files.

    Set as Default Sets the selected application files as the default (main) application file in your project.

  4. Modify the list of application files as needed, and click OK.

Flex and ActionScript project build path properties

Use the Build Path properties page to specify Flex and ActionScript project build path properties. For information about setting build path properties for Flex Library projects, see Flex library project build path properties.

Specify build path properties

  1. In the Flex Navigator view, select a project.
  2. Right-click (Control-click on Macintosh) to display the context menu and select Properties > (Flex or ActionScriptActionScript) Build Path.
  3. Specify the following properties:

    Source path Specifies the link to external resources to your application. For example, if you have a folder of shared ActionScript classes, you can link to that folder by adding it to the source path. You can also edit a folder's path, remove the folder from the source path, and arrange the order of the folders using the Up and Down buttons.

    Library path Specifies the link to external resource libraries (SWC files). By default, the library path of new ActionScript projects contains the playerglobal.swc and utilities.swc files. You can link library projects, SWC folders, and compiled SWCs to the library path. You can also edit the path entry, remove the entry from the library path, and arrange the order of the folders using the Up and Down buttons.

    Main source folder Specifies by default the root of your project. You can, however, choose a different folder within the project. You can browse the project folder structure and create a folder for the source if needed. (Optional)

    Output folder Specifies the location of the compiled application files. By default, this is named bin but you can change this if you like. For more information, see Setting up a project output folder.

    Output folder URL Specifies the server location of the compiled application files. (Optional)

  4. Click OK.

Flex library project build path properties

Use the Flex Library Build Path properties page to specify Flex Library project build path properties.

Specify build path properties

  1. In the Flex Navigator view, select a project.
  2. Right-click (Control-click on Macintosh) to display the context menu and select Properties > Flex Library Build Path.
  3. Specify the following properties:

    Classes Tab lists the classes that can be included in the SWC file. The classes that are listed are added directly to the project or linked to it using a folder in the source path. For more information, see Selecting library project elements to include in the SWC file.

    Resources Tab lists all the resources in the project. You can select the resources to include in the SWC file.

    Source Path Tab lets you add and manage folders in the source path. Components contained in folders on the source path can be selected as component classes to include in the SWC file.

    Library Path Tab lets you add other SWC files to the project. You can add other projects to the library path and modify library settings to use your library project as an RSL, and so on. For more information, see Using SWC files in your projects.

    You can also set the following properties:

    Main Source Folder Specifies the location of the project source files. By default, the project source files are located in the root of the project. You can specify a different location (folder) in the project.

    Output Folder Specifies the location of the compiled SWC file. By default, this is named bin but you can change this if you like. For more information, see Setting up a project output folder.

  4. Click OK.

Flex server properties

Use the Flex Server properties page to specify server properties for Flex projects that use either the ColdFusion Flash Remoting Service or LiveCycle Data Services ES.

Specify server properties

  1. In the Flex Navigator view, select a project.
  2. Right-click (Control-click on Mac OS) to display the context menu and select Properties > Flex Server.
  3. Specify the following properties:

    Root folder Specifies the root folder of the Flex web application (for example, C:\fds2\jrun4\servers\default\flex).

    Root URL Specifies the URL of the Flex web application root (for example, http://localhost:8700/flex/).

    Context root Specifies the context root of the Flex server. Typically, this is same as the last portion of the server URL (for example, flex).

  4. Click OK.

Project builder properties

Use the Builder properties page to configure the builders that will be used to compile your projects. For more information, see Customizing builds with Apache Ant.

Access project builder properties

  1. In the Flex Navigator view, select a project.
  2. Right-click (Control-click on Mac OS) to display the context menu and select Properties > Builders.

Project references

Use the Project References properties page to create references to other projects in the workspace. For more information, see Alternatives to using project references.

  1. In the Flex Navigator view, select a project.
  2. Right-click (Control-click on Mac OS) to display the context menu and select Properties > Project References.