OCAP 入门，第 2 部分: 为 OCAP RI 编写应用程序

本系列第 1 部分 向您介绍了 OpenCable Application Platform (OCAP) — 针对交互式有线电视应用程序的平台 — 和 OCAP Reference Implementation (RI)。您已经了解到，OCAP 的结构基于 3 个规范，这些规范是标准 Java ME 技术的一部分：

Connected Device Configuration (CDC) 描述一个 JVM 和一组基础 APIs。

Foundation Profile (FP) 提供其他 APIs。

Personal Basis Profile (PBP) 规定图形功能。

就 Java, Standard Edition (Java SE) 而言，CDC/FP/PBP 堆栈几乎等同于 Java Development Kit (JDK) 1.4.2。 但是，对此不要过于较真 — 这只是帮助您理解 CDC/FP/PBP 堆栈的一个比方。

在 第 1 部分 中，您运行了几个与 RI 绑定的演示应用程序。在本文中，您将学习如何创建可以在 RI 和其他 OCAP 设备上运行的应用程序。您将首先使用命令行，然后使用 Eclipse 的 OCAP 插件。

交叉编译

一般来说，OCAP 应用程序的构建是一个交叉编译 示例，也就是说，您在一个平台上构建应用程序，但打算在另一个平台上运行它。就移动电话等小型平台而言，交叉编译的概念很好理解。移动电话应用程序并不在移动电话本身上构建。通常，您使用一台桌面计算机（主机）来创建将在移动电话（目标）上运行的应用程序。类似地，您可以在桌面计算机上使用一个 Java SE 环境来构建将在 OCAP 平台上运行的应用程序。

这就是麻烦所在。您在 第 1 部分 中下载的 OCAP RI 也运行在您的桌面计算机上，但它的确是一个模拟器。OCAP RI 将您的计算机模拟为一个机顶盒。

不管怎样，如果您构建一个 OCAP 应用程序，它应该能够在任意 OCAP 平台上运行，不管是真正的机顶盒还是像 OCAP RI 这样的模拟器。

在命令行上磨练性格

做父母的常常会告诫他们的孩子：任何令人不快的事情都有利于磨练性格。当您使用命令行工具来构建 OCAP 应用程序时，不要忘记这一点。您肯定会学到关于构建过程到底是如何工作的很多知识。即使您选择使用 Eclipse 来构建 OCAP 应用程序（本文后面将介绍这方面的内容），在命令行上执行构建步骤将有助于您更深刻地理解 Eclipse 为您做了哪些工作。

构建 OCAP 实现的结构

术语说明

OCAP 代码本身可以针对包括真实设备在内的各种平台构建。另外，您还可以构建在 RI 平台上运行的 OCAP 代码，RI 平台是一个层，它在 Windows 或 Linux 桌面计算机上模拟 OCAP 设备。OCAP RI 包括 OCAP 实现和 RI 平台。

尽管您没有下载 OCAP RI 的完整源代码，但您在 第 1 部分 中安装的二进制 OCAP RI 拥有类似的目录结构。了解这个结构有利于您定位重要文件和目录。

一个重要的位置就是 OCAPROOT，它是 OCAP 实现源代码的根。它是一个相当复杂的树的根，这个树支持在不同的主机上、针对多个目标构建代码。例如，您可以在一台 Linux 计算机上针对一种特定的机顶盒构建 OCAP 实现。或者，您也可以在 Windows 计算机上针对 OCAP RI 平台进行构建。

OCAPROOT 的实际值取决于 OCAP RI 二进制文件的安装位置。如果使用默认安装位置，这个值就是 /CableLabs/tru2way/ocap-ri/ocap。（尽管 Windows 通常使用反斜杠作为路径分隔符，为保持统一，本文使用正斜杠作为路径分隔符。）

当您构建 OCAP 实现时，结果存储到 ${OCAPROOT}/bin 目录中。具体来说，这些结果被放置到其名称反映目标平台的子文件夹中。这个目标平台由 OCAPTC 表示，构建结果存储在 ${OCAPROOT}/bin/${OCAPTC} 文件夹中。

