除錯桌上型 AIR 應用程式

如果使用 Flash Builder、Flash Professional 或 Dreamweaver 等 IDE 開發應用程式,通常有內建的除錯工具。您可以在除錯模式中啟動應用程式,便能為應用程式除錯。如果不是使用直接支援除錯的 IDE,則可使用 AIR Debug Launcher (ADL) 與 Flash Debugger (FDB) 來協助除錯應用程式。

使用 ADL 執行應用程式

您可以使用 ADL,毋須封裝與安裝 AIR 應用程式,便能執行 AIR 應用程式。如下列範例所示,將應用程式描述器檔案作為參數傳送至 ADL (應用程式的 ActionScript 程式碼必須先編譯):

adl myApplication-app.xml

ADL 列印追蹤陳述式、執行階段例外與 HTML 剖析錯誤至終端機視窗。如果 FDB 處理程序正在等待內送連線,ADL 將連線至除錯程式。

您也可使用 ADL 來為使用原生擴充功能的 AIR 應用程式除錯。例如:

adl -extdir extensionDirs myApplication-app.xml

列印追蹤陳述式

若要將追蹤陳述式列印至用於執行 ADL 的主控台,請使用 trace() 函數將追蹤陳述式加入程式碼中。

備註: 如果您的 trace() 陳述式未顯示在主控台上,請確定您尚未在 mm.cfg 檔案中指定 ErrorReportingEnable TraceOutputFileEnable 。如需有關這個檔案之平台特定位置的詳細資訊,請參閱 編輯 mm.cfg 檔案

ActionScript 範例:

//ActionScript 
trace("debug message"); 

JavaScript 範例:

//JavaScript 
air.trace("debug message");
在 JavaScript 程式碼,您可以使用 alert() confirm() 函數顯示應用程式的除錯訊息。此外,語法有錯誤的行號和未捕捉的 JavaScript 例外也都會列印至主控台。
備註: 若要使用 JavaScript 範例顯示的 air 前置詞,您必須將 AIRAliases.js 檔案匯入頁面中。這個檔案位於 AIR SDK 架構目錄內。

連接至 Flash 除錯程式 (FDB)

若要使用 Flash 除錯程式來除錯 AIR 應用程式,請啟動 FDB 工作階段,然後使用 ADL 來啟動應用程式。

備註: 在 SWF 類型的 AIR 應用程式中,ActionScript 原始檔案必須使用 -debug 旗標進行編譯。(在 Flash Professional,請勾選「發佈設定」對話方塊中的「允許除錯」選項)。
  1. 啟動 FDB。您可以在 Flex SDK 資料夾的 bin 目錄中找到 FDB 程式。

    主控台會顯示 FDB 提示: <fdb>

  2. 執行 run 命令: <fdb>run [Enter]

  3. 在不同的命令或殼層主控台中,啟動應用程式的除錯版本:

    adl myApp.xml
  4. 使用 FDB 命令設定所需的中斷點。

  5. 輸入: continue [Enter]

如果 AIR 應用程式屬於 SWF 類型,除錯程式就只會控制 ActionScript 程式碼的執行,而如果屬於 HTML 類型,除錯程式就只會控制 JavaScript 程式碼的執行。

若要在不連接除錯程式的情況下執行 ADL,請納入 -nodebug 選項:

adl myApp.xml -nodebug

如需有關 FDB 命令的基本資訊,請執行 help 命令:

<fdb>help [Enter]

如需有關 FDB 命令的詳細資訊,請參閱 Flex 文件中的 使用除錯程式的命令列命令