OPhone SDK文档

OPhone SDK v1.5


安装OPhone SDK

下面主要介绍了如何安装、配置OPhone SDK。如果你还没有下载最新版本的OPhone SDK, 请通过下面的链接页面下载,同时链接页面还提供了关于安装、配置和使用方法的介绍。

SDK下载

对硬件/软件的要求

要使用OPhone SDK提供的工具来开发OPhone和Widget应用程序,你需要准备一台满足以下要求的计算机。

操作系统:

  • Windows XP 或者 Windows Vista
  • Linux (最好是Linux Ubuntu 8.04或更新版本)
  • Mac OS X

集成开发环境:

注意: 如果开发机器上已经安装有JDK,则需要检查其版本是否与上述条件相符合。

SDK的安装

首先下载SDK工具包,运行安装程序包,将SDK安装到一个任意指定的文件夹位置。安装方法是终端命令行下输入:java -jar sdk-package-file.jar,然后会但弹出安装程序的欢迎信息提示窗口。

OPhone安装 - 欢迎

点击“Next”, 如果在阅读许可协议后决定继续安装,你需要选择“I Accept”。

OPhone安装 -法律信息

然后选择SDK安装的文件夹路径。请注意记录SDK安装的路径位置,在后续的ODT,WDT安装时需要使用该路径。

OPhone安装 -安装位置

下一页面显示可选的安装组件,在点击“Next”继续之前,请确认“OPhone SDK”被选中。

OPhone安装 -可选组件

然后连续点击“Next”,直到安装过程结束。

SDK的配置

为了调试运行的方便,可以添加SDK的子目录<your_sdk_dir>/tools到系统的环境变量PATH中。

  • 在Linux下,请编辑文件~/.bash_profile或~/.bashrc,在该文件的末尾添加如下内容:
    • export PATH=${PATH}:<your_sdk_dir>/tools
  • 在Windows下,鼠标右键点击我的电脑, 选择弹出菜单中的属性,在弹出窗口的高级卡片页下,点击按钮环境变量。在弹出的窗口中双击PATH,在变量值的输入窗口中添加内容;<your_sdk_dir>/tools
  • 在Mac OS X机器上,与Linux环境下配置相同,找到home目录下的.bash_profile文件,并添加配置。如果没有找到该文件,则可以自己创建一个。

将tools目录加入PATH环境变量后,SDK提供的工具可以在文件系统的任何位置被调用运行,而不必每次指定SDK安装的完整路径名。请注意,在SDK升级时,如果改变了SDK的安装路径,该PATH变量的内容也同时需要更新。

创建AVD

为了能够在OPhone模拟器上运行你的应用程序,你需要首先创建一个模拟器下的虚拟设备(AVD)。所谓AVD就是模拟器运行时使用的一组配置, 用来描述模拟的OPhone平台。请按照以下步骤创建AVD。

  1. 打开命令行窗口(比如在Windows环境下运行“命令提示符”,或者Mac/Linux环境下运行“终端”。
  2. 选择一个开发使用的目标设备,并创建一个新的AVD。命令行如下:
       android create avd --name OMS --target 1
    命令行中的target id 是 "1",因此被创建AVD的目标设备是OPhone支持设备列表里面的 "Android 1.5".
  3. 然后,命令行上会有是否创建用户设备配置的询问。如果回答“yes”,一系列关于设备各方面配置的问题将会列出,需要你的确认。每个问题都有一个默认值在括号中标出,如果输入为空(直接输入回车),这些默认答案将会被选择。如果第一个问题,关于是否创建用户设备配置的回答是“no”,则所有配置都将是使用默认值。

现在一个名称为OMS的AVD已经创建完成。你可以使用命令行“android list avd”来检查刚刚创建的AVD是否存在。

在Eclipse IDE中添加OPhone库

为了程序编译调试中能使用到OPhone API, 需要添加一个用户库(User Library)到Eclipse中,库文件对应于OPhone SDK所在目录下的oms.jar。 具体步骤如下:

  1. 运行Eclipse,菜单上选择Window > Preferences..., 打开属性编辑窗
  2. 从弹出的编辑窗中选择 Java > Build Path > User Libraries

  1. 在用户库(User Libraries)窗口中点击New,打开New User Libraries对话框。 输入OPhone 1.5,并点击OK

  1. 选中新添加的OPhone,并点击Add JARs。选择OPhone SDK目录下的文件oms.jar,点击OK。现在OPhone用户库已经添加到Eclipse IDE的编译目录中,当一个新的OPhone项目被创建,你可以添加该OPhone用户库到你的项目的编译路径(Java Build Path)下。

  1. 在上一窗口中,双击OPhone下的Javadoc Location,将会弹出窗口Javadoc For 'oms.jar'。 选择弹出窗口中的Javadoc in archive,并选定你的Eclipse IDE目录下的plugins/ophone.sdk.doc_VERSION.jar 文件,然后确定退出。

安装ODT

安装ODT工具

安装WDT

安装WDT工具

运行OPhone模拟器

现在你可以在命令行里面运行OPhone模拟器:sdk_folder/tools/emulator -avd OMS -skin HVGA


Copyright © China Mobile 2009