例如，当您构建 Windows OCAP 堆栈时，OCAPTC 就是 CableLabs/simulator/Win32/debug。

在 OCAP 构建中发现需要的内容

OCAP 实现的一个成功构建将生成一些 Java 类文件和本地库。为了构建 OCAP 应用程序，您真正需要关心的全部内容就是定义平台的类文件。

OCAP Java 平台被打包为两个 JAR 文件：

${OCAPROOT}/bin/${OCAPTC}/env/cvm/lib/basis.jar 是 CDC/FP/PBP 堆栈。

${OCAPROOT}/bin/${OCAPTC}/env/sys/ocap-classes.jar 包含 OCAP 实现的所有 Java 类。

代码中的几行

使用这些 JAR 文件来创建 OCAP 应用程序之前，您需要一些源代码以进行构建。将清单 1 中的代码保存为 src/HelloOcap.java（或者 下载 它）：

清单 1. 一些要构建的源代码

import　javax.tv.xlet.Xlet;　
import　javax.tv.xlet.XletContext;　
import　javax.tv.xlet.XletStateChangeException;　
　
import　org.havi.ui.HScene;　
import　org.havi.ui.HSceneFactory;　
　
import　java.awt.*;　
import　java.awt.event.*;　
　
import　java.util.Vector;　
import　java.util.Random;　
　
public　class　HelloOCAP　implements　Xlet　{　
　private　HScene　mScene;　
　private　HelloOCAPUI　mContent;　
　　
　public　void　initXlet(XletContext　ctx)　throws　XletStateChangeException　{　
　　System.out.println("HelloOCAP　initXlet");　
　　HSceneFactory　factory　=　HSceneFactory.getInstance();　
　　mScene　=　factory.getDefaultHScene();　
　　　
　　mContent　=　new　HelloOCAPUI();　
　　mContent.setVisible(true);　
　　　
　　mScene.setLayout(new　BorderLayout());　
　　mScene.add(mContent,　BorderLayout.CENTER);　
　　　
　　Toolkit　toolkit　=　Toolkit.getDefaultToolkit();　
　　Dimension　d　=　toolkit.getScreenSize();　
　　　
　　mScene.setLocation(0,　0);　
　　mScene.setSize(d.width,　d.height);　
　　mScene.validate();　
　}　
　　
　public　void　startXlet()　throws　XletStateChangeException　{　
　　mScene.setVisible(true);　
　}　
　　
　public　void　pauseXlet()　{　
　}　
　　
　public　void　destroyXlet(boolean　forced)　throws　XletStateChangeException　{　
　}　
}　
　
class　HelloOCAPUI　extends　Container　{　
　private　boolean　mInitialized;　
　private　Font　mFont;　
　private　int　mX,　mY;　
　　
　public　HelloOCAPUI()　{　
　　mInitialized　=　false;　
　　mFont　=　null;　
　　mX　=　mY　=　-1;　
　}　
　　
　public　void　paint(Graphics　g)　{　
　　String　s　=　"Hello,　OCAP!";　
　
　　if　(mInitialized　==　false)　{　
　　　mFont　=　new　Font("Serif",　Font.PLAIN,　96);　
　　　int　w　=　getWidth();　
　　　int　h　=　getHeight();　
　　　FontMetrics　fm　=　g.getFontMetrics(mFont);　
　　　int　sw　=　fm.stringWidth(s);　
　　　int　sh　=　fm.getHeight();　
　　　int　sd　=　fm.getDescent();　
　　　mX　=　(w　-　sw)　/　2;　
　　　mY　=　(h　+　sh)　/　2　-　sd;　
　　　mInitialized　=　true;　
　　}　
　　　
　　g.setFont(mFont);　
　　g.setColor(Color.blue);　
　　g.drawString("Hello,　OCAP!",　mX,　mY);　
　}　
}　

在清单 1 中，initXlet() 中的代码使用一个名为 HelloOCAPUI 的助手类来为这个应用程序建立了一个显示。HelloOCAPUI 主要处理将文本定位于屏幕中间的问题。

构建源代码

您可以使用一个相当长的命令行来构建 HelloOcap.java，但是，如果您计划经常执行这个操作，最好编写一个脚本（在 Windows 中也称为批文件）。

