Copyright 2007 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. 版 權 所 有 Sun Microsystems, Inc. 對 本 文 件 所 述 產 品 所 採 用

Transcription

1 使 用 者 指 南 Sun Java TM Wireless Toolkit for CLDC 版 Sun Microsystems, Inc. $$$v 年 9 月

2 Copyright 2007 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. 版 權 所 有 Sun Microsystems, Inc. 對 本 文 件 所 述 產 品 所 採 用 的 技 術 擁 有 相 關 智 慧 財 產 權 特 別 是 ( 但 不 僅 限 於 ), 這 些 智 慧 財 產 權 可 能 包 含 一 項 或 多 項 在 上 列 出 的 美 國 專 利, 以 及 一 項 或 多 項 美 國 及 其 他 國 家 / 地 區 的 其 他 專 利 或 申 請 中 專 利 美 國 政 府 權 利 商 業 軟 體 政 府 使 用 者 均 應 遵 守 Sun Microsystems, Inc. 的 標 準 授 權 合 約 和 FAR 及 其 增 補 文 件 中 的 適 用 條 款 使 用 應 遵 守 授 權 合 約 的 條 款 本 發 行 物 可 能 包 含 由 協 力 廠 商 開 發 的 材 料 Sun Sun Microsystems Sun 標 誌 Java Javadoc Java Community Process JCP JDK JRE J2ME 與 J2SE 是 Sun Microsystems, Inc. 在 美 國 及 其 他 國 家 / 地 區 的 商 標 或 註 冊 商 標 OpenGL 是 Silicon Graphics, Inc. 的 註 冊 商 標 本 服 務 手 冊 所 涵 蓋 的 產 品 和 包 含 的 資 訊 受 到 美 國 出 口 控 制 法 規 的 控 制, 並 可 能 受 到 其 他 國 家 / 地 區 進 出 口 法 規 的 管 轄 嚴 禁 將 本 產 品 直 接 或 間 接 地 用 於 核 武 器 飛 彈 生 化 武 器 或 海 上 核 動 力 裝 備, 也 不 得 將 本 產 品 直 接 或 間 接 地 提 供 給 核 武 器 飛 彈 生 化 武 器 或 海 上 核 動 力 裝 備 的 一 般 使 用 者 嚴 禁 將 本 產 品 出 口 或 再 出 口 至 美 國 禁 運 的 國 家 / 地 區 或 美 國 出 口 排 除 清 單 中 包 含 的 實 體 ( 包 括 但 不 僅 限 於 被 拒 的 個 人 和 特 別 指 定 的 國 家 / 地 區 的 公 民 清 單 ) 本 文 件 以 其 原 狀 提 供, 對 任 何 明 示 或 暗 示 的 條 件 陳 述 或 擔 保, 包 括 對 適 銷 性 特 殊 用 途 的 適 用 性 或 非 侵 權 性 的 暗 示 保 證, 均 不 承 擔 任 何 責 任, 除 非 此 免 責 聲 明 的 適 用 範 圍 在 法 律 上 無 效

3 目 錄 前 言 xiii 1. 簡 介 關 於 多 重 使 用 者 環 境 安 裝 目 錄 與 工 作 目 錄 工 作 目 錄 檔 案 快 速 入 門 工 具 組 元 件 工 具 組 功 能 工 具 組 更 新 支 援 的 技 術 開 發 MIDlet 套 裝 軟 體 關 於 專 案 簡 單 的 開 發 周 期 編 輯 原 始 碼 生 成 執 行 2 6 iii

4 2.3 完 整 的 開 發 周 期 封 裝 安 裝 執 行 從 MIDlet 套 裝 軟 體 建 立 專 案 使 用 混 淆 器 安 裝 ProGuard 使 用 ProGuard 使 用 除 錯 程 式 在 Web 伺 服 器 上 部 署 應 用 程 式 使 用 專 案 選 取 API 變 更 MIDlet 套 件 屬 性 處 理 MIDlet 使 用 推 送 註 冊 表 設 定 內 容 處 理 器 專 案 目 錄 結 構 使 用 第 三 方 程 式 庫 使 用 外 部 API 一 個 專 案 的 第 三 方 程 式 庫 所 有 專 案 的 第 三 方 程 式 庫 配 置 Wireless Toolkit 變 更 主 控 台 字 型 設 定 應 用 程 式 目 錄 設 定 javac 編 碼 特 性 使 用 修 正 控 制 系 統 3 14 iv Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

5 4. 使 用 模 擬 器 模 擬 器 面 板 模 擬 器 控 制 設 定 模 擬 器 偏 好 網 路 代 理 伺 服 器 儲 存 容 量 大 小 永 久 性 儲 存 裝 置 堆 疊 大 小 調 整 模 擬 器 效 能 暫 停 與 繼 續 單 獨 執 行 模 擬 器 使 用 第 三 方 模 擬 器 監 視 應 用 程 式 使 用 效 能 評 測 器 調 用 圖 執 行 時 間 與 呼 叫 次 數 儲 存 與 載 入 效 能 評 測 器 資 訊 使 用 記 憶 體 監 視 器 儲 存 與 載 入 記 憶 體 監 視 器 資 訊 使 用 網 路 監 視 器 篩 選 訊 息 排 序 訊 息 儲 存 與 載 入 網 路 監 視 器 資 訊 清 除 訊 息 樹 狀 結 構 5 9 目 錄 v

6 6. 安 全 性 與 MIDlet 簽 署 權 限 選 取 安 全 性 策 略 MSA 保 護 網 域 Java for the Wireless Toolkit Industry 保 護 網 域 簽 署 MIDlet 套 件 管 理 金 鑰 建 立 新 的 金 鑰 組 獲 取 真 實 金 鑰 匯 入 現 有 的 金 鑰 組 移 除 金 鑰 組 管 理 憑 證 啟 用 和 停 用 憑 證 匯 入 憑 證 移 除 憑 證 支 援 USB 加 密 碟 安 裝 USB 加 密 碟 驅 動 程 式 使 用 USB 加 密 碟 使 用 Wireless Messaging API 設 定 模 擬 器 的 電 話 號 碼 模 擬 不 可 靠 的 網 路 使 用 WMA 主 控 台 傳 送 訊 息 傳 送 文 字 的 SMS 訊 息 傳 送 二 進 位 SMS 訊 息 傳 送 文 字 或 二 進 位 CBS 訊 息 傳 送 MMS 訊 息 在 WMA 主 控 台 中 接 收 訊 息 與 WMA 一 起 使 用 網 路 監 視 器 7 8 vi Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

7 8. 使 用 Mobile Media API 支 援 的 格 式 與 協 定 Adaptive Multi-Rate (AMR) 內 容 Windows Linux 啟 用 AMR 支 援 AMR 格 式 支 援 使 用 MediaControlSkin 媒 體 擷 取 正 常 MIDlet 鈴 聲 下 載 鈴 聲 鈴 聲 格 式 使 用 Mobile Graphics 使 用 Mobile 3D Graphics API 立 即 模 式 保 留 模 式 品 質 與 速 度 之 間 的 取 捨 建 立 Mobile 3D Graphics 內 容 描 繪 可 縮 放 式 向 量 圖 形 內 容 OpenGL ES 簡 介 使 用 PIM 與 FileConnection API FileConnection API PIM API 使 用 藍 芽 與 OBEX API 藍 芽 模 擬 環 境 透 過 紅 外 線 使 用 OBEX 11 1 目 錄 vii

8 11.3 設 定 OBEX 與 藍 芽 偏 好 OBEX 偏 好 藍 芽 內 部 特 性 藍 芽 系 統 特 性 藍 芽 BCC 特 性 使 用 Web 服 務 使 用 位 置 API 在 執 行 階 段 設 定 模 擬 器 的 位 置 配 置 位 置 提 供 者 設 定 地 標 使 用 SATSA 模 擬 器 中 的 卡 片 槽 使 用 Java Card 平 台 模 擬 器 使 用 具 有 SATSA 的 網 路 監 視 器 調 整 存 取 控 制 指 定 PIN 特 性 指 定 應 用 程 式 權 限 存 取 控 制 檔 範 例 使 用 SIP 瞭 解 代 理 登 錄 和 代 理 伺 服 器 SIP 設 定 網 路 監 視 器 中 的 SIP 流 量 SIP 代 理 伺 服 器 和 代 理 登 錄 15 4 viii Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

9 16. 使 用 Payment API 支 付 款 項 的 專 案 設 定 直 接 編 輯 支 付 款 項 屬 性 支 付 款 項 偏 好 檢 視 作 業 事 件 歷 程 監 視 支 付 款 項 使 用 Mobile Internationalization API 設 定 模 擬 器 的 語 言 環 境 檢 視 應 用 程 式 資 源 使 用 語 言 環 境 使 用 資 源 檔 案 使 用 資 源 17 3 A. 應 用 程 式 示 範 A 1 A.1 簡 介 A 1 A.2 一 般 指 示 A 3 A.3 Advanced Multimedia Supplements A 4 A.4 藍 芽 示 範 A 5 A.5 CHAPIDemo A 7 A.6 CityGuide A 10 A.7 示 範 A 13 A.7.1 色 彩 A 13 A.7.2 特 性 A 13 A.7.3 Http A 14 A.7.4 FontTestlet A 14 目 錄 ix

10 A.7.5 股 票 A 15 A 使 用 設 定 A 15 A 股 票 追 蹤 器 A 15 A What If? A 16 A 警 報 A 16 A.7.6 購 票 A 16 A.7.7 ManyBalls A 17 A.8 Demo3D A 17 A.8.1 Life3D A 17 A.8.2 PogoRoo A 19 A.8.3 retainedmode A 19 A.9 GoSIP A 20 A.10 i18ndemo A 22 A.11 JBricks A 25 A.12 JSR172Demo A 28 A.13 MobileMediaAPI A 28 A.13.1 Simple Tones A 29 A.13.2 Simple Player A 29 A.13.3 Video A 31 A.13.4 暫 停 音 效 測 試 A 31 A.13.5 MobileMediaAPI 的 屬 性 A 32 A.14 網 路 示 範 A 32 A.14.1 Socket Demo A 32 A.14.2 Datagram Demo A 34 A.15 ObexDemo A 35 A.16 PDAPDemo A 36 A.16.1 瀏 覽 檔 案 A 36 A.16.2 PIM API A 38 x Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

11 A.17 SATSADemos A 40 A.17.1 APDUMIDlet A 41 A.17.2 SATMIDlet A 41 A.17.3 CryptoMIDlet A 41 A.17.4 MohairMIDlet A 42 A.18 SATSAJCRMIDemo A 42 A.19 SIPDemo A 43 A.20 SVGContactList A 43 A.21 SVGDemo A 45 A.21.1 SVG 瀏 覽 器 A 45 A.21.2 描 繪 SVG 影 像 A 45 A.21.3 播 放 SVG 動 畫 A 45 A.21.4 從 頭 開 始 建 立 SVG 影 像 A 46 A.21.5 跳 跳 球 A 46 A.21.6 最 佳 化 的 功 能 表 A 46 A.21.7 照 片 裝 飾 程 式 A 47 A.21.8 定 位 服 務 A 49 A.22 WMADemo A 49 B. 指 令 行 參 考 B 1 B.1 先 決 條 件 B 1 B.2 開 發 周 期 B 1 B.2.1 生 成 B 2 B.2.2 封 裝 B 3 B.2.3 執 行 B 4 B.2.4 除 錯 B 5 B.3 啟 動 工 具 組 GUI 元 件 B 6 B.4 設 定 模 擬 器 偏 好 B 6 目 錄 xi

12 B.5 使 用 安 全 功 能 B 8 B.5.1 變 更 模 擬 器 的 預 設 保 護 網 域 B 9 B.5.2 簽 署 MIDlet 套 裝 軟 體 B 9 B.5.3 管 理 憑 證 B 10 B.6 使 用 Stub 產 生 器 B 11 B.6.1 選 項 B 11 C. 本 土 化 C 1 C.1 語 言 環 境 設 定 C 1 C.2 模 擬 語 言 環 境 C 2 C.3 字 元 編 碼 C 2 C.4 Java 技 術 編 譯 器 編 碼 設 定 C 2 C.5 預 設 模 擬 器 的 字 型 支 援 C 3 索 引 索 引 1 xii Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

13 前 言 本 文 件 描 述 了 如 何 使 用 Sun Java Wireless Toolkit for CLDC 本 書 適 用 對 象 本 指 南 的 目 標 使 用 者 是 使 用 Sun Java TM Wireless Toolkit for CLDC 建 立 Mobile Information Device Profile (MIDP) 應 用 程 式 的 開 發 人 員 本 書 不 是 MIDP 程 式 設 計 的 教 學 課 程, 也 不 是 工 具 組 所 支 援 任 何 額 外 API 的 程 式 設 計 教 學 課 程 您 應 該 已 經 瞭 解 如 何 使 用 Mobile Information Device Profile (MIDP) 與 Connected Limited Device Configuration (CLDC) 如 需 Java 程 式 設 計 語 言 入 門 方 面 的 說 明, 請 嘗 試 New to Java Center : 若 要 MIDP 程 式 設 計 的 快 速 入 門, 請 閱 讀 Learning Path: Getting Started with MIDP 2.0 : 相 關 文 件 本 小 節 列 出 了 相 關 的 Java Platform, Micro Edition (Java ME) 規 格 您 在 某 些 規 格 名 稱 中 可 看 到 Java ME 先 前 稱 為 Java 2 Platform, Micro Edition ( 或 J2ME ) 雖 然 規 格 是 重 要 的 資 訊, 但 有 時 不 易 取 得 如 需 各 種 針 對 開 發 人 員 撰 寫 的 文 章, 請 嘗 試 Sun 的 Mobility 網 站 : xiii

