开发学院软件开发Java OCAP 入门,第 2 部分: 为 OCAP RI 编写应用程序 阅读

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

 2010-04-13 00:00:00 来源:WEB开发网   
核心提示:本系列第 1 部分 向您介绍了 OpenCable Application Platform (OCAP) — 针对交互式有线电视应用程序的平台 — 和 OCAP Reference Implementation (RI),您已经了解到,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!
OCAP 入门,第 2 部分: 为 OCAP RI 编写应用程序

使用 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
OCAP 入门,第 2 部分: 为 OCAP RI 编写应用程序

查看原图(大图)

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

图 3. 确认 TWB 安装
OCAP 入门,第 2 部分: 为 OCAP RI 编写应用程序

查看原图(大图)

单击 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 图标
OCAP 入门,第 2 部分: 为 OCAP RI 编写应用程序

表 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 图标
OCAP 入门,第 2 部分: 为 OCAP RI 编写应用程序

在 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. 设置一个断点
OCAP 入门,第 2 部分: 为 OCAP RI 编写应用程序

现在启动调试器。再次选择 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 源代码。

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

Tags:OCAP 入门 部分

编辑录入:爽爽 [复制链接] [打 印]
[]
  • 好
  • 好的评价 如果觉得好,就请您
      0%(0)
  • 差
  • 差的评价 如果觉得差,就请您
      0%(0)
赞助商链接