清单 2 是用于构建 HelloOCAPUI.java 源文件的脚本的一个示例。在 src 目录级别上，将这个脚本保存为 build.bat。这个脚本的最后一行 — 包含 javac 的那一行 — 很长，为清晰起见，这里将其分割为几行：

清单 2. 一个构建脚本

@echo　off　
　
set　JAVA_HOME=C:/Progra~1/Java/jdk1.6.0_16　
　
set　OCAPROOT=/CableLabs/tru2way/ocap-ri/ocap　set　OCAPTC=CableLabs/simulator/Win32/debug　
　
set　OCAP_ENV=%OCAPROOT%/bin/%OCAPTC%/env　
　
if　not　exist　bin　mkdir　bin　
　
%JAVA_HOME%/bin/javac　
　　-source　1.4　
　　-target　1.4　
　　-bootclasspath　%OCAP_ENV%/cvm/lib/btclasses.zip;　
　　　　　　　　　　%OCAP_ENV%/cvm/lib/basis.jar;　
　　　　　　　　　　%OCAP_ENV%/sys/ocap-classes.jar　
　　src/*.java　
　　-d　bin　

如果您的 JDK 或 OCAP RI 位于不同的目录中，则需要相应调整脚本。

安装您的应用程序

下一步是说服 OCAP RI 来运行您的应用程序。为此，首先将您刚才创建的类文件复制到 OCA RI 目录结构中。然后，在 src 目录级别上，将清单 3 的内容保存为 bin/hostapps.properties，提供一个 hostapps.properties 文件：

清单 3. hostapps.properties

app.0.application_identifier=0x000000015205　app.0.application_control_code=AUTOSTART　
app.0.visibility=VISIBLE　
app.0.priority=220　
app.0.base_directory=/syscwd/usr/HelloOCAP　
app.0.application_name=HelloOCAP　
app.0.initial_class_name=HelloOCAP　

最后，在 src 目录级别上，将清单 4 中的内容保存为一个脚本 install.bat，用于将类文件和 hostapps.properties 文件复制到 OCAP RI 中的一个文件夹中。

清单 4. install.bat

@echo　off　
　
set　OCAPROOT=/CableLabs/tru2way/ocap-ri/ocap　
set　OCAPTC=CableLabs/simulator/Win32/debug　
　
set　OCAP_ENV=%OCAPROOT%/bin/%OCAPTC%/env　
　
if　not　exist　%OCAP_ENV%/usr/HelloOCAP　mkdir　%OCAP_ENV%/usr/HelloOCAP　
　
xcopy　/s　/y　bin/*　%OCAP_ENV%/usr/HelloOCAP　

在清单 4 中，OCAP_ENV 等同于 hostapps.properties 中的 /syscwd。这个脚本所做的全部工作就是将文件复制到一个 usr 子目录中。

最后一步

最后一步 — 也是很重要的一步 — 是将 OCAP RI 指向刚才创建的 hostapps.properties 文件。为此，编辑 mpeenv.ini 文件。还记得吗， 第 1 部分 介绍过，mpeenv.ini 位于 $OCAPROOT/bin/$OCAPTC/env 中，如果您在安装 OCAP RI 时使用默认路径，则这个位置为 /CableLabs/tru2way/ocap-ri/ocap/bin/CableLabs/simulator/Win32/debug/env。

类路径应该在这个文件的顶部附近定义。只需在前面添加 usr/HelloOCAP 目录，如清单 5 所示。同样，为了便于阅读，那个很长的行在这里被分割为几行。

清单 5. 更改类路径定义

VMOPT.0=-Djava.class.path=/syscwd/usr/HelloOCAP;　
　　　　　　　　　　　　　/syscwd/sys/ocap-classes.jar;　
　　　　　　　　　　　　　/syscwd/sys/ocap-rez.jar;　
　　　　　　　　　　　　　/syscwd/sys/support.jar;　
　　　　　　　　　　　　　/syscwd/qa/ocap-test.jar;　
　　　　　　　　　　　　　/syscwd/qa/support-test.jar;　
　　　　　　　　　　　　　/syscwd;　
　　　　　　　　　　　　　/syscwd/usr;　
　　　　　　　　　　　　　/syscwd/apps/eas　

下次启动 OCAP RI 时，您将看到应用程序代码开始工作了，如图 1 所示：

图 1. Hello, OCAP!

使用 Eclipse 插件

并不是每个人都喜欢使用脚本和命令行。幸运的是，OCAP RI 项目提供了一个优秀的替代方案 — 一个 Eclipse 插件，它能够处理大量繁琐的细节问题，让您集中精力编写应用程序代码。

OCAP RI 项目将这个插件称为 <tru2way> Workbench (TWB)。要安装 TWB，首先需要安装 Eclipse，然后告知 Eclipse 到哪里可以找到 TWB，最后告知 TWB 到哪里可以找到 OCAP RI。

安装和运行 Eclipse

要使用 TWB，建议使用 Eclipse 的一个特殊版本：Eclipse for Java Developers 3.4.2 Ganymede SR2。Eclipse 下载文件是一个 zip 文件（大约 85MB）。要安装 Eclipse，只需解压缩这个文件。我将其放置到 C:/eclipse 中。

运行 c:/eclipse/eclipse.exe，启动 Eclipse。Eclipse 将询问您要在哪里放置一个工作空间，工作空间只是 Eclipse 用于保存设置和文件的位置。我选择的是 c:/eclipse-workspace，但您可以选择任意位置。

安装 TWB

Eclipse 启动并运行后，从菜单选择 Help > Software Updates...。单击 Available Software 选项卡。单击 Add Site... 并输入以下 URL：

http://ri.opencable.com/sdk/updates/eclipse.3.4.2/stable/latest/　

单击 OK 后，Eclipse 将询问 OpenCable Web 站点，找到 TWB，并在列表中显示它，如图 2 所示。

图 2. 添加 TWB

查看原图（大图）

选中 tru2way Workbench Feature 并单击 Install...。Eclipse 将等待一会儿，下载 TWB，然后请求您确认安装（如图 3 所示）：

图 3. 确认 TWB 安装

查看原图（大图）

单击 Next >。查看许可协议，选择 I accept the terms of the license agreement，单击 Finish。Eclipse 完成 TWB 安装，并询问是否希望重新启动 Eclipse。这是个不错的主意，因此单击 Yes。

注册 OCAP RI

您几乎已经准备就绪，可以开始构建 OCAP 应用程序了。下一步是告知 Eclipse 关于 OCAP RI 位置的信息，以便可以使用它来运行应用程序。这个 OCAP RI 就是您在本系列的 第 1 部分 中下载并安装的。Eclipse 将把应用程序安装到 OCAP RI 中并为您启动它。

从 Eclipse 菜单选择 Window > Preferences。在左边的列表中，选择 RI Bundle Registry。单击 New... 并选择一个名为 RIBundleManifest.xml 的文件。

如果 OCAP RI 安装到默认位置，则这个文件的路径是 c:\CableLabs\tru2way\ocap-ri\twb_support\RIBundleManifest.xml。定位这个文件后，单击 Open，然后单击 OK。

恢复 mpeenv.ini

最后，如果您跟随本文 第 1 部分 的操作，则需要撤销对 mpeenv.ini 中的类路径的更改。删除 mpeenv.ini 中的类路径定义前面的 /syscwd/usr/HelloOCAP。

创建一个新项目

最后，所有组件都已就绪，可以使用 Eclipse 创建一个新的 OCAP 应用程序了。

首先创建一个新项目。从 Eclipse 菜单选择 File > New > Project...。现在打开 OCAP 项目并选择 New OCAP Project。单击 Next >。

输入 HelloOCAP 作为 Project name。单击 Next >，选择 Hello World Template 并单击 Finish。

Eclipse 将建立整个项目，其中包括一个 Xlet 类，名为 org.ocapproject.xlet.HelloWorld。您需要做的就是为 OCAP RI 进行设置。

创建一个服务配置

从 Eclipse 菜单选择 Run > Package Services > Open Services Dialog...。在本质上，您将设置进入 hostapps.properties 文件的字段。

在左边的列表中，选择 Xlet Service Configurations 并单击 new 图标，如图 4 所示。

图 4. new 图标

表 1 列示了匹配这个示例的值：

表 1. 创建一个服务配置

填充这些字段后，单击 Apply，然后单击 Package。

创建一个运行配置

最后一步是告知 Eclipse 您要使用刚才创建的服务配置（类似于一个 hostapps.properties 文件）。执行这个操作的方法称为一个运行配置。

从 Eclipse 菜单选择 Run > Run Configurations。选择 OCAP Simulation 并单击 new 图标。

键入 Hello-1-run-configuration 作为 Name。单击 Unbound Xlets，然后单击 Add...。在下拉列表框中，选择刚才创建的服务配置：HelloOCAP-service-configuration。

单击 Apply，然后单击 Run。OCAP RI 将弹出，稍等片刻，屏幕上将显示一个简单的 “Hello World!”。

要正确停止 OCAP RI，从 Eclipse 菜单选择 TWB > Stop Emulator。

理解开发循环

要理解这个开发循环，可以在源代码中进行一个更改，然后在 OCAP RI 上运行修改后的 Xlet。

在 Eclipse 欢迎屏幕内，单击 workbench 图标，如图 5 所示：

图 5. Eclipse 的 workbench 图标

在 HelloOCAP 项目中，展开 src，然后展开 org.ocapproject.xlet。双击 HelloWorld.java，在源代码编辑器中打开它。

对源代码进行一些更改。（一个简单的更改是修改 HELLOWORLD_STR 的定义。）保存文件，从 Eclipse 菜单选择 Run > Run History > HelloOCAP-run-configuration。Eclipse 将负责重新构建这个项目，正确对其打包，并启动 OCAP RI。您将立即看到您的更改。

使用调试器

Eclipse 支持设置断点，逐步调试代码，检查变量，以及执行其他有用的操作。为此，您只需创建一个 debug 配置文件而不是一个 run 配置文件，它们的创建过程几乎完全相同。

从 Eclipse 菜单选择 Run > Debug Configurations。您将看到，运行配置已经在左边的列表中创建。选择 OCAP Simulation 并单击 new 图标。

键入 HelloOCAP-debug-configuration 作为 Name。单击 Unbound Xlets，然后单击 Add...。在下拉列表框中，选择刚才创建的服务配置：HelloOCAP-service-configuration。

单击 Apply，然后单击 Close。

运行之前，在源代码中创建一个断点，以便您能够看到运行中的调试。假设您想调试 HelloWorld 中的用户界面创建。滚动代码编辑器到达第 198 行，这是 initGUI() 方法的第 1 行。在文本区域左边的深灰色槽中，双击创建一个断点。这个断点看起来就像一个蓝色小圆圈，如图 6 所示：

图 6. 设置一个断点

现在启动调试器。再次选择 Run > Debug Configurations，选择 HelloOCAP-debug-configuration，然后单击 Debug。OCAP RI 启动，调试器命中您的断点，Eclipse 询问是否希望打开 Debugger 透视图。选中 Remember my decision 并单击 Yes。

调试器显示所有正在运行的线程列表，您可以在这里检查变量，这里也是可以逐步执行源代码的另一个位置。使用工具栏中的图标逐步执行代码，进入代码，或者继续执行。

要了解关于如何使用 Eclipse 和调试器的更多信息，请参阅 Eclipse 文档。

操作完成后，与前面一样，使用 TWB > Stop Emulator 关闭 OCAP RI。

第 2 部分总结

本文介绍如何针对 OCAP 设备创建自己的应用程序，并使用 OCAP RI 在桌面计算机上运行这些应用程序。尽管可以通过命令行来完成这个任务，但有一个 Eclipse 插件可以简化这个过程。使用 Eclipse，您还可以利用优秀的调试功能。

现在，您对 OCAP 的作用和实现您的想法所需的工具已有所了解。OCAP 在 CDC/FP/PBP 中的基础表示您可以使用一个丰富的 API 调色板来构建您的应用程序。您可以继续进行一些美妙的尝试！请您继续关注第 3 部分，以便深入研究 OCAP RI 源代码。

本文示例源代码或素材下载