前兩篇介紹了 OCAP RI 執行應用程式與開發應用程式。本文為系列最終章,從平台角度深入 OCAP RI 架構,手把手教你在 Windows 上從原始碼建置完整 RI,掌握最高層級控制權,為移植、優化、增強平台奠基。

需在類 Linux 環境建置,Windows 上使用 Cygwin:
setup.exe,選 Install from Local Directory,並將 All 套件設為 InstallC:\jdk1.6.0_18)C:\apache-ant-1.8.0)$ cd /
$ export SVN_USER=cruise
$ export SVN_PASSWORD=cruise
$ svn checkout -N https://community.cablelabs.com/svn/OCAPRI
# 首次需接受伺服器憑證,輸入 p 永久接受
$ cd OCAPRI
$ ./checkout_dev_env.sh trunk # 耗時約 90 分鐘,若超時重跑直到無新檔案
編輯 trunk/setEnv,新增 JAVA_HOME、ANT_HOME 並加入 PATH:
export PLATFORMROOT=C:/cygwin/OCAPRI/trunk/ri/RI_Platform
export OCAPROOT=C:/cygwin/OCAPRI/trunk/ri/ODLSrc/OCAP-1.0
export RICOMMONROOT=C:/cygwin/OCAPRI/trunk/common
export OCAPHOST=Win32-Cygwin
export OCAPTC=CableLabs/simulator/Win32/debug
export PLATFORMHOST=Win32-Cygwin
export PLATFORMTC=Win32/debug
export TWB_TOOLROOT=C:/cygwin/OCAPRI/trunk/ri/RI_Platform
export JAVA_HOME=C:/jdk1.6.0_18
export ANT_HOME=C:/apache-ant-1.8.0
if [ -z "${PATH_UR}" ]; then export PATH_UR=$PATH; fi
export PATH=`cygpath -u ${ANT_HOME}`/bin:`cygpath -u ${JAVA_HOME}`/bin:${PATH_UR}
載入環境:
$ cd trunk
$ source setEnv
$ cd ri
$ ant build # 約 13 分鐘,同時建置 RI Platform 與 OCAP 實作
$ cd $PLATFORMROOT
$ ./runRI.sh -tunetest -setup
防火牆允許連線後,即可看到模擬電視畫面:

PLATFORMHOST:建置主機配置,對應 $OCAPROOT/hostconfig/$PLATFORMHOSTOCAPTC:目標配置路徑,決定 MPEOS 實作(如 RI_Win32),輸出至 $OCAPROOT/bin/$OCAPTC$OCAPROOT/target/CableLabs/simulator/Win32/debug/buildrules.properties 定義 build.mpeos.BUILDOS=RI_Win32| 目錄 | 用途 |
|---|---|
| apps | 範例應用與測試套件 |
| bin | 建置輸出 |
| docs | 文件與 API 參考 |
| gen | 中間建置檔 |
| hostconfig | 建置主機配置 |
| java | OCAP Stack Java 層原始碼 |
| jni | OCAP Stack Native 層原始碼 |
| jvm | phoneME Advanced JVM 原始碼 |
| mpe | MPE 層與各 MPEOS 實作 |
| target | 目標專屬配置 |
| thirdparty | 第三方開源庫 |
$OCAPROOT/bin/$OCAPTC/bin/libcvm*$OCAPROOT/bin/$OCAPTC/bin/libmpe*$OCAPROOT/bin/$OCAPTC/env/sys/ocap-classes.jar至此你已掌握 OCAP RI 完整建置流程與原始碼結構。遵守授權條款前提下,你可以自由修改 RI 代碼、優化效能、移植至自有硬體。享受深度定製的樂趣吧!