14 表 格 P-1 相 關 文 件 主 題 標 題 自 訂 Sun Java TM Wireless Toolkit for CLDC Sun Java TM Wireless Toolkit for CLDC 基 本 自 訂 指 南 版 本 說 明 Sun Java TM Wireless Toolkit for CLDC 版 本 說 明 CLDC JSR 30 J2ME Connected Limited Device Configuration MIDP JSR 37 Mobile Information Device Profile for the J2ME Platform PDAP Optional Packages - JSR 75 PDA Optional Packages for the J2ME Platform 藍 芽 與 OBEX - JSR 82 Java APIs for Bluetooth MIDP JSR 118 Mobile Information Device Profile 2.0 ( 最 終 發 行 版 本 2 稱 為 MIDP 2.1) CLDC JSR 139 J2ME Connected Limited Device Configuration MMAPI - JSR 135 J2ME Web Services - JSR 172 SATSA - JSR 177 Location API - JSR 179 SIP API - JSR 180 Mobile 3D Graphics - JSR 184 JTWI - JSR 185 WMA JSR 205 CHAPI JSR 211 SVG API - JSR 226 Payment API - JSR 229 Advanced Multimedia - JSR 234 Mobile Internationalization - JSR 238 Java Binding for OpenGL ES API - JSR 239 Mobile Service Architecture- JSR 248 Mobile Media API J2ME Web Services Specification Security and Trust Services APIs for J2ME Location API for J2ME SIP API for J2ME Mobile 3D Graphics API for J2ME Java Technology for the Wireless Industry Wireless Messaging API (WMA) Content Handler API Scalable 2D Vector Graphics API for J2ME Payment API Advanced Multimedia Supplements Mobile Internationalization API Java Binding for OpenGL ES API Mobile Service Architecture xiv Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

15 本 書 架 構 本 指 南 包 括 以 下 各 章 及 附 錄 : 第 1 章 介 紹 Sun Java TM Wireless Toolkit for CLDC 及 其 提 供 的 開 發 功 能 第 2 章 描 述 建 立 與 執 行 MIDlet 的 開 發 過 程 第 3 章 說 明 如 何 使 用 工 具 組 中 的 專 案 您 將 學 習 如 何 調 整 專 案 特 性 操 作 MIDlet 使 用 推 送 註 冊 表 以 及 瞭 解 專 案 目 錄 結 構 第 4 章 描 述 模 擬 器, 並 說 明 如 何 調 整 其 選 項, 及 利 用 其 許 多 功 能 第 5 章 示 範 如 何 使 用 效 能 評 測 器 記 憶 體 監 視 器 與 網 路 監 視 器, 檢 查 應 用 程 式 的 效 能 第 6 章 描 述 如 何 簽 署 MIDlet 套 件, 及 管 理 金 鑰 與 憑 證 第 7 章 詳 述 執 行 與 測 試 無 線 訊 息 傳 送 應 用 程 式 的 支 援 第 8 章 說 明 Sun Java TM Wireless Toolkit for CLDC 如 何 支 援 Mobile Media API 第 9 章 包 含 開 發 3D 圖 形 內 容 的 相 關 資 訊 第 10 章 描 述 工 具 組 如 何 實 作 存 取 本 機 檔 案 與 個 人 資 訊, 例 如 連 絡 人 與 行 事 曆 約 會 第 11 章 涵 蓋 工 具 組 的 藍 芽 與 OBEX 模 擬 環 境 第 12 章 示 範 如 何 使 用 Web 服 務 Stub 產 生 器 第 13 章 描 述 了 如 何 使 用 模 擬 器 的 位 置 功 能 第 14 章 將 討 論 工 具 組 對 SATSA 的 支 援 第 15 章 涵 蓋 工 具 組 的 SIP 支 援 第 16 章 描 述 了 工 具 組 的 Payment API 功 能 第 17 章 說 明 了 如 何 管 理 用 於 Mobile Internationalization API 的 資 源 附 錄 A 描 述 Sun Java TM Wireless Toolkit for CLDC 隨 附 的 應 用 程 式 示 範 附 錄 B 說 明 如 何 從 指 令 行 使 用 Sun Java TM Wireless Toolkit for CLDC 的 功 能 附 錄 C 描 述 Sun Java TM Wireless Toolkit for CLDC 中 的 本 土 化 功 能 前 言 xv

16 印 刷 排 版 慣 例 表 格 P-2 描 述 本 文 件 中 的 字 型 使 用 方 式 表 格 P-2 印 刷 排 版 慣 例 字 體 意 義 範 例 AaBbCc123 ( 固 定 間 距 ) AaBbCc123 ( 固 定 間 距 粗 體 ) API 和 語 言 元 素 HTML 標 記 網 站 URL 指 令 名 稱 檔 案 名 稱 目 錄 路 徑 名 稱 螢 幕 畫 面 輸 出 範 例 代 碼 您 鍵 入 的 內 容, 與 螢 幕 畫 面 輸 出 相 對 編 輯 您 的.login 檔 案 使 用 ls -a 列 出 所 有 檔 案 % You have mail % su Password: AaBbCc123 ( 斜 體 ) AaBbCc123 指 令 或 路 徑 名 稱 中 要 由 真 實 名 稱 或 值 替 代 的 預 留 位 置 新 的 字 彙 或 術 語 要 強 調 的 詞 該 檔 案 位 於 install-dir/bin 目 錄 中 這 些 稱 為 類 別 選 項 請 勿 儲 存 此 檔 案 AaBbCc123 用 於 書 名 及 章 節 名 稱 請 閱 讀 使 用 者 指 南 中 的 第 6 章 {AaBbCc.dir} 可 變 的 檔 案 名 稱 與 目 錄 在 書 中,toolkit 固 定 指 Sun Java TM Wireless Toolkit for CLDC 的 安 裝 目 錄 存 取 Sun 線 上 文 件 下 列 網 站 提 供 有 關 Java 技 術 的 技 術 性 文 件 : 我 們 歡 迎 您 提 出 寶 貴 意 見 我 們 致 力 於 提 高 文 件 品 質 您 可 以 透 過 developers.sun.com 電 子 郵 件 提 供 意 見 回 饋 xvi Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

17 第 1 章 簡 介 本 書 介 紹 如 何 使 用 Sun Java TM Wireless Toolkit for CLDC Sun Java TM Wireless Toolkit for CLDC 這 套 工 具 可 供 研 發 人 員 為 行 動 電 話 與 其 他 無 線 裝 置 開 發 應 用 程 式 雖 然 Sun Java TM Wireless Toolkit for CLDC 以 Mobile Information Device Profile (MIDP) 2.1 為 基 礎, 但 是 它 還 支 援 許 多 選 擇 性 套 裝 軟 體, 因 此 是 一 個 功 能 頗 為 廣 泛 的 開 發 工 具 組 1.1 關 於 多 重 使 用 者 環 境 Sun Java Wireless Toolkit for CLDC 可 安 裝 在 執 行 Windows 或 Linux 的 受 支 援 版 本 的 系 統 上 所 有 在 主 機 上 具 有 帳 號 的 使 用 者 均 可 存 取 該 工 具 組, 既 可 單 獨 存 取, 也 可 多 個 同 時 存 取 安 裝 目 錄 與 工 作 目 錄 Windows 路 徑 中 包 含 磁 碟 機 字 母, 並 使 用 反 斜 線 作 為 目 錄 分 隔 符 號 Linux 路 徑 使 用 正 斜 線 在 Linux 路 徑 中,~ 表 示 Linux 使 用 者 的 主 目 錄 為 支 援 多 個 使 用 者, 工 具 組 會 建 立 一 個 安 裝 目 錄, 當 作 複 製 的 來 源 使 用 本 文 件 使 用 變 數 workdir 來 表 示 工 具 組 工 作 目 錄, 並 使 用 toolkit 來 表 示 安 裝 目 錄 各 使 用 者 的 個 人 檔 案 儲 存 於 名 為 j2mewtk 的 獨 立 工 作 目 錄 中, 對 於 安 裝 的 各 版 本, 該 目 錄 下 均 包 含 一 個 相 應 的 子 目 錄 workdir 的 預 設 位 置 通 常 為 以 下 位 置 之 一 : Windows: C:\Documents and Settings\User\j2mewtk\2.5.2 ( 其 中 User 為 您 的 帳 號 名 稱 ) Linux: ~/j2mewtk/2.5.2 ( 其 中 ~ 為 您 的 主 目 錄 ) 1-1

18 文 件 中 說 明 了 Windows 與 Linux 之 間 的 顯 著 差 異 如 果 僅 提 及 一 個 作 業 系 統, 則 您 可 以 假 定 上 述 路 徑 差 異 是 適 用 的 工 作 目 錄 檔 案 安 裝 時, 安 裝 程 式 會 將 這 些 檔 案 的 子 集 從 安 裝 目 錄 複 製 到 每 個 使 用 者 的 工 作 目 錄 工 作 目 錄 內 容 如 下 :.settings - 最 初 包 含 security.properties appdb - 將 整 個 應 用 程 式 資 料 庫 複 製 到 您 的 工 作 目 錄 apps - apps 目 錄 在 您 的 工 作 目 錄 建 立 時 為 空 白 如 果 您 開 啟 一 個 示 範 專 案, 則 會 將 其 自 動 複 製 到 該 位 置 當 您 建 立 新 專 案 時 ( 第 2-1 頁 的 第 2.1 節 關 於 專 案 ), 會 將 該 專 案 儲 存 於 此 wtklib - 包 含 模 擬 器 特 性 檔 ( 請 參 閱 第 4 章 ) 以 及 HTTP 與 WMA 伺 服 器 與 用 戶 端 的 狀 態 資 訊 sessions - 此 為 監 視 工 具 的 預 設 儲 存 目 標 ( 請 參 閱 第 5 章 ) 最 初 為 空 白 示 範 應 用 程 式 的 所 有 原 始 碼 均 可 在 toolkit\apps 中 找 到, 每 個 示 範 均 有 其 自 己 的 專 案 目 錄 所 有 使 用 者 都 可 看 到 放 置 於 toolkit\apps 中 的 所 有 應 用 程 式 例 如 在 Windows 中,MobileMediaAPI 示 範 的 原 始 碼 存 放 在 toolkit\apps\ MobileMediaAPI\src 中 使 用 [ 開 啟 專 案 ] 指 令 時, 您 可 以 看 到 安 裝 目 錄 與 工 作 目 錄 中 的 專 案 ( 如 果 存 在 ) 如 圖 1-1 中 所 示, 本 機 目 錄 中 的 專 案 以 粗 體 字 型 顯 示, 安 裝 目 錄 中 的 專 案 以 斜 體 字 型 顯 示 若 要 僅 顯 示 本 機 檔 案, 請 清 除 [ 顯 示 可 用 示 範 ] 核 取 方 塊 1-2 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

19 圖 1-1 專 案 清 單 以 粗 體 顯 示 本 機 專 案 當 您 從 安 裝 目 錄 開 啟 專 案 時, 會 將 應 用 程 式 副 本 匯 入 至 workdir\apps 通 常, 您 察 覺 不 到 匯 入 程 序, 但 是 在 較 慢 的 電 腦 上 您 可 能 看 到 如 圖 1-2 所 示 的 進 度 對 話 方 塊 任 何 自 訂 都 應 針 對 您 的 本 機 副 本 進 行 第 1 章 簡 介 1-3

20 圖 1-2 從 toolkit 匯 入 專 案 至 workdir 1.2 快 速 入 門 若 要 立 即 開 始, 可 嘗 試 Sun Java TM Wireless Toolkit for CLDC 隨 附 的 示 範 應 用 程 式 若 要 執 行 示 範, 請 按 以 下 程 序 啟 動 此 工 具 組 在 Microsoft Windows 中, 選 擇 [ 開 始 ] > [ 程 式 集 ] > [Sun Java Wireless Toolkit for CLDC] > [Wireless Toolkit 2.5.2] 1 在 Linux 中, 將 目 錄 變 更 為 toolkit/bin 若 要 執 行 此 工 具 組, 請 輸 入./ktoolbar 會 開 啟 一 個 類 似 圖 1-3 的 視 窗 1. 依 Microsoft Windows 配 置 方 式 的 不 同, 您 可 能 不 是 選 擇 [ 開 始 ] > [ 程 式 集 ], 而 要 選 擇 [ 開 始 ] > [ 所 有 程 式 ] 1-4 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

