在 Adobe Flex 3 中使用条件编译

赖勇浩（http://laiyonghao.com ）译

原文地址： http://bit.ly/3UpSWP

我初接触的时候，还以为 Flex 3 不支持条件编译，后来找了好些文档来看，也没有看明白，直到找到这篇文章的 livedocs 文档才明白原来是这么回事。好文档嘛，就想译出来给大家看看咯，虽然一如既往地半生熟地译法，看在我的热情上，大家就少骂哈……

———————————————–

在编译应用时传递常量给mxmlc编译器就能够使用条件编译——在构建时包含或排除的某些代码块。 最常见的是通过一个布尔值来包含或排除一段调试或检测代码。 如下面的例子就是一段使用内置布尔常量实现条件化的代码：

CONFIG::debugging{
 //执行调试代码。

}

这样就能够使用compiler.define 编译选项了。  常量可以是一个布尔、字符串、或数值、或表达式（在编译时对 ActionScript 求值）。  这种常量可以在应用的源代码中作为一个全局常量访问。

使用define 选项，可以为常量定义一个命名空间，相应的变量名和数值使用下面的语法：

-define = namespace::variable_name,value

命名空间可以任意配置。  下面的例子在CONFIG名字空间里定义了常量debugging ，它的值为true ： 

-define=CONFIG::debugging,true

在命令行设置多个常量的值，可以多次使用 define 选项;例如：

mxmlc -define=CONFIG::debugging,true -define=CONFIG::release,false MyApp.mxml

也可以在 flex-config.xml 文件中设置这些常量，而不是在命令行，下面是例子说明：

<compiler>
 <define>
 <name>CONFIG::debugging</name>
 <value>true</value>
 </define>
 <define>
 <name>CONFIG::release</name>
 <value>false</value>
 </define>
</compiler>

Flex Ant 任务中，也可以用一个define 元素来定义常量，如下：

<mxmlc ... >
 <define name="CONFIG::debugging" value="true"/>
 <define name="CONFIG::release" value="false"/>
</mxmlc>

使用内置常量

可以 ActionScript 代码中使用内置常量。 布尔值可以用来条件化顶层函数定义、类和变量，与 C/C++ 上使用#IFDEF 预处理指令的方式大致相同， 但不能使用布尔常量条件化元数据或import 语句。

下面是条件化类的定义，在编译器编译应用程序时决定使用哪个类定义：

// compilers/MyButton.as
package {
 import mx.controls.Button;
 CONFIG::debugging
 public class MyButton extends Button {
 public function MyButton() {
 super();
 // Set the label text to blue.
 setStyle("color", 0x0000FF);
 }
 }
 CONFIG::release
 public class MyButton extends Button {
 public function MyButton() {
 super();
 // Set the label text to red.
 setStyle("color", 0xFF0000);
 }
 }
}

也可以传递字符串和数值到应用中去，把它们当作内置常量来使用，就像在 C/C++ 中使用#define 宏指令一样。  例如，传递一个名为NAMES::Company 的值，能够替代如下的 ActionScript 语句来定义常量：

private static const companyName:String = NAMES::Company;

可以传递表达式，它将在编译时求值。 下面的例子计算为false ：

-define+=CONFIG::myConst,"1 > 2"

下面的例子值为3 ：

-define+=CONFIG::myConst,"4 - 1"

表达式可包含常量和其他设定值，例如：

-define+=CONFIG::bool2,false -define+=CONFIG::and1,"CONFIG::bool2 && false"

一般来说，应该为常数加上双引号，以确保mxmlc编译器正确地将它们作为一个单独的参数。

传递字符串

当传递字符串，您必须使用双引号，编译器才能够正确地处理它们。

在命令行定义字符串，则必须使用用双引号，对于原来就需要的双引号，需要转义（”/”Adobe Systems/”" 或 “/’Adobe Systems/’”）或改用单引号（”‘Adobe Systems’”） 。

下面的例子是在命令行传递字符串两种方法：

-define+=NAMES::Company,"'Adobe Systems'" -define+=NAMES::Ticker,"/"ADBE/""

定义配置文件中的字符串，你也需要使用单或双引号，例如：

<define>
 <name>NAMES::Company</name>
 <value>'Adobe Systems'</value>
</define>
<define>
 <name>NAMES::Ticker</name>
 <value>"ADBE"</value>
</define>

命令行中传递空字符串，使用双引号包围的单引号，如下：

-define+=CONFIG::debugging,"''" 

在配置文件传递空字符串，用双引号（“” ）或单引号（''）即可 。