用 IBM Lotus Expeditor 進行遠端除錯

概述

本文講解在物理 Windows Mobile 5.0 裝置和模擬器上進行啟動和除錯所需的步驟。如果操作目標是物理裝置而不是模擬器，那麼可以跳過本文的 Windows Mobile 5.0 模擬器設定部分。本文描述以下任務：

• 使用工具箱的配置嚮導為以裝置為目標的應用程式配置 IDE
• 將示例 eRCP 應用程式匯入工作空間
• 設定 Windows Mobile 5.0 模擬器或裝置
• 在裝置或模擬器上安裝 Lotus Expeditor Client for Devices
• 將除錯工具複製到裝置或模擬器中
• 建立一個 Expeditor on Device 除錯配置並啟動 。

• 使用 Lotus Expeditor Toolkit 中的配置嚮導配置 IDE

  在基於 Eclipse 的開發環境中安裝 Lotus Expeditor Toolkit 並重新啟動 IDE 之後，就會出現一個 Lotus Expeditor Toolkit Configuration 對話方塊。這個配置對話方塊在一個下拉選單中顯示可配置的測試環境。執行以下操作：

  1. 在測試環境列表中，選擇 “Lotus Expeditor for Device”。對話方塊中的其他欄位會根據選擇的測試環境而改變。
  2. 單擊 OK。

  配置對話方塊中的值為 IDE 配置適當的 JRE、有效級別和目標平臺（見圖 1）。

  
  圖 1. 選擇 Lotus Expeditor for Device 之後的配置對話方塊
  
  

  也可以通過選擇 Window - Preferences - Client Services - Configure 來開啟這個 Lotus Expeditor Toolkit Configuration 對話方塊。

• 將示例 eRCP 電子郵件應用程式匯入工作空間

  下一步是匯入 eRCP 電子郵件示例。這個示例是一個嵌入式 Rich Client Platform（eRCP）應用程式，是 Lotus Expeditor Toolkit 中附帶的。將這個示例匯入工作空間的步驟如下：

  1. 選擇 File - Import。
  2. 在 Import 嚮導中，選擇 General，然後選擇 “Existing Projects into Workspace”。單擊 Next。
  3. 選擇 Select Archive file 選項。
  4. 使用 Browse 按鈕瀏覽到外掛目錄；在外掛目錄 com.ibm.rcp.tools.device.samplegallery 下面，選擇 archive 目錄中的 ercpapp.jar 檔案。
  5. Import 嚮導會在 Projects 列表中顯示這個存檔 JAR 檔案中的專案。單擊 Finish。

  現在已經匯入了這個專案。可以在程式碼中設定斷點。例如，在 org.eclipse.ercp.app.views.NormalView 類的 enableLaunchCommand 方法的第一行上設定一個斷點。

• 設定 Windows Mobile 5.0 模擬器或裝置

  如果目標是一個 Windows Mobile 5.0 物理裝置，那麼需要將裝置連線到 PC ，讓 ActiveSync 能夠識別這個裝置並與它進行正確地通訊。如果使用 Windows Mobile 5.0 模擬器，那麼需要配置 ActiveSync 來連線模擬器，然後使用 Microsoft Device Emulator Manager 啟動並連線模擬器，讓 ActiveSync 將模擬器作為一個裝置進行通訊。

  ActiveSync 需要使用 DMA 傳輸特性連線模擬器，所以需??在 ActiveSync 中設定 DMA 連線。步驟如下：

  1. 在 ActiveSync 中，選擇 File - Connection Settings。
  2. 在 Connection Settings 對話方塊中，選擇 “Allow connections to one of the following” 選項，然後在圖 2 所示的下拉選單框中選擇 DMA。
  3. 單擊 OK。

  
  圖 2. 選擇 DMA 之後的 ActiveSync Connection Settings 對話方塊
  
  

  ActiveSync 現在可以與模擬器通訊了。需要使用 Microsoft Device Emulator Manager 啟動並連線模擬器。步驟如下：

  1. 啟動 Microsoft Device Emulator Manager。
  2. 在對話方塊顯示的模擬器列表中選擇 Windows Mobile 5.0 Pocket PC Emulator。
  3. 右鍵單擊，然後在出現的選單中選擇 Connect。

  這會啟動一個 Windows Mobile 5.0 模擬器，見圖 3。也可以單獨啟動 Windows Mobile 5.0 模擬器。如果在 Microsoft Device Emulator Manager 之外單獨啟動了模擬器，那麼需要單擊 Microsoft Device Emulator Manager 中的 Refresh 按鈕。

  
  圖 3. Windows Mobile 5.0 模擬器
  
  

  在 Device Emulator Manager 視窗中的模擬器列表中，當前執行的模擬器前面顯示一個綠色的箭頭。綠色箭頭表示這個模擬器正在執行，但是還沒有連線。

  連線模擬器的步驟如下：

  1. 在 Device Emulator Manager 視窗中的列表中，選擇帶綠色箭頭的模擬器。
  2. 右鍵單擊，然後在上下文選單中選擇 Cradle。

  ActiveSync 現在顯示它已經連線到這個模擬器，見圖 4。Windows Mobile 5.0 模擬器現在已經連線了，ActiveSync 可以看到它。

  
  圖 4. 連線之後的 Device Emulator Manager
   
  

  在裝置或模擬器上安裝 Lotus Expeditor 客戶機

  無論是使用 Windows Mobile 5.0 裝置還是模擬器，都需要通過 ActiveSync 在裝置或模擬器上安裝 Lotus Expeditor 客戶機。可以執行 Lotus Expeditor 客戶機光碟上 device\install\wm 目錄中的 Expeditor-wm-setup.exe 安裝程式。安裝程式在裝置或模擬器上執行復制和安裝。按照螢幕上的提示完成 Lotus Expeditor 客戶機的安裝。