21 圖 1-3 工 具 組 使 用 者 介 面 按 一 下 [ 開 啟 專 案 ] 按 鈕 以 查 看 所 有 可 用 應 用 程 式 的 清 單 如 圖 1-1 中 所 示, 斜 體 名 稱 表 示 儲 存 在 安 裝 目 錄 中 的 應 用 程 式 ; 粗 體 名 稱 ( 如 果 有 ) 表 示 儲 存 在 您 的 工 作 目 錄 中 的 應 用 程 式 從 中 挑 選 一 個 專 案, 並 按 一 下 對 話 方 塊 中 的 [ 開 啟 專 案 ] 按 鈕 如 果 您 之 前 未 開 啟 過 此 專 案, 則 將 會 在 您 的 工 作 目 錄 中 建 立 副 本, 如 第 1-2 頁 的 第 節 工 作 目 錄 檔 案 中 所 討 論 應 用 程 式 開 啟 後, 請 按 [ 執 行 ] 按 鈕 將 顯 示 執 行 範 例 應 用 程 式 的 模 擬 器 大 部 分 示 範 本 身 就 具 備 足 夠 的 說 明, 但 部 分 示 範 另 外 有 其 他 指 示 某 些 示 範 要 求 您 使 用 [ 專 案 ] > [ 經 由 OTA 執 行 ] 而 非 [ 執 行 ] 如 需 示 範 的 一 般 說 明 與 描 述, 請 參 閱 附 錄 A 1.3 工 具 組 元 件 Sun Java TM Wireless Toolkit for CLDC 有 三 個 主 要 元 件 : 使 用 者 介 面 自 動 執 行 建 立 MIDP 應 用 程 式 的 多 項 相 關 工 作 模 擬 器 是 一 個 模 擬 的 行 動 電 話 在 測 試 MIDP 應 用 程 式 時 非 常 有 用 公 用 程 式 集 提 供 了 其 他 有 用 的 功 能, 包 括 文 字 傳 訊 主 控 台 和 加 密 公 用 程 式 您 可 以 從 使 用 者 介 面 生 成 應 用 程 式 啟 動 模 擬 器 及 啟 動 公 用 程 式 或 者, 您 可 以 讓 模 擬 器 和 公 用 程 式 自 行 執 行, 這 在 許 多 狀 況 下 非 常 有 用 比 如 說, 如 果 要 示 範 MIDP 應 用 程 式, 就 可 以 單 獨 執 行 模 擬 器 您 只 需 要 一 個 額 外 的 工 具, 就 是 文 字 編 輯 器, 以 編 輯 原 始 碼 第 1 章 簡 介 1-5

