第 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 2.5.2 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（其中 ~ 是您的主目录）

本文档中介绍了在 Windows 和 Linux 之间存在的显著差异。如果仅涉及一种操作系统，您可以假定上述路径记法的差异适用。

1.1.2 工作目录文件

安装时，安装程序会将文件的子集从安装目录复制到每个用户的工作目录。工作目录的内容如下所示：

.settings — 最初包含 security.properties。

appdb — 会将整个应用程序数据库复制到您的工作目录。

apps — 会在您的工作目录中创建空的 apps 目录。如果打开演示项目，会将该项目自动复制到此位置。新建项目（第 2.1 节“关于项目”）时，新项目也会存储到此位置。

wtklib — 包含仿真器属性文件（请参见第 4 章）以及 HTTP 和 WMA 服务器和客户机的状态信息。

sessions — 这是监视工具（请参见第 5 章）的默认保存目标位置。最初该目录为空。

演示应用程序的所有源代码都可以在 toolkit\apps 中找到，并且每个演示都有自己的项目目录。放置在 toolkit\apps 中的所有应用程序对于所有用户都是可见的。

例如，在 Windows 上，MobileMediaAPI 演示的源代码位于 toolkit\apps\MobileMediaAPI\src 中。使用“打开项目”命令时，您可以看到位于安装目录和您工作目录中的项目（如果在这两个目录中都存在项目）。如图1-1 中所示，本地目录中的项目以粗体显示，而安装目录中的项目以斜体显示。要仅显示您的本地文件，请清除显示可用演示复选框。

图1-1 项目列表以粗体显示本地项目

“打开项目”对话框，其中显示了安装目录和工作目录中的应用程序

当您打开安装目录中的项目时，会将应用程序的副本导入 workdir\apps 中。通常导入过程是觉察不到的，但在运行速度较慢的计算机上可能会看到进度对话框，如图 1-2 所示。任何自定义应仅针对您的本地副本进行。

图 1-2 将项目从 toolkit 导入 workdir

“打开项目”对话框，其中导入进度指示器跟踪了至工作目录的文件复制进度

1.2 快速入门

如果您想快速入门，请尝试使用 Sun Java^TM Wireless Toolkit for CLDC 中附带的演示应用程序。

要运行演示，请按如下方式启动工具包。

在 Microsoft Windows 中，选择“开始”>“程序”>“Sun Java Wireless Toolkit 2.5.2 for CLDC”>“Wireless Toolkit 2.5.2”。^[1]

在 Linux 上，将目录更改为 toolkit/bin。要运行工具包，请输入 ./ktoolbar。

将打开类似于图 1-3 的窗口。

图 1-3 工具包用户界面

启动时出现的默认 KToolbar 窗口。

单击“打开项目”按钮可以查看所有可用应用程序的列表。如图1-1 中所示，斜体的名称表示存储在安装目录中的应用程序，而黑体的名称（如果有）表示存储在您工作目录中的应用程序。从中选择一个应用程序，然后单击对话框中的“打开项目”按钮。如果您之前未打开过该项目，则将在您的工作目录中创建一个副本，如第 1.1.2 节“工作目录文件”中所述。

打开应用程序后，请按“运行”按钮。仿真器将显示正在运行示例应用程序。

大多数演示很简单或自身带有说明，但有些演示有附加说明。对于某些演示，您需要使用“项目”>“通过 OTA 运行”，而不使用“运行”按钮。有关演示的一般说明和介绍，请参见附录 A。

1.3 Toolkit 组件

Sun Java^TM Wireless Toolkit for CLDC 有三个主要组件：

用户界面可以自动执行创建 MIDP 应用程序的多项相关任务。

仿真器是一部模拟移动电话。可用于测试 MIDP 应用程序。

实用程序集合提供了其他有用的功能，包括文本消息传送控制台和加密实用程序。

通过用户界面您可以构建应用程序、启动仿真器以及启动实用程序。此外，仿真器和实用程序也能自行运行，这在很多情况下都很有用。例如，如果您想演示 MIDP 应用程序，则自行运行仿真器非常有用。

您唯一需要的另外一个工具是用于编辑源代码的文本编辑器。

