OCAP 入门,第 2 部分: 为 OCAP RI 编写应用程序
2010-04-13 00:00:00 来源:WEB开发网本系列第 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. 创建一个服务配置
条目 | 值 |
Application Name | HelloOCAP |
Application ID | 0x5025 |
Organization ID | 0x1 |
Control Code | Autostart |
Visibility | Visible |
Type | Unbound |
Base Directory | C:/eclipse-workspace/HelloOCAP/bin 注意,如果您为 Eclipse 工作空间选择了不同的位置,那么您可能会拥有不同的项目路径。 |
Xlet Class | org.ocapproject.xlet.HelloWorld |
填充这些字段后,单击 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 源代码。
本文示例源代码或素材下载
赞助商链接