22 1.4 工 具 組 功 能 Sun Java TM Wireless Toolkit for CLDC 支 援 建 立 具 有 下 列 主 要 功 能 的 MIDP 應 用 程 式 : 生 成 與 封 裝 : 您 只 須 撰 寫 原 始 碼, 其 他 工 作 都 可 以 交 由 工 具 組 負 責 處 理 只 要 按 一 下 按 鈕, 工 具 組 就 會 編 譯 原 始 碼, 預 先 驗 證 類 別 檔 案, 並 封 裝 成 MIDlet 套 件 執 行 與 監 視 : 您 可 以 直 接 在 模 擬 器 中 執 行 MIDlet 套 件, 也 可 以 使 用 類 似 於 在 實 際 裝 置 上 安 裝 應 用 程 式 的 方 式 安 裝 它 本 工 具 組 提 供 記 憶 體 監 視 器 網 路 監 視 器 與 方 法 效 能 評 測 器, 以 分 析 MIDlet 的 作 業 MIDlet 套 件 簽 署 : 工 具 組 包 含 一 些 工 具, 以 加 密 簽 署 MIDlet 套 件 這 可 以 在 不 同 的 保 護 網 域 中, 測 試 MIDlet 的 作 業 1.5 工 具 組 更 新 安 裝 時, 您 可 以 選 擇 啟 動 [ 檢 查 產 品 更 新 ] 功 能 此 功 能 使 用 網 路 每 隔 七 天 檢 查 一 次 更 新 為 了 確 定 是 否 需 要 更 新, 此 功 能 將 收 集 以 下 資 訊 : 作 業 系 統 電 腦 中 的 國 家 / 地 區 及 語 言 設 定 日 期 及 目 前 Wireless Toolkit 的 版 本 由 Wireless Toolkit 產 生 的 唯 一 隨 機 使 用 者 ID 此 資 料 用 於 改 進 產 品 請 閱 讀 Sun 的 隱 私 權 政 策 ( 若 要 啟 動 或 關 閉 此 功 能, 請 選 取 [ 編 輯 ] > [ 偏 好 ], 然 後 按 一 下 [ 網 路 配 置 ] 核 取 或 取 消 核 取 面 板 底 部 的 [ 檢 查 更 新 ] 方 塊 1-6 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

23 1.6 支 援 的 技 術 Sun Java TM Wireless Toolkit for CLDC 支 援 透 過 Java Community Process (JCP ) 程 式 定 義 的 許 多 標 準 應 用 程 式 設 計 介 面 (API) 表 格 1-1 顯 示 這 些 API, 並 包 含 其 規 格 的 連 結 表 格 1-1 支 援 的 JCP 程 式 API JSR API JSR 248 MSA 1.0 JSR 185 JTWI 1.0 JSR 139 CLDC 1.1 JSR 118 MIDP 2.0 JSR 75 PIM 與 檔 案 JSR 82 藍 芽 與 OBEX JSR 135 MMAPI 1.1 JSR 172 JSR 177 SATSA JSR 179 位 置 JSR 180 SIP JSR 184 3D 圖 形 JSR 205 WMA 2.0 名 稱 URL Mobile Service Architecture Java Technology for the Wireless Industry Connected Limited Device Configuration Mobile Information Device Profile PDA Optional Packages for the J2ME Platform Java APIs for Bluetooth Mobile Media API J2ME Web Services Specification Security and Trust Services API for Java ME Location API for Java ME SIP API for Java ME Mobile 3D Graphics API for J2ME Wireless Messaging API 第 1 章 簡 介 1-7

24 表 格 1-1 支 援 的 JCP 程 式 API ( 繼 續 ) JSR API JSR 211 CHAPI JSR 226 JSR 229 JSR 234 AMMS JSR 238 MIA JSR 239 JSR 248 名 稱 URL Content Handler API Scalable 2D Vector Graphics API for J2ME Payment API Advanced Multimedia Supplements Mobile Internationalization API Java Binding for OpenGL ES API Mobile Service Architecture Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

25 第 2 章 開 發 MIDlet 套 裝 軟 體 這 一 章 描 述 如 何 使 用 Sun Java TM Wireless Toolkit for CLDC 建 立 應 用 程 式 一 開 始, 先 說 明 工 具 組 專 案, 然 後 逐 步 完 成 開 發 過 程 建 立 MIDlet 套 裝 軟 體 應 用 程 式 時, 您 可 能 會 遵 循 兩 個 基 本 的 開 發 周 期 第 一 個 開 發 周 期 比 較 快, 也 比 較 簡 單 在 最 初 開 發 階 段 也 非 常 有 用 第 二 個 周 期 比 較 長, 但 有 比 較 寬 裕 的 時 間 進 行 全 方 位 而 且 實 際 的 測 試 這 一 章 後 面 的 部 分 會 介 紹, 如 何 將 Sun Java TM Wireless Toolkit for CLDC 與 進 階 開 發 工 具 ( 如 混 淆 器 與 除 錯 程 式 ) 結 合 使 用 最 後 一 節 簡 要 說 明 如 何 配 置 Web 伺 服 器, 以 服 務 MIDP 應 用 程 式 2.1 關 於 專 案 在 Sun Java TM Wireless Toolkit for CLDC 中,MIDlet 套 裝 軟 體 有 條 理 的 組 織 成 一 個 個 專 案, 而 一 個 專 案 最 後 的 成 果 就 是 一 個 MIDlet 套 裝 軟 體 專 案 包 含 即 將 用 來 生 成 MIDlet 套 裝 軟 體 的 所 有 檔 案, 包 括 Java 原 始 碼 檔 案 資 源 檔 案 與 MIDlet 描 述 元 Sun Java TM Wireless Toolkit for CLDC 一 次 處 理 一 個 專 案 您 可 以 建 立 新 專 案, 或 開 啟 現 有 專 案 這 一 章 會 使 用 非 常 簡 單 的 專 案 範 例 當 您 研 讀 開 發 周 期 的 每 個 步 驟 時, 您 可 以 使 用 工 具 組 一 起 進 行 相 同 的 操 作 若 要 建 立 新 專 案, 請 先 啟 動 使 用 者 介 面 在 Microsoft Windows 中, 選 擇 [ 開 始 ] > [ 程 式 集 ] > [Sun Java Wireless Toolkit for CLDC] > [Wireless Toolkit 2.5.2] 1 將 顯 示 使 用 者 介 面, 如 圖 2-1 中 所 示 1. 依 Microsoft Windows 配 置 方 式 的 不 同, 您 可 能 不 是 選 擇 [ 開 始 ] > [ 程 式 集 ], 而 要 選 擇 [ 開 始 ] > [ 所 有 程 式 ] 2-1

26 圖 2-1 工 具 組 的 使 用 者 介 面 按 一 下 [ 新 建 專 案 ] 工 具 組 會 要 求 您 輸 入 專 案 名 稱 與 即 將 撰 寫 的 MIDlet 類 別 名 稱 填 入 名 稱, 再 按 一 下 [ 建 立 專 案 ] 圖 2-2 建 立 新 專 案 顯 示 [ 設 定 ] 視 窗 您 的 選 擇 會 影 響 專 案 的 生 成 環 境 此 範 例 使 用 預 設 選 項 即 可, 所 以 只 要 按 一 下 [ 確 定 ] 關 閉 視 窗 主 控 台 上 將 顯 示 一 些 訊 息, 告 訢 您 此 專 案 的 原 始 碼 與 資 源 檔 案 確 切 的 儲 存 位 置 2-2 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

27 圖 2-3 主 控 台 上 的 檔 案 位 置 2.2 簡 單 的 開 發 周 期 簡 單 的 開 發 周 期 如 下 : 編 輯 原 始 碼 > 生 成 > 執 行 1. 編 輯 原 始 碼 在 這 個 步 驟 中, 要 建 立 應 用 程 式 即 將 使 用 的 Java 原 始 檔 與 資 源 檔 案 2. 生 成 工 具 組 會 編 譯 並 預 先 驗 證 您 的 Java 原 始 檔 3. 執 行 已 編 譯 的 Java 類 別 檔 案 在 模 擬 器 上 執 行 當 工 具 組 嘗 試 編 譯 原 始 碼 檔 案 時, 如 果 發 生 錯 誤, 請 回 頭 重 新 編 輯 如 果 在 模 擬 器 中 測 試 應 用 程 式 時 發 現 錯 誤, 請 編 輯 該 原 始 碼 檔 案 以 修 正 錯 誤 概 略 瞭 解 簡 單 的 開 發 周 期 後, 這 一 節 其 他 部 分 會 演 示 如 何 使 用 Sun Java TM Wireless Toolkit for CLDC 完 成 每 個 步 驟 第 2 章 開 發 MIDlet 套 裝 軟 體 2-3

28 2.2.1 編 輯 原 始 碼 編 輯 原 始 碼 是 唯 一 完 全 無 需 使 用 Sun Java TM Wireless Toolkit for CLDC 的 步 驟 使 用 自 選 的 文 字 編 輯 器, 建 立 與 編 輯 原 始 碼 檔 案 如 果 您 沒 有 喜 歡 的 文 字 編 輯 器, 請 嘗 試 jedit ( 位 於 如 果 您 正 按 照 範 例 專 案 進 行 操 作, 請 建 立 一 個 新 的 Java 技 術 原 始 碼 檔 案 TinyMIDlet.java 將 其 儲 存 在 專 案 的 來 源 目 錄 中 例 如, 在 Windows 上 此 檔 案 為 workdir\apps\tiny\src\tinymidlet.java 該 檔 案 包 含 以 下 簡 單 的 MIDlet: import javax.microedition.lcdui.*; import javax.microedition.midlet.midlet; public class TinyMIDlet extends MIDlet implements CommandListener { public void startapp() { Display display = Display.getDisplay(this); } Form mainform = new Form("TinyMIDlet"); mainform.append("welcome to the world of MIDlets!"); Command exitcommand = new Command("Exit", Command.EXIT, 0); mainform.addcommand(exitcommand); mainform.setcommandlistener(this); display.setcurrent(mainform); } public void pauseapp () {} public void destroyapp(boolean unconditional) {} public void commandaction(command c, Displayable s) { if (c.getcommandtype() == Command.EXIT) notifydestroyed(); } 完 成 時, 把 檔 案 儲 存 起 來 2-4 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

29 2.2.2 生 成 下 一 個 步 驟 是 生 成 原 始 碼 工 具 組 讓 這 個 部 分 非 常 容 易 在 使 用 者 介 面 中, 按 一 下 [ 生 成 ] 按 鈕 假 設 您 把 原 始 碼 檔 案 儲 存 在 正 確 的 位 置, 工 具 組 將 會 找 到 檔 案, 並 進 行 編 譯 編 譯 錯 誤 會 顯 示 在 主 控 台 中 如 果 有 錯 誤, 如 圖 2-4 中 所 示, 請 編 輯 原 始 碼 以 修 正 問 題 排 除 錯 誤 之 後, 主 控 台 會 通 知 您 生 成 程 序 已 成 功 完 成 圖 2-4 有 關 生 成 的 訊 息 工 具 組 也 會 在 幕 後 預 先 驗 證 已 編 譯 的 類 別 檔 案 MIDlet 類 別 檔 案 必 須 經 過 預 先 驗 證 後, 才 能 在 MIDP 裝 置 或 模 擬 器 上 執 行 工 具 組 會 自 動 為 您 處 理 此 細 節 如 需 有 關 預 驗 證 的 詳 細 資 訊, 請 參 閱 CLDC 規 格 第 2 章 開 發 MIDlet 套 裝 軟 體 2-5

30 2.2.3 執 行 生 成 成 功 之 後, 專 案 就 已 經 完 成 準 備 工 作, 可 以 在 模 擬 器 中 試 用 按 一 下 [ 執 行 ] 按 鈕 模 擬 器 會 顯 示 專 案 中 所 有 MIDlet 清 單 圖 2-5 專 案 MIDlet 清 單 選 擇 您 要 的 MIDlet, 並 選 取 [ 啟 動 ] 如 果 您 要 照 著 TinyMIDlet 範 例 來 做, 結 果 將 如 圖 2-6 中 所 示 2-6 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

31 圖 2-6 TinyMIDlet 實 際 運 作 2.3 完 整 的 開 發 周 期 第 二 個 開 發 周 期 稍 微 複 雜 一 點 它 由 下 列 主 要 步 驟 組 成 : 編 輯 原 始 碼 > 封 裝 > 安 裝 > 執 行 1. 編 輯 原 始 碼 這 與 簡 單 周 期 相 同 2. 封 裝 在 此 步 驟 中,Sun Java TM Wireless Toolkit for CLDC 會 編 譯 並 預 先 驗 證 原 始 碼 檔 案 ( 基 本 上, 跟 之 前 的 生 成 步 驟 一 樣 ) 然 後 將 Java 類 別 檔 案 與 資 源 檔 案 結 合 起 來, 成 為 MIDlet 套 裝 軟 體 Java Archive (JAR) 檔 與 MIDlet 套 裝 軟 體 描 述 元 3. 安 裝 MIDlet 套 裝 軟 體 需 要 安 裝 後 才 能 執 行 您 可 以 將 MIDlet 套 裝 軟 體 安 裝 到 Sun Java TM Wireless Toolkit for CLDC 模 擬 器 或 實 際 裝 置 上 第 2 章 開 發 MIDlet 套 裝 軟 體 2-7

32 4. 執 行 與 在 簡 單 開 發 周 期 一 樣, 執 行 應 用 程 式, 並 測 試 有 無 錯 誤 在 完 整 開 發 周 期 中, 第 一 個 步 驟 與 簡 單 開 發 周 期 完 全 一 樣 編 輯 原 始 碼 的 方 式 都 相 同 生 成 步 驟 現 在 併 入 封 裝 中 完 整 開 發 周 期 包 含 封 裝 與 安 裝 二 個 新 的 步 驟 最 後, 在 許 多 重 要 的 方 面, 安 裝 應 用 程 式 的 執 行 方 式 不 同 於 簡 單 開 發 周 期 中 應 用 程 式 的 執 行 方 式 封 裝 Sun Java TM Wireless Toolkit for CLDC 可 將 MIDlet 套 裝 軟 體 的 封 裝 作 業 自 動 化 封 裝 出 來 的 成 果 是 二 個 檔 案, 一 個 MIDlet 描 述 元 與 一 個 MIDlet 套 裝 軟 體 JAR 檔 案 描 述 元 是 一 個 小 文 字 檔, 其 中 包 含 有 關 MIDlet 套 裝 軟 體 的 資 訊 JAR 檔 案 包 含 組 成 MIDlet 套 裝 軟 體 的 類 別 檔 案 與 資 源 裝 置 在 下 載 整 個 JAR 檔 案 之 前, 可 以 使 用 描 述 元 瞭 解 應 用 程 式, 這 對 於 記 憶 體 不 足 頻 寬 又 有 限 的 無 線 世 界 而 言, 是 很 重 要 的 考 量 若 要 讓 工 具 組 封 裝 您 的 MIDlet 套 裝 軟 體, 請 選 擇 [ 專 案 ] > [ 封 裝 ] > [ 建 立 封 裝 ] 就 會 產 生 MIDlet 套 裝 軟 體 描 述 元 與 JAR 檔 案, 並 放 在 專 案 的 bin 目 錄 中 封 裝 可 能 需 要 其 他 步 驟 您 可 以 使 用 程 式 碼 混 淆 器, 將 MIDlet 套 裝 軟 體 JAR 檔 案 縮 小, 這 個 技 術 會 在 本 章 稍 後 說 明 此 外, 工 具 組 提 供 了 一 些 工 具 可 讓 您 加 密 簽 署 MIDlet 套 裝 軟 體 如 需 詳 細 資 訊, 請 參 閱 第 6 章 安 裝 若 要 正 確 測 試 MIDlet 套 裝 軟 體, 將 它 安 裝 在 工 具 組 模 擬 器 或 實 際 裝 置 上 當 您 在 使 用 者 介 面 中 按 下 [ 執 行 ] 按 鈕 後,MIDlet 套 裝 軟 體 不 會 安 裝 到 模 擬 器 中 而 是 由 模 擬 器 直 接 執 行 MIDlet 類 別 模 擬 器 還 能 夠 將 應 用 程 式 安 裝 在 其 記 憶 體 中, 整 個 過 程 類 似 在 實 際 裝 置 上 透 過 Over the Air (OTA) 傳 送 與 安 裝 應 用 程 式 若 要 在 Sun Java TM Wireless Toolkit for CLDC 模 擬 器 中 安 裝 應 用 程 式, 請 選 擇 [ 專 案 ] > [ 經 由 OTA 執 行 ] 模 擬 器 視 窗 隨 即 開 啟, 但 模 擬 器 不 會 直 接 執 行 您 的 MIDlet 類 別, 而 是 顯 示 [ 應 用 程 式 管 理 軟 體 (AMS)] 歡 迎 畫 面 模 擬 器 的 軟 體 是 實 際 裝 置 在 管 理 MIDlet 套 裝 軟 體 時 必 備 的 一 種 軟 體 類 型 2-8 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

33 圖 2-7 模 擬 器 AMS 歡 迎 畫 面 選 擇 [ 應 用 程 式 ] 進 入 已 安 裝 應 用 程 式 的 主 要 清 單 選 取 [ 安 裝 應 用 程 式 ], 再 按 下 模 擬 器 上 的 選 取 按 鈕 模 擬 器 會 提 示 您 輸 入 要 安 裝 的 應 用 程 式 URL 位 置 URL 已 經 預 先 完 成 第 2 章 開 發 MIDlet 套 裝 軟 體 2-9

34 圖 2-8 URL 提 示 從 功 能 表 選 擇 [ 開 始 ], 開 始 安 裝 模 擬 器 會 顯 示 它 在 URL 找 到 的 應 用 程 式 清 單 選 擇 唯 一 的 一 個, 再 從 功 能 表 選 取 [ 安 裝 ] 模 擬 器 會 最 後 一 次 確 認 您 的 意 向 2-10 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

35 圖 2-9 確 認 安 裝 再 次 選 擇 [ 安 裝 ] 以 完 成 安 裝 您 會 回 到 模 擬 器 的 已 安 裝 應 用 程 式 清 單, 清 單 中 會 包 含 您 剛 才 新 增 的 應 用 程 式 第 2 章 開 發 MIDlet 套 裝 軟 體 2-11

36 圖 2-10 應 用 程 式 功 能 表 [ 經 由 OTA 執 行 ] 是 極 為 有 用 的 功 能, 讓 您 可 以 在 工 具 組 模 擬 器 上 輕 鬆 安 裝 MIDlet 套 件 有 些 功 能 一 定 要 使 用 這 個 技 術 進 行 測 試, 包 括 推 送 註 冊 表 以 及 已 簽 署 MIDlet 套 裝 軟 體 的 安 裝 如 果 要 在 實 際 裝 置 上 測 試 MIDlet 套 裝 軟 體, 您 必 須 先 進 行 安 裝 這 項 動 作 的 進 行 方 式, 絕 大 部 分 須 視 所 用 裝 置 而 定 可 能 的 狀 況 有 二 : 您 可 以 在 Web 伺 服 器 上 部 署 應 用 程 式, 然 後 使 用 MIDP 2.0 規 格 中 描 述 的 Over the Air (OTA) 通 訊 協 定, 將 應 用 程 式 從 伺 服 器 傳 送 到 裝 置 當 使 用 者 購 買 或 安 裝 您 的 應 用 程 式 時, 最 可 能 採 用 這 種 機 制 您 可 以 利 用 藍 芽 紅 外 線 或 串 列 連 線, 將 MIDlet 套 裝 軟 體 傳 送 到 裝 置 這 種 方 式 比 執 行 Web 伺 服 器 簡 單 一 點, 而 且 雖 然 無 法 讓 您 觀 察 到 經 由 OTA 在 裝 置 上 安 裝 應 用 程 式 的 整 個 過 程, 卻 可 讓 您 看 到 應 用 程 式 在 裝 置 上 的 執 行 效 果 2-12 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

37 2.3.3 執 行 安 裝 應 用 程 式 後, 請 從 清 單 中 選 擇 此 應 用 程 式, 然 後 從 功 能 表 中 選 擇 [ 啟 動 ] 圖 2-11 啟 動 安 裝 的 應 用 程 式 在 實 際 裝 置 上 執 行 應 用 程 式 的 方 式, 絕 大 部 分 須 視 裝 置 本 身 而 定 如 需 詳 細 資 訊, 請 參 閱 裝 置 的 文 件 2.4 從 MIDlet 套 裝 軟 體 建 立 專 案 您 也 可 以 使 用 MIDlet 套 裝 軟 體 歸 檔 (.jar 檔 案 ) 和 描 述 元 (.jad 檔 案 ) 來 建 立 Sun Java TM Wireless Toolkit for CLDC 專 案 即 使 您 沒 有 可 用 的 原 始 碼, 這 對 於 從 工 具 組 使 用 者 介 面 執 行 MIDlet 套 裝 軟 體 也 是 非 常 有 用 的 您 可 以 使 用 工 具 組 輕 鬆 處 理 描 述 元 中 的 屬 性, 或 者 可 以 執 行 專 案 並 使 用 工 具 組 的 監 視 工 具 ( 如 第 5 章 所 述 ) 檢 查 其 運 作 方 式 若 要 以 MIDlet 套 裝 軟 體 為 基 礎 建 立 專 案, 請 選 擇 [ 檔 案 ] > [ 從 JAD/JAR 建 立 專 案 ] 瀏 覽 至 您 要 使 用 的 描 述 元, 按 一 下 [ 開 啟 ] 請 注 意, 描 述 元 和 JAR 檔 案 必 須 在 同 一 目 錄 下 第 2 章 開 發 MIDlet 套 裝 軟 體 2-13

38 2.5 使 用 混 淆 器 混 淆 器 (Obfuscator) 是 可 以 將 類 別 檔 案 變 小 的 工 具 MIDlet 套 裝 軟 體 必 須 非 常 精 簡, 一 來 可 以 縮 短 下 載 時 間, 二 來 也 可 以 符 合 部 分 製 造 商 或 供 應 商 對 JAR 檔 案 大 小 所 設 下 的 嚴 格 限 制 使 用 混 淆 器 就 是 讓 MIDlet 套 裝 軟 體 JAR 檔 案 變 小 的 一 種 方 法 ( 但 不 是 唯 一 的 方 法 ) 您 可 以 在 開 發 周 期 的 封 裝 步 驟 中 使 用 混 淆 器 雖 然 Sun Java TM Wireless Toolkit for CLDC 不 隨 附 混 淆 器, 但 已 經 配 置 成 可 以 使 用 ProGuard 混 淆 器 您 只 需 下 載 ProGuard, 並 將 它 放 在 工 具 組 找 得 到 的 位 置 即 可 ProGuard 的 發 行 遵 循 GNU 一 般 大 眾 授 權 (General Public License, GPL) 的 規 定 如 果 您 同 意 授 權 規 定, 即 可 免 費 下 載 及 使 用 ProGuard 安 裝 ProGuard 請 遵 循 以 下 步 驟 安 裝 ProGuard: 1. 移 至 ProGuard 網 站 2. 下 載 最 新 版 本 3. 從 ProGuard 安 裝 的 lib 目 錄, 將 proguard.jar 檔 案 解 壓 縮 到 toolkit/bin 目 錄 使 用 ProGuard 安 裝 ProGuard 之 後, 只 要 選 擇 [ 專 案 ] > [ 封 裝 ] > [ 建 立 模 糊 化 封 裝 ] 即 可 開 始 使 用 在 某 些 狀 況 下, 您 必 須 提 供 控 制 混 淆 器 運 作 方 式 的 程 序 檔 檔 案 例 如, 如 果 是 用 Class.forName() 載 入 類 別, 您 必 須 告 訴 ProGuard 不 要 變 更 類 別 名 稱 若 要 調 用 該 程 序 檔, 您 必 須 能 夠 修 改 您 自 己 的 ktools.properties 檔 案 副 本 將 toolkit/wtklib/os/ktools.properties 複 製 至 workdir/wtklib/os/ktools.properties 請 用 文 字 編 輯 器 建 立 程 序 檔 檔 案, 然 後 儲 存 在 專 案 的 主 目 錄 下 如 需 程 序 檔 檔 案 的 資 訊, 請 參 閱 ProGuard 的 文 件 接 下 來, 告 訴 工 具 組 如 何 找 到 此 檔 案 若 要 執 行 此 動 作, 請 編 輯 您 已 複 製 到 workdir/wtklib 中 的 ktools.properties 檔 案 新 增 底 下 這 一 行 : obfuscate.script.name: scriptfile 用 您 使 用 的 程 序 檔 檔 案 名 稱 取 代 scriptfile 您 必 須 退 出 並 重 新 啟 動 工 具 組 才 能 使 變 更 生 效 2-14 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

39 2.6 使 用 除 錯 程 式 應 用 程 式 除 了 自 行 執 行 之 外, 還 能 夠 使 用 除 錯 程 式 來 執 行 除 錯 程 式 可 讓 您 更 密 切 監 視 執 行 中 的 應 用 程 式 設 定 中 斷 點 與 檢 視 變 數 您 必 須 自 行 提 供 除 錯 程 式 您 可 以 使 用 Java SE 平 台 的 jdb 除 錯 程 式, 或 您 選 擇 的 其 他 除 錯 程 式 如 果 您 想 要 使 用 除 錯 程 式, 則 可 納 入 Sun Java TM Wireless Toolkit for CLDC 的 整 合 開 發 環 境 (IDE) 可 能 是 最 好 的 選 擇 ( 如 Sun Java Studio Mobility 軟 體 ) 如 需 更 多 資 訊, 請 參 閱 由 選 擇 [ 專 案 ] > [ 除 錯 ] 開 始 輸 入 除 錯 程 式 用 來 與 模 擬 器 連 線 的 TCP/IP 連 接 埠 號 按 一 下 [ 除 錯 ] 模 擬 器 開 始 執 行, 並 等 待 來 自 除 錯 程 式 的 連 接 啟 動 除 錯 程 式, 將 它 連 接 到 您 指 定 的 連 接 埠 務 必 將 遠 端 除 錯 程 式 設 成 以 遠 端 模 式 執 行, 而 且 使 用 TCP/IP 如 需 詳 細 資 訊, 請 參 閱 除 錯 程 式 的 文 件 除 錯 MIDlet 具 有 在 Sun Java TM Wireless Toolkit for CLDC 中 使 用 jdb 的 相 關 資 訊 可 以 在 取 得 2.7 在 Web 伺 服 器 上 部 署 應 用 程 式 MIDP 2.0 規 格 包 括 Over The Air User Initiated Provisioning Specification, 以 描 述 MIDlet 套 裝 軟 體 如 何 透 過 Over-the-Air (OTA) 傳 輸 到 裝 置 您 可 以 使 用 Sun Java TM Wireless Toolkit for CLDC 模 擬 器 測 試 這 種 狀 況 若 要 在 Web 伺 服 器 上 從 遠 端 部 署 封 裝 的 MIDP 應 用 程 式, 請 將 Java Application Descriptor (JAD) 檔 的 MIDlet-Jar-URL 特 性 變 更 為 JAR 檔 案 的 URL URL 必 須 是 絕 對 路 徑 例 如 : MIDlet-Jar-URL: 接 著, 確 定 Web 伺 服 器 使 用 JAD 和 JAR 檔 案 正 確 的 MIME 類 型 : 對 於 MIDlet 套 裝 軟 體 描 述 元, 將.jad 副 檔 名 對 映 到 text/vnd.sun.j2me.app-descriptor MIME 類 型 對 於 MIDlet 套 裝 軟 體 JAR 檔 案, 將.jar 副 檔 名 對 映 到 application/java-archive MIME 類 型 關 於 如 何 配 置 Web 伺 服 器 的 詳 細 資 訊, 是 依 據 所 使 用 的 特 定 軟 體 而 定 第 2 章 開 發 MIDlet 套 裝 軟 體 2-15

40 模 擬 器 會 在 OTA 供 裝 過 程 中 實 作 裝 置 的 運 作 方 式 您 可 以 使 用 模 擬 器, 測 試 並 示 範 MIDlet 套 裝 軟 體 從 伺 服 器 到 裝 置 的 完 整 佈 建 程 序 所 需 要 的 執 行 動 作, 只 是 啟 動 模 擬 器 的 AMS 即 可 如 果 用 過 [ 經 由 OTA 執 行 ] 選 項, 則 您 可 能 已 經 熟 悉 了 AMS 若 要 啟 動 模 擬 器 的 AMS, 您 有 二 個 選 項 : 在 Microsoft Windows 的 [ 開 始 ] 功 能 表 中, 選 擇 [ 開 始 ] > [ 程 式 集 ] > [Sun Java Wireless Toolkit for CLDC] > [OTA 供 裝 ] 從 指 令 行 發 出 以 下 指 令 : Windows: Linux: toolkit\bin\emulator -Xjam toolkit/bin/emulator -Xjam 接 著, 依 照 AMS 提 示 安 裝 您 的 應 用 程 式 這 個 程 序 非 常 類 似 本 章 描 述 的 [ 經 由 OTA 執 行 ] 選 項, 但 是 您 必 須 輸 入 自 己 的 伺 服 器 URL, 以 安 裝 您 的 應 用 程 式 2-16 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

41 第 3 章 使 用 專 案 上 一 章 解 說 Sun Java TM Wireless Toolkit for CLDC 如 何 幫 助 您 進 行 MIDP 開 發 周 期 這 一 章 會 深 入 探 討 使 用 專 案 的 詳 細 資 訊, 包 括 下 列 各 項 : 選 取 專 案 的 目 標 API 處 理 MIDlet 套 件 屬 性, 包 括 MIDlet 清 單 暸 解 專 案 目 錄 結 構 在 專 案 中 包 含 第 三 方 程 式 庫 3.1 選 取 API 每 個 專 案 都 是 根 據 某 些 API 的 集 合 建 立 而 成 Sun Java TM Wireless Toolkit for CLDC 可 支 援 多 個 API 第 1-7 頁 的 第 1.6 節 支 援 的 技 術 詳 細 列 出 了 其 完 整 清 單 工 具 組 可 讓 您 根 據 將 來 要 執 行 軟 體 的 裝 置 類 型, 開 發 某 些 API 子 集 的 應 用 程 式 例 如, 雖 然 工 具 組 支 援 Mobile 3D Graphics API JSR 184, 但 您 可 能 想 要 開 發 不 會 利 用 到 該 API 的 應 用 程 式 專 案 的 [API 選 擇 ] 設 定 可 讓 您 只 選 擇 要 使 用 的 API 若 要 瞭 解 此 運 作 方 式, 請 啟 動 該 工 具 組 並 開 啟 專 案 按 一 下 [ 設 定 ] 以 顯 示 圖 3-1 中 所 示 的 視 窗 : 3-1

42 圖 3-1 專 案 設 定 視 窗 在 [API 選 擇 ] 窗 格 上,[ 目 標 平 台 ] 設 定 控 制 窗 格 其 他 部 分 的 外 觀 請 選 擇 最 符 合 需 要 的 設 定, 並 用 下 列 控 制 項 調 整 選 項 例 如, 如 果 您 要 開 發 用 於 與 Java Technology for the Wireless Industry JSR 相 容 裝 置 的 應 用 程 式, 請 從 組 合 方 塊 中 選 擇 [JTWI] 然 後 使 用 下 方 的 控 制 項 指 定 CLDC 版 本 並 選 擇 選 擇 性 API 3-2 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

43 當 您 編 譯 原 始 碼 時, 工 具 組 會 套 用 您 的 選 擇 項 目 備 註 API 選 擇 項 目 不 適 用 於 模 擬 器 模 擬 器 總 是 支 援 所 有 可 用 的 API 您 在 專 案 設 定 中 選 擇 的 API 項 目 只 適 用 於 生 成 專 案 基 本 上,API 選 擇 項 目 是 選 擇 工 具 組 於 編 譯 及 預 檢 驗 原 始 碼 檔 案 時, 所 用 的 類 別 路 徑 3.2 變 更 MIDlet 套 件 屬 性 專 案 設 定 視 窗 也 可 讓 您 控 制 MIDlet 套 件 屬 性, 這 些 屬 性 儲 存 在 描 述 元 以 及 MIDlet 套 件 JAR 的 清 單 檔 案 內 若 要 查 看 屬 性, 請 開 啟 某 專 案, 然 後 按 一 下 [ 設 定 ] 按 鈕 設 定 視 窗 左 側 的 圖 示 列 有 三 個 屬 性 圖 示.. [ 必 需 的 ] [ 選 擇 性 的 ] 以 及 [ 使 用 者 定 義 ] 如 需 必 需 的 與 選 擇 性 的 屬 性 定 義, 請 參 閱 MIDP 2.0 規 格 最 終 發 行 版 本 2 ( 亦 稱 為 MIDP 2.1) Sun Java TM Wireless Toolkit for CLDC 會 負 責 處 理 大 部 分 細 節 在 開 發 前 期, 您 可 能 完 全 不 必 顧 慮 屬 性 問 題 但 是 當 應 用 程 式 逐 漸 穩 定, 您 開 始 考 慮 將 應 用 程 式 部 署 在 實 際 裝 置 上 並 準 備 上 市 時, 就 應 該 調 整 這 些 值 若 要 調 整 [ 必 需 的 ] 或 [ 選 擇 性 的 ] 窗 格 上 的 值, 請 在 要 變 更 的 屬 性 機 碼 旁 的 儲 存 格 中 按 一 下 輸 入 新 的 值 第 3 章 使 用 專 案 3-3

44 圖 3-2 編 輯 MIDlet 套 件 屬 性 若 要 建 立 新 的 使 用 者 定 義 的 屬 性, 請 按 一 下 [ 用 戶 定 義 的 ] 圖 示 按 一 下 [ 增 加 ] 按 鈕 並 填 入 特 性 名 稱 和 值, 然 後 按 一 下 [ 確 定 ] 若 要 編 輯 使 用 者 定 義 的 特 性 值, 請 按 一 下 機 碼 旁 的 值 欄, 以 設 定 必 需 或 選 擇 性 屬 性 的 方 式 編 輯 屬 性 值 若 要 移 除 屬 性, 請 選 取 屬 性, 然 後 按 一 下 [ 移 除 ] 3-4 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

45 3.3 處 理 MIDlet 專 案 設 定 同 時 提 供 一 種 方 法, 可 新 增 或 修 改 包 含 在 當 前 MIDlet 套 件 專 案 內 的 MIDlet 若 要 瞭 解 此 運 作 方 式, 請 啟 動 工 具 組 並 開 啟 現 有 專 案 按 一 下 [ 設 定 ], 然 後 選 擇 [MIDlets] 圖 示 就 會 顯 示 專 案 中 所 有 MIDlet 的 清 單 如 果 剛 建 好 新 專 案, 工 具 組 會 自 動 填 入 第 一 個 MIDlet 項 目 圖 3-3 專 案 中 的 MIDlet 清 單 若 要 增 加 新 的 MIDlet, 請 按 一 下 [ 增 加 ], 然 後 填 入 名 稱 圖 示 檔 案 名 稱 與 類 別 名 稱 圖 示 檔 案 名 稱 可 以 保 持 空 白 若 要 變 更 值 或 移 除 MIDlet 項 目, 請 使 用 [ 編 輯 ] 與 [ 移 除 ] 按 鈕 使 用 者 看 到 的 MIDlet 名 稱 順 序 是 按 照 MIDlet 套 件 的 啟 動 順 序 若 要 修 改 順 序, 請 選 取 MIDlet, 再 按 一 下 [ 上 移 ] 或 [ 下 移 ] 第 3 章 使 用 專 案 3-5

46 3.4 使 用 推 送 註 冊 表 您 也 可 以 使 用 專 案 設 定, 來 處 理 MIDlet 套 件 的 推 送 註 冊 表 設 定 請 按 一 下 [ 設 定...], 並 選 擇 [ 推 送 註 冊 表 ] 圖 示 圖 3-4 專 案 推 送 註 冊 表 設 定 3-6 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

47 若 要 在 推 送 註 冊 表 中 新 增 項 目, 請 按 下 [ 增 加 ], 並 填 入 連 線 URL MIDlet 類 別 及 允 許 的 寄 件 者 值, 然 後 按 一 下 [ 確 定 ] 若 要 編 輯 某 項 目, 請 選 取 該 項 目, 並 按 下 [ 編 輯 ] 按 鈕 若 要 移 除 推 送 註 冊 表 項 目, 請 選 取 該 項 目, 再 按 一 下 [ 移 除 ] 如 果 您 為 應 用 程 式 建 立 推 送 註 冊 表 項 目, 請 確 定 要 一 併 輸 入 適 當 的 權 限 如 需 詳 細 資 訊, 請 參 閱 第 6 章 3.5 設 定 內 容 處 理 器 Sun Java TM Wireless Toolkit for CLDC 可 支 援 由 JSR 211 定 義 的 內 容 處 理 器 API (CHAPI) CHAPI 的 基 本 概 念 是 MIDlet 可 依 據 內 送 的 內 容 ( 檔 案 ) 啟 動 現 代 行 動 電 話 可 使 用 SMS 紅 外 線 藍 芽 電 子 郵 件 以 及 其 他 方 式 接 收 內 容 大 多 數 內 容 具 有 相 關 聯 的 內 容 類 型 CHAPI 可 指 定 系 統, 以 便 依 據 指 定 的 內 容 類 型 啟 動 MIDlet 若 要 修 改 專 案 中 的 內 容 處 理 器 設 定, 請 按 一 下 [ 設 定 ], 然 後 選 擇 [ 內 容 處 理 器 ] 窗 格 第 3 章 使 用 專 案 3-7

48 圖 3-5 配 置 內 容 處 理 器 清 單 中 的 每 一 行 表 示 內 容 處 理 器 的 設 定 此 範 例 配 置 了 兩 個 內 容 處 理 器, 一 個 用 於 TextViewer, 另 一 個 用 於 ImageViewer 若 要 建 立 新 的 內 容 處 理 器, 請 按 下 [ 增 加 ]; 若 要 編 輯 現 有 的 內 容 處 理 器, 請 按 下 [ 編 輯 ] 您 可 以 選 取 一 個 內 容 處 理 器 並 使 用 [ 上 移 ] 與 [ 下 移 ] 按 鈕 來 調 整 其 順 序 若 要 移 除 清 單 中 的 內 容 處 理 器, 請 按 下 [ 移 除 ] 3-8 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

49 當 您 增 加 或 編 輯 內 容 處 理 器 時, 將 顯 示 詳 細 資 訊 視 窗.. 圖 3-6 內 容 處 理 器 詳 細 資 訊 在 [ 類 別 ] 欄 位 中 填 入 MIDlet 的 名 稱 ID 是 用 來 呼 叫 內 容 處 理 器 與 控 制 存 取 的 識 別 字 串 內 容 類 型 是 該 內 容 處 理 器 所 負 責 的 內 容 類 型 清 單 使 用 [ 增 加 ] 或 [ 移 除 ] 管 理 該 清 單 尾 碼 字 串 是 URL 尾 碼 清 單, 一 般 用 於 代 替 明 確 的 內 容 類 型 最 後, 已 允 許 存 取 是 內 容 處 理 器 的 ID 清 單, 表 示 可 存 取 該 內 容 處 理 器 的 其 他 內 容 處 理 器 如 果 該 清 單 為 空 白, 則 任 何 其 他 內 容 處 理 器 均 可 存 取 該 內 容 處 理 器 內 容 處 理 器 具 有 相 關 聯 的 動 作, 讓 呼 叫 的 應 用 程 式 選 擇 處 理 內 容 的 方 式 例 如, 影 像 檢 視 器 內 容 處 理 器 可 能 包 含 檢 視 影 像 原 始 大 小 的 動 作, 以 及 讓 影 像 填 滿 可 用 螢 幕 空 間 的 動 作 按 一 下 內 容 處 理 器 詳 細 資 訊 視 窗 的 [ 動 作 ] 標 籤, 以 編 輯 內 容 處 理 器 的 動 作 第 3 章 使 用 專 案 3-9

50 圖 3-7 內 容 處 理 器 動 作 [ 動 作 ] 清 單 包 含 用 於 此 內 容 處 理 器 之 動 作 的 內 部 名 稱 語 言 環 境 指 顯 示 易 讀 動 作 名 稱 時, 可 用 的 所 有 語 言 環 境 清 單 本 土 化 動 作 是 一 個 表 格, 其 中 包 含 各 種 語 言 環 境 的 易 讀 動 作 名 稱 每 一 列 是 一 種 語 言 環 境, 欄 則 列 出 各 個 動 作 閱 讀 一 整 列 便 可 查 看 特 定 語 言 環 境 的 所 有 易 讀 動 作 名 稱 3-10 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

51 3.6 專 案 目 錄 結 構 每 個 專 案 都 有 標 準 的 目 錄 結 構 專 案 本 身 由 apps 子 目 錄 中 的 目 錄 代 表 例 如, 在 Windows 上,demos 專 案 位 於 workdir\apps\demos 中 以 下 表 格 描 述 了 專 案 目 錄 結 構 表 格 3-1 專 案 目 錄 結 構 目 錄 描 述 bin 封 裝 專 案 時,MIDlet 套 件 描 述 元 與 JAR 檔 案 放 在 此 目 錄 內 此 目 錄 也 包 含 未 封 裝 的 清 單 資 訊, 而 且 可 能 包 含 使 用 [ 經 由 OTA 執 行 ] 時 供 內 部 使 用 的 HTML 檔 案 classes 此 目 錄 用 於 儲 存 已 編 譯 的 類 別 檔 案 lib 將 第 三 方 程 式 庫 放 入 此 目 錄, 以 將 其 包 含 在 此 專 案 中 res 將 影 像 聲 音 與 其 他 資 源 檔 案 存 放 於 此 目 錄 中 這 些 檔 案 會 封 裝 入 MIDlet 套 件 JAR 檔 案 的 根 目 錄 src 將 原 始 碼 檔 案 放 入 此 目 錄 tmpclasses 由 工 具 組 使 用 tmplib 由 工 具 組 使 用 此 外, 專 案 目 錄 包 含 一 個 內 含 專 案 相 關 資 訊 的 project.properties 檔 案 若 要 移 除 專 案 的 暫 存 目 錄 與 檔 案, 請 選 擇 [ 專 案 ] > [ 清 除 ] 3.7 使 用 第 三 方 程 式 庫 Sun Java TM Wireless Toolkit for CLDC 可 讓 您 在 應 用 程 式 中 納 入 第 三 方 程 式 庫 使 用 第 三 方 程 式 庫 可 省 去 自 行 生 成 功 能 的 時 間 從 而 縮 短 開 發 時 間, 但 是 您 應 該 密 切 注 意 MIDlet 套 件 JAR 檔 案 的 大 小 在 應 用 程 式 中 使 用 第 三 方 程 式 庫 時, 第 三 方 程 式 庫 的 大 小 會 加 進 您 的 JAR 中 您 可 以 用 混 淆 器 縮 小 程 式 碼 的 大 小, 而 且 好 的 混 淆 器 甚 至 會 去 除 程 式 庫 中 您 用 不 到 的 部 分 即 便 使 用 混 淆 器, 第 三 方 程 式 庫 的 大 小 仍 然 可 能 比 您 從 頭 開 始 仔 細 撰 寫 的 自 訂 程 式 碼 大 您 必 須 權 衡 在 縮 短 開 發 時 間 與 MIDlet 套 件 JAR 檔 案 的 大 小 之 間 如 何 取 捨 Sun Java TM Wireless Toolkit for CLDC 提 供 兩 種 併 入 第 三 方 程 式 庫 的 方 式 專 案 設 定 中 的 [ 外 部 API] 窗 格 可 讓 您 輕 鬆 在 專 案 中 包 含 或 排 除 程 式 庫 另 外, 您 可 以 將 程 式 庫 置 於 特 定 位 置, 讓 一 個 或 所 有 專 案 得 以 使 用 第 3 章 使 用 專 案 3-11

52 3.7.1 使 用 外 部 API 若 要 指 定 應 包 含 的 API, 請 按 一 下 [ 設 定 ], 然 後 按 一 下 [ 外 部 API] 圖 示 系 統 將 顯 示 可 用 的 外 部 API 清 單 ( 此 清 單 可 能 為 空 白 ) 若 要 在 生 成 時 在 類 別 路 徑 中 增 加 API, 請 核 取 [ 使 用 ] 欄 中 的 方 塊 ( 請 參 閱 圖 3-8) 如 果 您 想 要 API 隨 附 至 應 用 程 式, 還 需 核 取 [ 束 ] 方 塊 如 果 您 知 道 應 用 程 式 要 部 署 於 缺 少 所 選 外 部 API 的 裝 置 上, 請 將 這 些 API 隨 附 於 您 的 應 用 程 式 圖 3-8 選 擇 外 部 API 3-12 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

53 3.7.2 一 個 專 案 的 第 三 方 程 式 庫 放 在 專 案 lib 目 錄 內 的 任 何 程 式 庫 檔 案, 都 會 包 含 在 專 案 的 生 成 與 封 裝 中 程 式 庫 應 該 是 Java 技 術 類 別 的 JAR 或 Zip 檔 案 因 此, 如 果 您 安 裝 在 Windows 上 且 應 用 程 式 名 為 Tiny, 則 類 別 程 式 庫 將 位 於 workdir\apps\tiny\lib 當 您 生 成 執 行 除 錯 與 封 裝 專 案 時, 會 使 用 lib 目 錄 中 的 類 別 檔 案 所 有 專 案 的 第 三 方 程 式 庫 有 些 裝 置 的 程 式 庫 可 供 所 有 安 裝 的 MIDlet 套 件 使 用 例 如, 某 家 製 造 商 可 能 提 供 額 外 的 API, 讓 該 公 司 的 所 有 裝 置 都 可 以 使 用 在 這 種 情 況 下, 您 會 希 望 在 生 成 與 測 試 應 用 程 式 時, 能 夠 使 用 這 些 程 式 庫 但 是 因 為 安 裝 MIDlet 套 件 的 裝 置 上 已 經 存 在 該 程 式 庫, 所 以 您 不 希 望 將 程 式 庫 包 含 在 您 的 封 裝 MIDlet 套 件 中 只 要 將 程 式 庫 放 在 workdir\apps\lib 目 錄 中 即 可 實 現 此 功 能 此 目 錄 中 的 程 式 庫 可 供 所 有 專 案 使 用 3.8 配 置 Wireless Toolkit 工 具 組 包 括 一 些 進 階 的 配 置 選 項 您 可 透 過 編 輯 ktools.properties 檔 案 的 副 本 使 用 這 些 選 項, 該 檔 案 可 在 以 下 位 置 找 到 : Windows: Linux: toolkit\wtklib\windows\ktools.properties toolkit/wtklib/linux/ktools.properties 將 ktools.properties 複 製 到 workdir/os/wtklib, 並 按 本 小 節 其 餘 部 分 的 描 述 進 行 變 更 變 更 主 控 台 字 型 設 定 應 用 程 式 目 錄 設 定 javac 編 碼 特 性 使 用 修 正 控 制 系 統 變 更 ktools.properies 所 產 生 的 效 果 在 下 次 啟 動 工 具 組 時 才 能 看 到 第 3 章 使 用 專 案 3-13

54 3.8.1 變 更 主 控 台 字 型 若 要 變 更 主 控 台 ( 和 其 他 文 字 區 域 ) 中 使 用 的 字 型, 可 以 編 輯 兩 個 特 性 以 下 為 將 字 型 變 更 為 Times New Roman 20 號 的 範 例.. font.jtextarea=times New Roman font.size.jtextarea=20 若 要 復 原 預 設 字 型 與 大 小, 請 移 除 這 兩 個 特 性 設 定 應 用 程 式 目 錄 依 預 設,Sun Java TM Wireless Toolkit for CLDC 將 應 用 程 式 儲 存 在 您 工 作 目 錄 的 apps 子 目 錄 中 您 可 以 在 ktools.properties 中 以 下 列 格 式 新 增 一 行 來 做 變 更 : kvem.apps.dir: 應 用 程 式 目 錄 對 於 Windows, 目 錄 路 徑 中 任 何 反 斜 線 (\) 字 元 之 前, 必 須 加 上 另 一 條 反 斜 線 而 且, 目 錄 路 徑 不 得 包 含 任 何 空 格 例 如, 若 要 將 應 用 程 式 目 錄 設 定 為 D:\dev\midlets, 請 使 用 : kvem.apps.dir: D:\\dev\\midlets Linux 路 徑 則 可 以 依 常 規 指 定 設 定 javac 編 碼 特 性 依 預 設,javac 使 用 您 正 在 執 行 之 Java SE 平 台 所 設 定 的 編 碼 如 需 有 關 如 何 置 換 預 設 原 始 碼 檔 案 編 碼 的 資 訊, 請 參 閱 附 錄 C 使 用 修 正 控 制 系 統 使 用 filterrevisioncontrol 特 性 可 以 配 置 工 具 組, 以 辨 識 並 忽 略 SCCS RCS 與 CVS 修 正 控 制 系 統 所 建 立 的 輔 助 檔 案 若 要 識 別 並 忽 略 輔 助 檔 案, 請 在 ktools.properties 中 包 括 以 下 行 : kvem.filterrevisioncontrol: true 這 樣 可 以 防 止 工 具 組 將 修 正 控 制 檔 案 視 為 原 始 碼 檔 案 和 資 源 檔 案 例 如, 工 具 組 會 將 名 稱 為 src\sccs\s.myclass.java 的 檔 案 視 為 SCCS 修 正 控 制 檔 案, 而 非 Java 技 術 原 始 碼 檔 案 3-14 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

55 第 4 章 使 用 模 擬 器 Sun Java TM Wireless Toolkit for CLDC 模 擬 器 在 桌 上 型 電 腦 上 模 擬 MIDP 裝 置 這 種 作 法, 可 以 方 便 您 觀 察 應 用 程 式 在 MIDP 環 境 中 的 運 作 方 式, 還 能 讓 開 發 周 期 更 為 緊 湊, 而 且 完 全 包 含 在 桌 上 型 電 腦 上 模 擬 器 不 代 表 特 定 裝 置, 但 可 以 正 確 實 作 它 所 支 援 的 API 4.1 模 擬 器 面 板 面 板 是 模 擬 器 實 作 最 頂 端 的 一 層, 可 賦 予 模 擬 器 某 種 外 觀 螢 幕 特 性 和 輸 入 控 制 Sun Java TM Wireless Toolkit for CLDC 隨 附 一 些 代 表 不 同 裝 置 種 類 的 面 板 表 格 4-1 模 擬 器 面 板 名 稱 螢 幕 大 小 畫 布 大 小 色 彩 輸 入 DefaultColorPhone 240 x x ITU-T DefaultGrayPhone 180 x x ITU-T MediaControlSkin 180 x x ITU-T QwertyDevice 636 x x Qwerty 您 可 以 任 意 建 立 您 自 己 的 模 擬 器 面 板 如 需 詳 細 資 訊, 請 參 閱 基 本 自 訂 指 南 4-1

56 4.2 模 擬 器 控 制 模 擬 器 在 標 準 桌 上 型 電 腦 視 窗 中 的 外 觀 與 運 作 方 式 類 似 行 動 電 話 本 小 節 說 明 如 何 控 制 模 擬 器 雖 然 說 明 與 圖 形 以 DefaultColorPhone 面 板 為 基 礎, 但 所 有 面 板 的 運 作 方 式 相 類 似 圖 4-1 DefaultColorPhone 模 擬 器 面 板 4-2 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

57 您 可 以 使 用 滑 鼠 按 一 下 按 鈕 以 按 下 它 們 大 部 分 按 鈕 還 有 通 常 使 用 起 來 更 為 便 捷 的 鍵 盤 捷 徑 鍵 盤 數 字 0 到 9 對 應 模 擬 器 的 0 到 9 按 鈕 下 表 列 出 比 較 不 明 顯 的 鍵 盤 捷 徑 表 格 4-2 鍵 盤 捷 徑 模 擬 器 按 鈕 左 邊 軟 式 按 鈕 右 邊 軟 式 按 鈕 電 源 按 鈕 選 取 鍵 盤 鍵 F1 鍵 F2 鍵 Esc Enter 文 字 的 輸 入 方 式 與 許 多 實 際 裝 置 所 使 用 的 輸 入 方 式 類 似 多 按 幾 次 數 字 按 鈕 可 得 到 您 要 的 字 母 例 如, 按 兩 次 按 鍵 5 即 可 輸 入 字 母 K 輸 入 文 字 時, 星 號 鍵 (*) 可 切 換 大 寫 小 寫 數 字 與 符 號 畫 面 最 上 面 的 指 示 器 可 顯 示 目 前 的 模 式 井 字 鍵 (#) 可 用 於 輸 入 空 格 此 外, 您 可 以 直 接 在 鍵 盤 上 輸 入 文 字 雖 然 如 此 便 於 輸 入 文 字, 但 您 須 謹 記, 使 用 者 很 可 能 沒 有 這 麼 方 便 的 輸 入 法 另 一 個 便 利 之 處 在 於 可 在 文 字 區 複 製 與 貼 上 資 訊 同 時 按 下 Ctrl+V, 可 將 剪 貼 簿 中 的 文 字 貼 至 TextBox 或 TextField 若 要 複 製 TextBox 或 TextField 中 的 內 容, 請 同 時 按 下 Ctrl+C 此 操 作 可 將 文 字 欄 位 的 完 整 內 容 置 於 剪 貼 簿 中 4.3 設 定 模 擬 器 偏 好 您 可 以 調 整 模 擬 器 設 定, 以 更 加 類 似 特 定 裝 置, 或 在 不 同 資 源 條 件 下 測 試 您 的 應 用 程 式 網 路 代 理 伺 服 器 模 擬 器 使 用 桌 上 型 電 腦 的 網 路 連 線 例 如, 當 模 擬 器 執 行 會 建 立 HTTP 連 線 的 MIDlet 時, 模 擬 器 會 嘗 試 使 用 桌 上 型 電 腦 的 網 路 設 定 來 建 立 HTTP 連 線 如 果 開 發 電 腦 位 於 防 火 牆 後 方, 您 可 以 使 用 代 理 伺 服 器 建 立 HTTP 連 線 如 果 不 確 定, 請 檢 查 瀏 覽 器 的 設 定 以 查 看 它 是 否 使 用 代 理 伺 服 器 如 果 您 使 用 代 理 伺 服 器, 您 必 須 將 模 擬 器 配 置 成 使 用 同 一 部 代 理 伺 服 器 若 要 執 行 此 操 作, 請 選 擇 [ 編 輯 ] > [ 偏 好 ] 在 [ 網 路 配 置 ] 窗 格 上, 填 入 要 使 用 的 代 理 伺 服 器 名 稱 與 連 接 埠 號 您 也 可 以 選 取 要 使 用 的 HTTP 版 本 如 果 您 的 代 理 伺 服 器 使 用 HTTP 基 本 認 證 ( 請 參 閱 RFC 2617), 請 核 取 [ 認 證 ] 並 填 入 使 用 者 名 稱 與 密 碼 第 4 章 使 用 模 擬 器 4-3

58 4.3.2 儲 存 容 量 大 小 您 可 以 設 定 或 修 改 指 定 給 每 個 模 擬 器 的 永 久 性 儲 存 裝 置 的 容 量, 也 可 以 變 更 堆 疊 大 小 ( 應 用 程 式 物 件 所 容 許 的 儲 存 容 量 ) 選 擇 [ 編 輯 ] > [ 偏 好 ], 然 後 選 取 [ 儲 存 ] 項 目 圖 4-2 儲 存 偏 好 永 久 性 儲 存 裝 置 模 擬 器 具 有 永 久 性 儲 存 裝 置, 其 預 設 位 置 為 電 話 面 板 目 錄 中 的 appdb 子 目 錄 下 這 些 檔 案 的 副 檔 名 為.db 例 如, 在 Windows 上,DefaultColorPhone 模 擬 器 面 板 的 永 久 性 儲 存 裝 置 儲 存 在 workdir\appdb\defaultcolorphone\manager_storage_settings.db 中 4-4 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

59 如 果 同 時 執 行 同 一 個 模 擬 器 面 板 的 多 個 實 例, 工 具 組 會 為 每 個 實 例 產 生 唯 一 的 檔 案 路 徑 例 如, 在 Windows 上,DefaultColorPhone 實 例 的 檔 案 路 徑 名 稱 可 能 為 workdir\appdb\temp.defaultcolorphone1 workdir\appdb\ temp.defaultcolorphone2 等 等 備 註 檔 案 workdir\appdb\defaultcolorphone\in.use 會 追 蹤 標 記 為 使 用 中 的 儲 存 根 目 錄 數 目 如 果 模 擬 器 當 機, 則 您 需 要 刪 除 in.use 檔 案 本 工 具 組 可 讓 您 選 擇 不 同 的 檔 案 儲 存 位 置, 而 且 您 可 以 限 制 儲 存 裝 置 的 大 小 當 可 用 的 永 久 性 儲 存 裝 置 很 小 時, 這 對 於 測 試 應 用 程 式 的 運 作 方 式 很 有 用 若 要 調 整 永 久 性 儲 存 裝 置 設 定, 請 選 擇 [ 編 輯 ] > [ 偏 好 ], 再 按 一 下 左 側 窗 格 中 的 [ 儲 存 ] 在 [ 儲 存 根 目 錄 ] 欄 位 中, 輸 入 您 希 望 用 於 永 久 性 儲 存 裝 置 的 目 錄 名 稱 您 只 可 以 輸 入 相 對 路 徑, 而 且 您 指 定 的 目 錄 會 建 立 在 appdb 子 目 錄 中 依 預 設, 您 可 以 使 用 大 小 為 1MB (1024KB) 的 永 久 性 儲 存 裝 置 您 可 以 以 KB 為 單 位 輸 入 上 限 請 記 住, 除 應 用 程 式 使 用 空 間 外, 儲 存 裝 置 實 作 也 會 耗 用 一 些 空 間 例 如, 如 果 永 久 性 儲 存 裝 置 的 大 小 是 8KB, 則 應 用 程 式 資 料 和 儲 存 裝 置 耗 用 空 間 會 共 用 這 8192 個 位 元 組 若 要 清 除 模 擬 器 的 永 久 性 儲 存 裝 置, 請 選 擇 [ 檔 案 ] > [ 公 用 程 式 ] 按 一 下 [ 清 除 資 料 庫 ] 按 鈕 即 可 清 除 永 久 性 儲 存 裝 置 清 除 資 料 庫 不 會 影 響 安 裝 的 應 用 程 式 堆 疊 大 小 堆 疊 是 用 於 儲 存 應 用 程 式 物 件 的 記 憶 體 若 要 變 更 堆 疊 大 小, 請 選 擇 [ 編 輯 ] >[ 偏 好 ], 然 後 選 取 [ 儲 存 ] 項 目 ( 請 參 閱 圖 4-2) 依 預 設, 堆 疊 大 小 為 1MB 您 可 以 設 定 最 大 堆 疊 大 小, 以 便 更 真 切 模 擬 實 際 裝 置 上 的 狀 況 在 [ 堆 疊 大 小 ] 欄 位 中 填 入 最 大 堆 疊 大 小 ( 以 KB 為 單 位 ) 調 整 模 擬 器 效 能 模 擬 器 使 用 桌 上 型 電 腦 的 許 多 資 源, 包 括 顯 示 器 與 網 路 連 線 與 桌 上 型 模 擬 器 相 比, 實 際 的 MIDP 裝 置 通 常 配 備 的 處 理 器 比 較 慢 記 憶 體 比 較 少 網 路 連 線 也 比 較 慢, 而 且 顯 示 器 類 型 也 可 能 不 同 Sun Java TM Wireless Toolkit for CLDC 可 讓 您 模 擬 實 際 裝 置 受 限 的 環 境 雖 然 模 擬 器 不 代 表 實 際 裝 置, 但 是 調 整 效 能 設 定 將 為 您 提 供 不 同 執 行 階 段 下 應 用 程 式 的 效 能 資 訊 選 擇 [ 編 輯 ] > [ 偏 好 ], 然 後 在 左 側 窗 格 中 按 一 下 [ 效 能 ] 請 參 閱 圖 4-3 第 4 章 使 用 模 擬 器 4-5

60 圖 4-3 調 整 模 擬 器 效 能 調 整 [ 圖 形 基 元 等 待 時 間 ] 可 改 變 應 用 程 式 呼 叫 Graphics 類 別 中 的 繪 圖 方 法 後, 至 繪 圖 行 為 實 際 發 生 所 經 過 的 時 間 若 要 變 更 螢 幕 特 性, 請 選 擇 [ 顯 示 器 刷 新 ] 類 型 之 一 如 果 選 擇 [ 定 時 ] 類 型, 也 必 須 指 定 [ 刷 新 率 ] 若 要 模 擬 速 度 較 慢 的 實 際 裝 置, 請 核 取 [ 啟 用 虛 擬 機 器 速 度 模 擬 ], 並 選 擇 所 要 的 速 度 若 要 調 整 模 擬 網 路 速 度, 請 核 取 [ 啟 用 流 量 模 擬 ], 然 後 以 位 元 / 秒 為 單 位 選 擇 速 度 4-6 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

61 4.4 暫 停 與 繼 續 MIDlet 有 MIDP 規 格 所 定 義 的 生 命 周 期 MIDlet 可 以 由 裝 置 啟 動 及 停 止 此 外, 外 部 事 件 ( 例 如 來 電 ) 可 能 導 致 裝 置 將 MIDlet 暫 停 模 擬 器 提 供 一 個 簡 單 的 機 制, 可 暫 停 及 重 新 繼 續 正 在 執 行 的 MIDlet 這 對 於 測 試 應 用 程 式 暫 停 時 的 運 作 方 式 非 常 有 用 當 模 擬 器 正 在 執 行 時, 從 模 擬 器 的 視 窗 功 能 表 中, 選 擇 [MIDlet] > [ 暫 停 ] 執 行 中 的 MIDlet 會 暫 停, 而 且 螢 幕 顯 示 Incoming Call... 訊 息 若 要 重 新 繼 續 作 業, 請 從 功 能 表 選 擇 [MIDlet] > [ 重 新 繼 續 ] 4.5 單 獨 執 行 模 擬 器 在 開 發 過 程 中, 通 常 您 會 直 接 在 工 具 組 中 按 下 [ 執 行 ] 按 鈕 或 選 取 [ 專 案 ] > [ 經 由 OTA 執 行 ] 功 能, 來 執 行 模 擬 器 可 是 如 果 要 進 行 測 試 或 示 範, 您 可 能 想 單 獨 執 行 模 擬 器 本 身 這 一 節 會 說 明 幾 種 不 同 方 法 由 Sun Java TM Wireless Toolkit for CLDC 安 裝 程 式 建 立 的 程 式 群 組 包 含 幾 個 與 模 擬 器 單 獨 執 行 有 關 的 項 目 若 要 直 接 執 行 應 用 程 式 ( 類 似 於 按 下 [ 執 行 ] 按 鈕 ), 請 選 擇 [ 執 行 MIDP 應 用 程 式...] 項 目 工 具 組 會 提 示 您 找 出 本 機 磁 碟 上 的 MIDlet 描 述 元 檔 案 請 注 意, 對 應 的 MIDlet 套 件 JAR 也 必 須 存 在 若 要 執 行 模 擬 器 的 應 用 程 式 管 理 軟 體 (AMS), 請 選 擇 [OTA 佈 建 ] 項 目 ( 大 致 類 似 於 使 用 者 介 面 中 的 [ 經 由 OTA 執 行 ] 功 能 ) 模 擬 器 會 顯 示 AMS 歡 迎 畫 面, 而 且 您 可 藉 由 輸 入 URL 的 方 式 安 裝 應 用 程 式 若 要 變 更 模 擬 器 的 偏 好, 請 從 工 具 組 的 程 式 群 組 中 選 擇 [ 偏 好 ] 項 目 所 開 啟 的 偏 好 視 窗, 等 同 於 從 使 用 者 介 面 中 選 擇 [ 編 輯 ] > [ 偏 好...] 時 出 現 的 視 窗 不 執 行 使 用 者 介 面 也 可 以 存 取 Sun Java TM Wireless Toolkit for CLDC 公 用 程 式 只 要 選 擇 [ 公 用 程 式 ] 項 目 即 可 最 後, 您 可 以 變 更 預 設 使 用 的 模 擬 器 面 板 請 選 擇 [ 預 設 裝 置 選 項 ] 項 目, 並 選 擇 其 中 一 個 可 用 的 模 擬 器 面 板 下 次 啟 動 模 擬 器 時, 就 會 使 用 選 取 的 面 板 您 也 可 以 從 指 令 提 示 符 號 執 行 模 擬 器 如 需 詳 細 資 訊, 請 參 閱 附 錄 B 第 4 章 使 用 模 擬 器 4-7

62 4.6 使 用 第 三 方 模 擬 器 第 三 方 公 司 ( 例 如 裝 置 製 造 商 或 無 線 電 信 業 者 ) 有 時 候 會 建 立 與 工 具 組 相 容 的 裝 置 模 擬 器 您 可 以 在 工 具 組 中 安 裝 其 他 模 擬 器, 以 取 得 在 範 圍 廣 泛 的 實 作 上 執 行 應 用 程 式 的 經 驗 進 行 程 序 通 常 是 解 壓 縮 或 安 裝 協 力 廠 商 模 擬 器, 然 後 將 其 目 錄 複 製 到 workdir\wtklib\devices 中 下 次 執 行 工 具 組, 就 可 以 使 用 該 模 擬 器 您 可 以 在 下 列 網 址 找 到 目 前 可 用 模 擬 器 的 部 分 清 單 : Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

63 第 5 章 監 視 應 用 程 式 Sun Java TM Wireless Toolkit for CLDC 提 供 幾 種 工 具, 可 以 監 視 應 用 程 式 的 運 作 方 式 這 些 工 具 在 除 錯 與 最 佳 化 程 式 碼 時, 非 常 有 用.. 效 能 評 測 器 會 列 出 應 用 程 式 中, 每 一 種 方 法 的 使 用 次 數 與 執 行 時 間 記 憶 體 監 視 器 會 在 應 用 程 式 執 行 時, 顯 示 記 憶 體 使 用 率 網 路 監 視 器 會 顯 示 應 用 程 式 傳 送 與 接 收 的 網 路 資 料 它 支 援 許 多 網 路 協 定, 包 括 HTTP HTTPS SMS 與 CBS 追 蹤 會 在 工 具 組 主 控 台 上 顯 示 低 階 資 訊 備 註 監 視 功 能 可 能 會 降 低 應 用 程 式 的 執 行 速 度 5.1 使 用 效 能 評 測 器 效 能 評 測 器 會 追 蹤 應 用 程 式 中 的 每 一 種 方 法 對 於 特 定 執 行, 它 會 指 出 每 一 種 方 法 花 費 的 時 間 長 度, 以 及 每 一 種 方 法 的 呼 叫 次 數 當 應 用 程 式 執 行 完 畢, 模 擬 器 關 閉 之 後, 就 會 顯 示 效 能 評 測 器, 讓 您 可 以 瀏 覽 方 法 呼 叫 資 訊 若 要 開 啟 效 能 評 測 器, 請 選 擇 [ 編 輯 ] > [ 偏 好 ] 請 參 閱 圖 5-1 在 左 側 窗 格 中 按 一 下 [ 監 視 器 ] 在 右 側 窗 格 中, 請 核 取 [ 啟 動 效 能 評 測 ] 如 果 想 要 看 到 所 有 系 統 實 作 方 法 的 效 能 評 測 資 訊, 請 核 取 [ 顯 示 系 統 類 別 ] 否 則, 效 能 評 測 器 只 會 顯 示 內 含 呼 叫 您 的 應 用 程 式 方 法 的 系 統 方 法 按 一 下 [ 確 定 ] 5-1

64 圖 5-1 開 啟 效 能 評 測 器 現 在, 請 按 一 下 [ 執 行 ] 按 鈕 啟 動 您 的 應 用 程 式 依 照 正 常 方 式, 與 應 用 程 式 互 動 完 成 時, 關 閉 模 擬 器 就 會 顯 示 效 能 評 測 器, 列 出 應 用 程 式 中 呼 叫 的 所 有 方 法 的 相 關 資 訊 5-2 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

65 圖 5-2 方 法 效 能 評 測 器 效 能 評 測 器 會 顯 示 二 種 資 訊 類 型 : 以 階 層 式 清 單 顯 示 的 方 法 關 係 叫 作 調 用 圖 效 能 評 測 器 右 側 顯 示 每 個 方 法 及 其 子 項 的 執 行 時 間 與 呼 叫 次 數 備 註 從 模 擬 器 得 來 的 效 能 評 測 值 不 代 表 在 實 際 裝 置 上 的 實 際 值 調 用 圖 調 用 圖 顯 示 方 法 呼 叫 的 階 層 呼 叫 其 他 方 法 的 方 法 會 顯 示 為 資 料 夾 連 按 兩 下 某 方 法, 可 開 啟 該 方 法, 並 查 看 它 呼 叫 的 方 法 不 呼 叫 其 他 任 何 方 法 的 方 法 會 顯 示 成 灰 色 圓 形 您 可 以 搜 尋 特 定 類 別 或 方 法 名 稱 請 按 一 下 [ 尋 找 ], 並 填 入 名 稱 就 會 從 調 用 圖 中 目 前 的 選 項 開 始 執 行 搜 尋, 直 到 圖 形 末 端 如 果 要 搜 尋 整 個 調 用 圖, 請 先 核 取 [ 環 繞 ], 再 按 一 下 [ 尋 找 ] 按 鈕 按 調 用 圖 的 不 同 節 點 時, 效 能 評 測 器 右 側 會 顯 示 該 節 點 的 方 法 詳 細 資 訊 第 5 章 監 視 應 用 程 式 5-3

66 5.1.2 執 行 時 間 與 呼 叫 次 數 效 能 評 測 器 視 窗 右 側 會 顯 示 有 關 方 法 的 詳 細 資 訊 您 可 以 看 到 方 法 名 稱 呼 叫 次 數 及 模 擬 器 用 於 執 行 該 方 法 的 時 間 長 度 執 行 時 間 以 4 種 不 同 方 式 描 述 : [ 周 期 ] 顯 示 處 理 器 執 行 方 法 本 身 時 所 花 費 的 時 間 [% 周 期 ] 是 指 花 費 在 方 法 本 身 的 總 執 行 時 間 百 分 比 [ 周 期 ( 含 子 類 )] 是 花 費 在 方 法 以 及 它 所 呼 叫 的 方 法 的 時 間 [% 周 期 ( 含 子 類 )] 顯 示 花 費 在 方 法 及 其 呼 叫 方 法 的 時 間, 與 總 執 行 時 間 的 比 值 按 一 下 任 何 欄, 可 依 該 欄 排 序 再 按 一 次, 可 切 換 依 遞 增 或 遞 減 順 序 排 序 右 側 窗 格 顯 示 調 用 圖 中, 目 前 選 取 節 點 所 包 含 的 方 法 如 果 要 查 看 每 一 種 方 法, 請 按 一 下 調 用 圖 的 <root> 節 點 儲 存 與 載 入 效 能 評 測 器 資 訊 若 要 儲 存 效 能 評 測 器 階 段 作 業, 請 在 效 能 評 測 器 視 窗 中, 按 一 下 [ 儲 存 ] 按 鈕 選 擇 檔 案 名 稱 若 要 載 入 效 能 評 測 器 階 段 作 業, 請 選 擇 [ 檔 案 ] > [ 公 用 程 式 ] 按 一 下 [ 效 能 評 測 器 ], 然 後 按 下 [ 啟 動 ] 選 取 檔 案 後, 就 會 顯 示 效 能 評 測 器 視 窗, 列 出 所 有 階 段 作 業 資 訊 5.2 使 用 記 憶 體 監 視 器 許 多 MIDP 裝 置 的 記 憶 體 都 很 有 限 Sun Java TM Wireless Toolkit for CLDC 包 含 一 個 記 憶 體 監 視 器, 方 便 您 檢 查 應 用 程 式 的 記 憶 體 使 用 率 您 可 以 查 看 應 用 程 式 使 用 的 總 記 憶 體, 以 及 各 物 件 的 記 憶 體 使 用 率 詳 細 清 單 若 要 開 啟 記 憶 體 監 視 器, 請 選 擇 [ 編 輯 ] > [ 偏 好 ] 在 左 側 窗 格 中 按 一 下 [ 監 視 器 ] 核 取 [ 啟 用 記 憶 體 監 視 器 ] 下 次 執 行 模 擬 器 時, 就 會 出 現 記 憶 體 監 視 器 視 窗, 顯 示 應 用 程 式 長 期 的 記 憶 體 使 用 率 圖 形 記 憶 體 監 視 器 會 降 低 應 用 程 式 啟 動 時 的 速 度, 因 為 必 須 記 錄 每 一 個 建 立 的 物 件 5-4 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

67 圖 5-3 記 憶 體 監 視 器 圖 形 記 憶 體 監 視 器 圖 形 會 顯 示 下 列 資 訊 : 目 前 - 應 用 程 式 目 前 使 用 的 記 憶 體 數 量 最 大 - 程 式 開 始 執 行 之 後 使 用 的 最 大 記 憶 體 數 量, 在 圖 中 以 紅 色 虛 線 顯 示 物 件 - 堆 疊 中 的 物 件 數 已 用 - 已 使 用 的 記 憶 體 數 量 空 閒 - 可 用 但 未 使 用 的 記 憶 體 數 量 總 數 - 啟 動 時 可 用 的 記 憶 體 總 數 量 請 記 住, 若 要 修 改 堆 疊 大 小, 請 選 取 [ 編 輯 ] > [ 偏 好 ], 然 後 選 擇 [ 儲 存 ] 標 籤 如 需 詳 細 資 訊, 請 參 閱 第 3 章 若 要 要 求 系 統 執 行 資 源 回 收, 請 按 一 下 [ 執 行 GC] 備 註 您 用 模 擬 器 觀 察 到 的 記 憶 體 使 用 率, 不 會 與 實 際 裝 置 上 的 記 憶 體 使 用 率 完 全 一 樣 請 記 住, 模 擬 器 不 代 表 實 際 裝 置 而 只 是 它 支 援 的 API 一 種 可 能 的 實 作 方 式 而 已 若 要 查 看 應 用 程 式 中 各 個 物 件 的 詳 細 資 訊, 請 在 記 憶 體 監 視 器 視 窗 中, 按 一 下 [ 物 件 ] 標 籤 第 5 章 監 視 應 用 程 式 5-5

68 圖 5-4 記 憶 體 監 視 器 物 件 顯 示 將 顯 示 具 有 以 下 欄 的 表 格.. 名 稱 - 物 件 的 類 別 名 稱 生 存 - 實 例 數 這 些 實 例 中, 有 些 可 能 符 合 資 源 回 收 的 條 件 總 數 - 應 用 程 式 開 始 執 行 之 後 已 配 置 的 物 件 總 數 合 計 大 小 - 物 件 目 前 使 用 的 記 憶 體 數 量 平 均 大 小 - 平 均 物 件 大 小, 計 算 方 式 為 總 容 量 除 以 生 存 實 例 按 一 下 任 何 欄 標 頭, 可 依 該 欄 排 序 您 可 以 從 記 憶 體 監 視 器 視 窗 功 能 表 選 擇 [ 檢 視 ] > [ 尋 找...], 以 搜 尋 特 定 類 別 名 稱 儲 存 與 載 入 記 憶 體 監 視 器 資 訊 若 要 儲 存 記 憶 體 監 視 器 階 段 作 業, 請 按 一 下 [ 儲 存 ] 按 鈕 選 擇 檔 案 名 稱 若 要 載 入 記 憶 體 監 視 器 階 段 作 業, 請 選 擇 [ 檔 案 ] > [ 公 用 程 式 ] 按 一 下 [ 記 憶 體 監 視 器 ], 然 後 按 下 [ 啟 動 ] 選 取 檔 案 後, 就 會 顯 示 記 憶 體 監 視 器 視 窗, 列 出 所 有 階 段 作 業 資 訊 5-6 Sun Java Wireless Toolkit for CLDC 使 用 者 指 南 2007 年 9 月

69 5.3 使 用 網 路 監 視 器 MIDP 應 用 程 式 至 少 都 具 有 HTTP 網 路 連 線 功 能, 但 還 是 可 能 使 用 其 他 類 型 的 網 路 連 線 網 路 監 視 器 提 供 方 便 的 方 法, 讓 您 查 看 應 用 程 式 在 網 路 上 傳 送 與 接 收 的 資 訊 如 果 要 進 行 網 路 連 線 除 錯, 或 找 出 最 佳 化 網 路 流 量 的 方 法, 這 一 點 相 當 有 用 若 要 開 啟 網 路 監 視 器, 請 選 擇 [ 編 輯 ] > [ 偏 好 ] 在 左 側 窗 格 中 按 一 下 [ 監 視 器 ] 核 取 [ 啟 用 網 路 監 視 ] 下 次 執 行 模 擬 器 時, 就 會 出 現 網 路 監 視 器 視 窗 圖 5-5 網 路 監 視 器 當 應 用 程 式 建 立 任 何 類 型 的 網 路 連 線 時, 都 會 擷 取 並 顯 示 有 關 該 連 線 的 資 訊 圖 中 顯 示 HTTP 請 求 與 回 應 左 側 的 顯 示 會 列 出 訊 息 與 訊 息 片 段 的 階 層 按 一 下 訊 息 或 部 分 訊 息, 可 在 網 路 監 視 器 右 側 查 看 詳 細 資 訊 連 按 兩 下 訊 息 或 部 分 訊 息 以 將 其 展 開 或 摺 疊 訊 息 內 文 以 原 始 十 六 進 制 值 及 其 對 等 值 顯 示 備 註 您 可 以 檢 查 仍 在 傳 送 處 理 中 的 訊 息 不 完 整 訊 息 在 訊 息 樹 狀 結 構 中 以 粗 體 反 白 顯 示 第 5 章 監 視 應 用 程 式 5-7