1.4 Toolkit 功能

Sun Java^TM Wireless Toolkit for CLDC 通过以下主要功能支持创建 MIDP 应用程序：

生成和打包：您只需要编写源代码，其余的工作都可以交给工具包来完成。只需按下某个按钮，该工具包即可完成下列工作：编译源代码，预校验类文件以及对 MIDlet 套件打包。

运行和监视：您可以在仿真器中直接运行某个 MIDlet 套件，也可以使用与在真实设备上安装应用程序类似的过程安装该套件。提供内存监视器、网络监视器和方法事件探查器，用于分析 MIDlet 的运行情况。

MIDlet 套件签名：该工具包包含用于对 MIDlet 套件进行加密签名的工具。这对于在不同保护域中测试 MIDlet 的运行情况非常有用。

1.5 工具包更新

安装时，您可以选择激活“检查产品更新”功能。该功能使用网络每隔七天检查一次更新。要确定是否需要更新，它将收集以下信息：

操作系统

计算机上的“国家/地区和语言”设置

日期和当前使用的 Wireless Toolkit 的版本

由 Wireless Toolkit 生成的唯一随机用户 ID

这些数据用于改进产品。请阅读位于 http://www.sun.com/privacy/index.html 的 Sun 的隐私政策。

要激活或取消激活该功能，请选择“编辑”>“首选项”，然后单击“网络配置”。在面板的底部，选中或取消选中“检查更新”框。

1.6 支持的技术

Sun Java^TM Wireless Toolkit for CLDC 支持通过 Java Community Process trademark (JCP) 程序定义的多种标准应用程序编程接口 (Application Programming Interface, API)。表 1-1 显示了 API 及其规范的链接。

表 1-1 支持的 JCP 程序 API
JSR API	名称 URL
JSR 248 MSA 1.0	Mobile Service Architecture http://jcp.org/en/jsr/detail?id=248
JSR 185 JTWI 1.0	Java Technology for the Wireless Industry http://jcp.org/en/jsr/detail?id=185
JSR 139 CLDC 1.1	Connected Limited Device Configuration http://jcp.org/en/jsr/detail?id=139
JSR 118 MIDP 2.0	Mobile Information Device Profile http://jcp.org/en/jsr/detail?id=118
JSR 75 PIM 和文件	PDA Optional Packages for the J2ME Platform http://jcp.org/en/jsr/detail?id=75
JSR 82 Bluetooth and OBEX	Java APIs for Bluetooth http://jcp.org/en/jsr/detail?id=82
JSR 135 MMAPI 1.1	Mobile Media API http://jcp.org/en/jsr/detail?id=135
JSR 172	J2ME Web 服务规范 http://jcp.org/en/jsr/detail?id=172
JSR 177 SATSA	Security and Trust Services API for Java ME http://jcp.org/en/jsr/detail?id=177
JSR 179 位置	Location API for Java ME http://jcp.org/en/jsr/detail?id=179
JSR 180 SIP	SIP API for Java ME http://jcp.org/en/jsr/detail?id=180
JSR 184 3D 图形	Mobile 3D Graphics API for J2ME http://jcp.org/en/jsr/detail?id=184
JSR 205 WMA 2.0	Wireless Messaging API http://jcp.org/en/jsr/detail?id=205
JSR 211 CHAPI	Content Handler API http://jcp.org/en/jsr/detail?id=211
JSR 226	Scalable 2D Vector Graphics API for J2ME http://jcp.org/en/jsr/detail?id=226
JSR 229	Payment API http://jcp.org/en/jsr/detail?id=229
JSR 234 AMMS	Advanced Multimedia Supplements http://jcp.org/en/jsr/detail?id=234
JSR 238 MIA	Mobile Internationalization API http://jcp.org/en/jsr/detail?id=238
JSR 239	Java Binding for OpenGL® ES API http://jcp.org/en/jsr/detail?id=239
JSR 248	Mobile Service Architecture http://jcp.org/en/jsr/detail?id=248

^{1 (注解) 根据 Microsoft Windows 的配置方式，可能需要选择“开始”>“所有程序”，而不是选择“开始”>“程序”。}

ng HTML relocated from here.--

简介