在 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.aspackage  {  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>

命令列中傳遞Null 字元串，使用雙引號包圍的單引號，如下：

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

在設定檔傳遞Null 字元串，用雙引號（“”）或單引號（''）即可 。