記錄與偵錯可以分成 " 在程序中加上除錯訊息 " ,與 " 在偵錯環境中查看除錯訊息 " 兩部分。
在程序中加上除錯訊息:
程序幾乎行行都可以出錯。要看程序中的哪一部分可能會出錯,實在是門很深的學問。除了程序代碼語法格式上的問題,絕大部分會造成大麻煩的,是隱藏在程序邏輯中的問題。這些問題只有在模擬器甚至在實際機器上運行時才會出現。為了解決這些問題,我們需要一些協助工具。在 Android 平臺上,我們可以透過 "Log" 函數,來達到自行在程序代碼中加入一個個自訂的 " 記錄點 " 或 " 檢查點 " 。并可以透過開發環境中的 "LogCat" 工具來查看記錄。當程序流程每次運作到 " 記錄點 " 時,相應的 " 記錄點 " 就會在開發工具記錄中輸出一筆偵錯用的訊息。開發者透過這份記錄,來檢查程序執行的過程、使用到的參數,是否與我們期望的結果符合。并依此來辨別程序代碼中可能出錯的區域,好能對癥根治造成問題的程序代碼。
導入 Log 函數:
打開 "Bmi.java" 文件,我們在程序中加入一些除錯訊息。一段含有記錄點 (Log) 的程序代碼片段如下
import android.util.Log
....
public class Bmi extends Activity {
private static final String TAG = "Bmi";
....
Log.d(TAG, "find Views");
Log.d(TAG, "set Listensers");
....
分析:
就像許多人在學生時代 k 書時,會在課本上使用不同顏色作記號。用不同顏色的色筆,來代表各段課文不同的重要性或是意義。 "Log" 函數的作用,就像是色筆一樣,協助我們在程序代碼中 " 作記號 " ,這些數位記號,會在稍后就介紹到的 "LogCat" 工具中顯示。
Log 的使用格式如下:
Log. 代號 ( 標簽 , 訊息 );
代號:依據訊息的類型,我們有五種 Log 訊息形式可以用作記錄。
1. Log.v (VERBOSE) 詳細訊息
2. Log.d (DEBUG) 除錯訊息
3. Log.i (INFO) 通知訊息
4. Log.w (WARN) 警告訊息
5. Log.e (ERROR) 錯誤訊息
一般較常用的是 Log.d( 除錯訊息 ) 、 Log.w ( 警告訊息 ) ,和 Log.e ( 錯誤訊息 ) 。范例中多使用 Log.d( 除錯訊息 ) 。
private static final String TAG = "Bmi";
....
Log.d(TAG, "find Views");
Log.(v,d,i,w,e) 的第一個參數,是一個自定的記錄標簽。在目前的 BMI 應用程序范例中,我們還看不太出來自定記錄標簽的意義。但是當程序的功能一擴張的時候(例如像在AppDemos 范例那樣,包含各種不同功能),我們可以為不同的功能,給予不同的紀錄標簽。
在 Log.(v,d,i,w,e) 的第二個參數中,加入我們想要記錄的資訊。
實際應用:
在 BMI 應用程序中,我們可以在用來處理輸入錯誤的 "try...catch" 語句中加入 "Log" 訊息,好讓我們得以從記錄資料中,追蹤到輸入錯誤的情況。
public class Bmi extends Activity {
private static final String TAG = "Bmi";
....
catch(Exception err){
Log.e(TAG, "error: " + err.toString());
Toast.makeText(Bmi.this, getString(R.string.input_error),
Toast.LENGTH_SHORT).show();
}
}
延伸運用:
在實作錯誤訊息提示前,我們其實可以使用 Log.e 函數,來先將錯誤訊息記錄起來,等到整個程序大致完成了,再來用 Toast 或 AlertDialog 元件,來實作輸入錯誤提示的功能 。
在偵錯環境中查看除錯訊息:
在程序中加上除錯訊息后,我們可以使用除錯模式 (Debug Mode) 運行模擬器,并透過開發工具來查看除錯訊息。切換到 "Debug" 環境配置,可以看到右下角 的 "LogCat" 視窗。其上有五個醒目的V 、D 、I 、W 、E 圖示,分別代表著五種 Log 形式 (Verbose, Debug, Info, Warn, Error) ,還有一個綠色的 "+" 號,與一個紅色的 "-" 號。模擬器運行時會產生很多的訊息記錄 (Log) ,一不注意就看到眼花了。這時候,我們自訂的記錄標簽(范例中自訂的標簽是 "Bmi" )就派上了用場,正好可以為 LogCat 加上一個過濾器 (Log Filter) ,只顯示與 "Bmi" 標簽相關的訊息記錄。
加入訊息記錄過濾器 (Log Filter):
在 "LogCat" 視窗右側,按下綠色的 "+" 號,會彈出一個 "Log Filter" 視窗。在 "Log Filter"視窗的 "by Log Tag" 欄位中填入 "Bmi" ,并填入任意的 "Filter Name" 后,按下 "ok" 按鈕。"LogCat" 視窗上會多出一個與我們填入的 "Filter Name" 相同的標簽。里面的內容,即所有標示為 "Bmi" 的自訂訊息記錄。