使用 Flex 库项目---打包swc

可以通过以下方式在项目中使用 SWC 库：

合并到应用程序中

 

在将 SWC 文件添加到项目的库路径后，即可在应用程序中使用库中包含的组件。构建应用程序时，只有实际使用的库组件才会编译成应用程序 SWF 文件。换句话说，所有应用程序代码都将合并到一个 SWF 文件中。这是使用库组件的最常见且最直接的方式。

位于应用程序的外部

 

可以将库组件与已编译的 SWF 文件分开，以避免将这些组件合并到该文件中。编译器将解析应用程序使用的库中包含的所有代码，但不会将这些代码合并到应用程序 SWF 文件中。此方法的优点是可以使应用程序 SWF 文件变得更小。在运行时，系统将根据需要检索 SWC 文件中包含的组件，并将其加载到内存中。

运行时共享库

 

在且只在 Flex 项目中，还可以将 SWC 文件用作运行时共享库 (RSL)，该库类似于其它平台上的动态链接库。如果您具有由多个应用程序使用的组件的集合，则可将 SWC 文件用作 RSL。 

使用 RSL 在多个应用程序之间共享组件具有多个优点。首先，库在内存中加载一次，即进行缓存，之后使用那些组件的所有应用程序都可以使用该库。其次，库中包含的组件仅在需要时才会加载，这样可以减少应用程序的启动时间，因为每个应用程序的大小都较小。此方法的潜在问题是会将整个 RSL 加载到内存中，而不是加载应用程序所使用的各个组件。有关何时将 SWC 文件用作 RSL 的更多信息，请参阅运行时共享库。

创建库项目时，“新建 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。

要为多个 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 文件中还是放置在应用程序外部并在运行时单独访问。