使用 Flex 库项目

创建 Flex 库项目

在 Flash Builder 中创建 SWC 文件的第一步是创建一个 Flex 库项目。创建库项目之后，添加组件，指定要包括在 SWC 文件中的库项目元素，然后构建项目以生成 SWC 文件。

1. 选择“文件”>“新建”>“Flex 库项目”。

2. 输入项目名称，然后指定以下内容：

   项目位置 

   默认位置为当前的工作空间。在 Windows 平台上，默认工作空间位置为 C:\Documents and Settings\ username\Adobe Flash Builder\。在 Macintosh 平台上，默认工作空间位置为 /Users/ username/Adobe Flash Builder/ 。取消选择“使用默认位置”选项后，可以选择其它项目位置。

   配置 

   可以指定 Flex 库项目是使用通用库还是使用移动设备库。通用库适用于 Web、桌面和移动设备项目。

   也可以指定 Flex 库项目是否必须与 Flash Catalyst 兼容。在这种情况下，请使用通用库。对于与 Flash Catalyst 兼容的项目，不支持移动设备库。

   Flex SDK 版本 

   选择“默认”或“特定”。还可以单击“配置 SDK”链接，在“首选参数”主页面上添加、编辑或删除 SDK。

   包括 Adobe AIR 库 

   如果您的库必须使用 AIR 功能（例如访问 AIR API），请选择此选项。然后，Flash Builder 会更改该新 Flex 库项目的库路径，使该路径包括 airglobal.swc 和 airframework.swc。基于 Web 的 Flex 项目不能使用该库。

   如果要编写的通用库仅用于基于 Web 的应用程序或者用于基于 Web 或 AIR 的应用程序，请不要选择此选项。

3. 单击“下一步”。

4. （可选）设置构建路径信息。例如，可以将文件夹添加到包含要包括在 SWC 文件中的组件的项目源路径中。还可以添加要包括在库项目中的其它项目、文件夹或库 SWC 文件。请参阅在项目中使用 SWC 文件。

5. 输入完项目设置后，单击“完成”。

 有关创建 Flex 库的最佳实践，请参阅由 Adobe Flex 社区专家 Xavi Beumala 撰写的文章 Three points to remember when creating a library。

创建 AIR 库项目

要为多个 Adobe AIR 项目创建 AIR 代码库，请使用标准的 Flex 库项目向导创建 Adobe AIR 库项目。

1. 选择“文件”>“新建”>“Flex 库项目”。

2. 指定项目名称。

3. 选择“包括 Adobe AIR 库”，然后单击“下一步”。

4. 根据需要修改构建路径，然后单击“完成”。有关创建库项目的更多信息，请参阅“Flash Builder 帮助”中的“关于库项目”。

将组件添加到库项目中

可以通过以下方式将组件添加到库项目中：

• 将新的或现有的自定义组件、ActionScript 类和其它资源添加到项目中。

• 链接到工作空间内的其它项目中的现有组件。（请参阅链接到项目工作空间外部的资源。）

• 将包含组件的已链接文件夹添加到库项目的源路径。（请参阅将外部资源文件夹添加到源路径。）

注： 库项目中包括的所有组件都必须与库项目相关联（直接关联或作为链接资源关联）。

选择要包括在 SWC 文件中的库项目元素

要选择准备包括在 SWC 中的元素（组件和资源），请执行以下步骤：

1. 选择“项目”>“属性”>“Flex 库构建路径”。

   此时，添加到项目中的组件（直接添加或通过链接到这些组件来添加）会显示在“类”选项卡中。

2. 选择要包括在 SWC 文件中的组件类。

3. （可选）选择“资源”选项卡，然后选择要包括在 SWC 文件中的资源。

4. 进行选择之后，单击“确定”。

构建库项目

如果选择了“自动构建”选项，则选择了要包括在 SWC 文件中的元素之后，系统将立即对该文件进行编译，并将结果文件生成到项目的输出文件夹中。如果您手动构建项目，则可以在需要时通过选择“项目”>“构建项目”或“全部构建”来构建库项目。

构建库项目会生成一个 SWC 文件，您可以与其它应用程序或用户共享该文件。

SWC 文件是一个归档文件，可以使用任何归档实用程序（如 WinZip）打开 SWC 文件。SWC 文件中包括 library.swf 和 catalog.xml 文件。此外，还包括属性文件和其它嵌入式资源。

