赖勇浩（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,"''" 

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