• 將除錯工具複製到裝置或模擬器中

  為了進行除錯，在裝置或模擬器上安裝的 Lotus Expeditor 客戶機需要 JRE 的除錯版。可以在 Lotus Expeditor 客戶機光碟上找到 JRE 的除錯版；需要將它複製到裝置上。步驟如下：

  1. 在 ActiveSync 中，開啟 Explorer 並瀏覽到 \eclipse\plugins\com.ibm.pvc.wece.device.win32.arm_6.1.2.0-(date}\jre\bin。
  2. 將現有的 j9.exe 改名為 j9.bak。
  3. 將 Lotus Expeditor 客戶機光碟的 utils\jclDevice\wm 目錄中的 j9dbg_wm.exe 複製到裝置上的 \eclipse\plugins\com.ibm.pvc.wece.device.win32.arm_6.1.2.0-{date}\jre\bin 目錄。
  4. 在裝置上將 j9dbg_wm.exe 改名為 j9.exe

• 建立一個 Expeditor on Device 配置並啟動

  現在可以通過一個 Expeditor on Device 配置在工作空間中啟動 eRCP 電子郵件示例應用程式。建立這個配置並啟動的步驟如下：

  1. 選擇 Run - Debug 開啟圖 5 所示的 Debug Configuration 嚮導。
  2. 雙擊 Expeditor on Device。
  3. 將新配置的名稱改為 ERCP_Sample。
  4. 在 Java Application 附籤中，單擊 Project 欄位中的 Browse 按鈕並選擇 org.eclipse.ercp.app。
  5. 在 Device 欄位中，從下拉選單選擇 PocketPC。已經預設設定了 Debug 連線屬性，不需要改動。
  6. 單擊 Debug。
  
  圖 5. 完成設定之後的 Expeditor on Device 除錯配置
  
  

  在裝置或模擬器上啟動 eWorkbench 和 eRCP 電子郵件示例，見圖 6。

  
  圖 6. 在 Windows Mobile 5.0 模擬器上執行的示例應用程式
  
  

  這個應用程式顯示電子郵件的列表。選擇第一行並在 Command 選單中選擇 View the message。IDE 會提示切換到 Debug 透檢視；切換到透檢視之後，執行過程會在前面設定的斷點處停止（見圖 7）。

  
  圖 7. 執行過程在示例程式碼中設定的斷點處停止
  
  

  與除錯其他應用程式時一樣，這時可以檢查變數的值。單擊 Resume 按鈕繼續執行，應用程式會針對選擇的電子郵件顯示一個簡單的測試訊息。

• 結束語

  Lotus Expeditor 提供了開發託管客戶機應用程式所需的工具，這些應用程式可以在 PocketPC（Windows Mobile 5.0 和 Windows Mobile 2003 平臺）和 Nokia E90 等裝置上執行。在本文中，通過使用 Lotus Expeditor Toolkit 提供的一個示例應用程式，學習瞭如何針對 Windows Mobile 5.0 平臺設定環境並除錯應用程式。

來自 “ ITPUB部落格 ” ，連結：http://blog.itpub.net/14751907/viewspace-580648/，如需轉載，請註明出處，否則將追究法律責任。