NOTE: Linux users refer to this page: Build Environment - Linux
- Get CableLabs known working cygwin install: cygwin-minimal-20120803.zip
- Install cygwin from local directory, using the CableLabs known working cygwin.
- Download and install appropriate JDK: http://www.oracle.com/technetwork/java/javase/downloads/index.html
- Download and install appropriate Ant (version 1.8.0 or later is required): http://ant.apache.org/bindownload.cgi
(Note: you need to add the paths to the JDK and Ant to your path, e.g. export PATH=$PATH:/cygdrive/c/apache-ant-1.7.0/bin:/cygdrive/c/Java/jdk1.6.0_13/bin)
More details on cygwin, Java, Ant: Install Cygwin, Java SDK, Ant. Configure your environment
- Checkout source from repository.
- In an appropriate sub-directory:
svn checkout -N https://community.cablelabs.com/svn/OCAPRI cd OCAPRI ./checkout_dev_env.sh trunk
Note: You may need to set environment variables SVN_USER and SVN_PASSWORD in order to avoid svn authentication challenges.
If you do not have commit access for the repository, use SVN_USER=cruise, SVN_PASSWORD=cruise
Note: It may be necessary to temporarily disable your virus protection software while downloading files. Remember to enable virus protection after svn checkout is finished.
A trunk/setEnv file is generated that has the necessary environment settings. Either source it (. trunk/setEnv) and/or add it to your profile. NOTES: -setEnv does not set JAVA_HOME or ANT_HOME - you need to do that separately e.g., in ~/.profile export JAVA_HOME=c:/Java/jdk1.6.0_13 export ANT_HOME=c:/apache-ant-1.7.0 -You need an appropriate commandline subversion client in your path and you may need to repeat the script several times due to issues with cygwin port of svn.
- Use the included ant target e.g:
cd trunk/ri; ant
(This performs a clean build for the platform and stack).
OR: - Build the platform first and then the stack by following the instructions on Building Platform, Stack
Note: It is very likely that you will need to disable any firewall on your development machine - The RI uses various ports and processes to handle streaming, etc.
Note: Depending on your particular video hardware/driver configurationit is likely that you will need to turn off hardware acceleration for your display.
- (Control Panel->Display->Settings-> Advanced->Troubleshoot (Windows XP)
cd $PLATFORMROOT; ./runRI.sh -tunetest -setup
(Note: on a fresh checkout or binary install the initial tune test fails. Ctrl-C (to stop the RI) and repeat ./runRI.sh -tunetest : the initial tune should work.)
(Another Note: If you have not run vlc on your machine you may need to ru n it interactively in order to answer an interactive prompt. To do so:
cd <wherever you installed it ocap-r>i/trunk/common/resources/Win32/VLC ./vlc.exe
vlc will start interactively (you may need to find the window). After you have closed the window vlc will start without the prompt.)
More information on Running Tune Test
So... now what?
To get your Xlet running with the RI, look at hostapp.properties.
There is also a wealth of "Test Xlets" available (some may not work at the moment - YMMV). See Running QA Apps on the RI for directions.
Other useful information: