diff options
| author | DRC <dcommander@users.sourceforge.net> | 2011-10-06 01:20:52 +0000 |
|---|---|---|
| committer | DRC <dcommander@users.sourceforge.net> | 2011-10-06 01:20:52 +0000 |
| commit | 15b6e054053e0ed7fc083e78c053e9041e511ef8 (patch) | |
| tree | 1c89ca5272f2a198ab211e9bdad334529f10723c /BUILDING.txt | |
| parent | 979e2d1be5c84bc9a304c71673702346712243f4 (diff) | |
| download | tigervnc-15b6e054053e0ed7fc083e78c053e9041e511ef8.tar.gz tigervnc-15b6e054053e0ed7fc083e78c053e9041e511ef8.zip | |
Update documentation for Java viewer and add build instructions
git-svn-id: svn://svn.code.sf.net/p/tigervnc/code/trunk@4711 3789f03b-4d11-0410-bbf8-ca57d06f2519
Diffstat (limited to 'BUILDING.txt')
| -rw-r--r-- | BUILDING.txt | 40 |
1 files changed, 40 insertions, 0 deletions
diff --git a/BUILDING.txt b/BUILDING.txt index c4975240..000482de 100644 --- a/BUILDING.txt +++ b/BUILDING.txt @@ -90,6 +90,15 @@ Build Requirements (Windows) variable prior to building TigerVNC. +========================= +Build Requirements (Java) +========================= + +-- Sun/Oracle JDK v5 or later or OpenJDK + +-- See "Building Java Support" below. + + ================== Out-of-Tree Builds ================== @@ -322,6 +331,37 @@ CMake will report: if it successfully finds libjpeg-turbo. +===================== +Building Java Support +===================== + +TigerVNC includes a Java version of the TigerVNC Viewer, which can be used on +any platform that has a Java Runtime Environment (JRE) installed. The Java +viewer works similarly to the native viewer, but with lower performance. + +To build the Java TigerVNC Viewer, add + + -DBUILD_JAVA=1 + +to the CMake or build-xorg command line. The build system will attempt to find +an installed Java Development Kit (JDK) and determine the appropriate paths for +the Java compiler (javac) and the JAR creation utility (jar). You can override +these paths by setting the Java_JAVAC_EXECUTABLE and Java_JAR_EXECUTABLE CMake +variables. You can also override the default flags that are passed to javac +by setting the JAVACFLAGS CMake variable. The build system will look for +keytool and jarsigner in the same directory as Java_JAR_EXECUTABLE. These +tools are needed to sign the JAR file, which is necessary to enable certain +functionality (such as clipboard transfers) when the Java viewer is used as an +applet. + +If the Java viewer is built along with the Windows TigerVNC Server (WinVNC), +then the build system will embed the Java viewer into WinVNC4.exe so that it +will automatically be served up using WinVNC's built-in HTTP server. +Similarly, if the Java viewer is built along with the Unix TigerVNC Server +(Xvnc), then the build system will include the Java viewer in the server +tarball. + + ====================================== Building Native Language Support (NLS) ====================================== |