使用 Flex 库项目

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

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

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

   项目位置?

   默认位置为当前的工作空间。在 Windows 平台上，默认工作空间位置为 C:Documents and Settings usernameAdobe 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。

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

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

2. 指定项目名称。

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

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

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

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

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

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

要选择准备包括在 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 文件的内容存储到该目录中。

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

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