可以将库导出为开放目录而非 SWC 文件。通常，如果计划将 SWC 文件中的 library.swf 文件用作 RSL，则需要将库导出为开放目录。

通过设置 directory 和 output 编译器选项可以完成此工作。将 output 选项设置为要创建的目录的名称，并将 directory 选项设置为 true，说明您在构建库时需要开放目录而非 SWC 文件。要编辑这些编译器选项，请选择“项目”>“属性”>“Flex 库编译器”，并在“附加的编译器参数”字段中添加这些选项；例如：

-directory=true -output=myOpenDir 

Flash Builder 将在项目中创建一个名为 myOpenDir 的目录，并将 SWC 文件的内容存储到该目录中。

在项目中使用 SWC 文件

要在 Flex 项目中使用 SWC 文件，需要将这些文件添加到项目的库路径中。SWC 文件可以位于项目中、Flex 库项目中、工作空间内的共享文件夹或已链接到项目（例如，使用已添加到项目的源路径的共享文件夹）的任何其它位置中。

在应用程序中使用 SWC 文件时，可以通过配置选项来确定是将这些文件静态或动态链接到应用程序、合并到应用程序 SWF 文件中还是放置在应用程序外部并在运行时单独访问。

将 SWC 文件添加到库路径

1. 在包资源管理器中选择一个项目，然后选择“项目”>“属性”>“Flex 构建路径”。

2. 单击“库路径”选项卡。

3. 选择下列任意选项以添加 SWC 文件：

   添加项目 

   添加 Flex 库项目。

   添加 SWC 文件夹 

   添加包含 SWC 文件的文件夹。

   添加 SWC 

   添加已编译的 SWC 文件。

   添加 Flex SDK 

   添加其它 Flex SDK。如果项目的库路径中已包含 Flex SDK，则系统会禁用此按钮。如果从库路径中删除了现有 Flex SDK，则系统会启用此按钮。单击此按钮后，系统将添加一个 Flex SDK 节点，但不会提示您添加的是哪个节点。要控制将使用哪个 Flex SDK，请选择“项目”>“属性”>“Flex 编译器”。

4. 输入或浏览并选择 SWC 文件、项目或文件夹的位置。单击“确定”。

   此时，SWC 文件、库项目或文件夹将添加到库路径中。

编译时将 SWC 文件合并到应用程序 SWF 文件中

1. 在包资源管理器中选择一个项目，然后选择“项目”>“属性”>“Flex 构建路径”。

2. 单击“库路径”选项卡，然后选择并展开 SWC 文件条目以显示 SWC 选项。

3. 双击“链接类型”选项。此时，将显示“库路径项选项”对话框。

4. 选择“合并到代码中”选项，然后单击“确定”。

此过程等效于使用 library-path 编译器选项。

将 SWC 文件设置为外部库文件

1. 在包资源管理器中选择一个项目，然后选择“项目”>“属性”>“Flex 构建路径”。

2. 选择“库路径”选项卡，然后选择并展开 SWC 文件条目以显示 SWC 选项。

3. 双击“链接类型”选项。此时，将显示“库路径项选项”对话框。

4. 选择“外部”选项，然后单击“确定”。

此过程等效于使用 external-library-path 编译器选项。

将 SWC 文件用作 RSL

可以将应用程序的 SWF 文件中的共享资源外部化到独立文件中。这些独立文件可以在客户端上单独进行下载和缓存。共享资源只可传送并加载到客户端一次，但任意多个应用程序在运行时都可以使用这些共享资源。这些共享文件称为运行时共享库（即 RSL）。

1. 在包资源管理器中选择一个项目，然后选择“项目”>“属性”>“Flex 构建路径”。

2. 选择“库路径”选项卡，然后选择并展开 SWC 文件条目以显示 SWC 选项。

3. 双击“链接类型”选项，或者单击“编辑”。此时，将显示“库路径项选项”对话框。

4. 将“运行时共享库 (RSL)”选为链接类型。

5. 您可以添加 URL 以指定部署应用程序时驻留 SWC 库的位置。如有必要，也可以编辑现有 URL。

6. 选择“强制加载 RSL”以在编译时强制加载未使用的 RSL。

7. 您可以指定应用程序域，在该域中必须加载跨域 RSL。

将 SWC 文件用作 RSL 可简化手动使用 RSL 的过程。为此，可以从 SWC 文件中提取 SWF 文件，然后设置 runtime-shared-library-path 编译器选项的值。