Project Looking Glass开发指南


Project Looking Glass是Sun公司的3D桌面项目,是一个开放源代码项目,本文档对 这一项目的开发版做了一个介绍,对设置开发环境以及建造Project Looking Glass及其3D应用程序的方法进行了解释。

1. 开始
2. 设置开发环境
3. 下载Project Looking Glass开发版
4. 建造Project Looking Glass
5. 运行Project Looking Glass
6. 获取Project Looking Glass的最新源代码
7. Project Looking Glass源代码的简要介绍
8. 为Project Looking Glass出力
9. 怎样为 Project Looking Glass创建3D应用程序

1. 开始

如果您尚未设置运行环境,请参阅 开始Project Looking Glass开发版,了解相关信息。请检查您的系统配置,确保 满足Project Looking Glass的最低要求。

要想开发Project Looking Glass应用程序或对其功能进行增强,需要 安装几个组件,还要下载Project Looking Glass的源代码。

2. 设置开发环境

下载、安装开发工具

Project Looking Glass采用Apache ANT建造工具来管理建造过程。 如果您尚未安装ANT,需要到apache.org网站上下载其二进制文件:

http://ant.apache.org/

注: 下列安装指导默认您把ANT二进制文件下载到了 /tmp目录当中。

ANT下载完毕之后,按下列步骤进行安装:
  1. 首先登陆为root:

    % su root
    Password: 输入root密码
    #

  2. 安装Apache ANT:

    # cd /usr/local
    # tar -xzf /tmp/apache-ant-1.6.1-bin.tar.gz

  3. 退出root shell:

    # exit
    %

  4. 现在需要对几个环境变量进行设置。下面是bash(1)下的设置:

    ANT_HOME=/usr/local/apache-ant-1.6.1
    PATH=$ANT_HOME/bin:$PATH

3. 下载 Project Looking Glass开发版

java.net网站下的 LG3D开放源代码项目里 可以找到Project Looking Glass开发版的源代码。

在java.net网站上进行注册

如果您以前未曾在 java.net 网站上注册,那么您先要注册, 然后才能下载开发版的源代码。

  1. 浏览http://www.java.net ,点击顶部的注册链接。
  2. 输入您想要的用户名和EMail地址,然后点击 [Register]按钮。
  3. 您将会收到一封EMail,告诉您怎样为您的帐号设置密码。设置完密码并接受 java.net网站的参与条款之后,您就可以登陆进去了。
  4. 现在浏览到 LG3D 项目网站
要想浏览Project Looking Glass核心源代码,请在lg3d项目网站 子项目部分点击lg3d-core。 然后在在侧面导航条的项目 工具下点击 版本控制。在右侧,您就会见到源代码树的链接。 您可以点击这些源代码文件进行浏览,也可以下载。

下载Project Looking Glass源代码

下一步就该把Project Looking Glass源代码下载到您配置好的开发环境当中了。

  1. 首先,为Project Looking Glass项目创建一个目录,例如:

    % mkdir -p ~/projects/lg3d
    % cd ~/projects/lg3d


  2. 然后,登陆到cvs.dev.java.net CVS服务器上:

    % cvs -d :pserver:用户名@cvs.dev.java.net:/cvs login
    CVS password:
    密码

    将上述用户名密码替换成您在java.net上的帐户信息。

  3. 查看lg3d-core源文件:

    % cvs -d :pserver:用户名@cvs.dev.java.net:/cvs checkout lg3d-core

  4. lg3d-demo-apps项目包括几个3D应用程序,其中有CD浏览器和几个演示指南程序。Project Looking Glass桌面需要若干文件,需要把它们找出来:

    % cvs -d :pserver:用户名@cvs.dev.java.net:/cvs checkout lg3d-demo-apps
恭喜!您现在已经配置好建造环境,可以建造Project Looking Glass了。

4. 建造Project Looking Glass

从源代码建造Project Looking Glass的过程是由ANT建造文件(build.xml) 处理的,这个文件就在您的lg3d-core目录下。 进入该目录,运行ant来 建造Project Looking Glass:

% cd ~/projects/lg3d/lg3d-core
% ant

您可以看到类似下列内容的输出信息:
Buildfile: build.xml
 
init:
    [mkdir] Created dir: /home/username/projects/lg3d/lg3d-core/build/classes
 
unpack-x:
    [untar] Expanding: /home/username/projects/lg3d/lg3d-core/ext/lg3d-x11.tar.gz into /home/username/projects/lg3d/lg3d-core/ext
 
compile:
    [javac] Compiling 1 source file to /home/username/projects/lg3d/lg3d-core/build-tools
    [javac] Compiling 626 source files to /home/username/projects/lg3d/lg3d-core/build/classes
 
compile-x11:
 
check-escher:
    [javac] Compiling 25 source files to /home/username/projects/lg3d/lg3d-core/build/classes
 
init:
 
unpack-x:

native-x11:
     [exec] .:/home/username/projects/lg3d/lg3d-core/src/../build/classes
 
junit-tests:
 
no-junit-tests:
     [echo] Skipping junit tests because junit.jar is not installed in ext-unbundeled
 
compile-demo-apps:
    [javac] Compiling 5 source files to /home/username/projects/lg3d/lg3d-core/build/classes
     [copy] Copying 4 files to /home/username/projects/lg3d/lg3d-core/build/classes/org/jdesktop/lg3d/apps/cdviewer/resources
     [copy] Copying 1 file to /home/username/projects/lg3d/lg3d-core/build/classes/org/jdesktop/lg3d/apps/tutorial/resources
     [copy] Copying 1 file to /home/username/projects/lg3d/lg3d-core/build/classes/org/jdesktop/lg3d/apps/help/resources
 
jar:
    [mkdir] Created dir: /home/username/projects/lg3d/lg3d-core/build/lib
      [jar] Building jar: /home/username/projects/lg3d/lg3d-core/build/lib/lg3d-core.jar
 
all:
 
BUILD SUCCESSFUL
Total time: 32 seconds

5. 运行Project Looking Glass

Project Looking Glass可以按两种模式运行:一种是在现有桌面环境下的窗口模式 ,一种是全屏模式。这两种模式在开始Project Looking Glass 开发版文档的运行Project Looking Glass部分有介绍。

如果运行Project Looking Glass当中遇到问题,请参阅 开始Project Looking Glass 开发版文档中的问题解决部分。

6. 获取Project Looking Glass 的最新源代码

要想随时获得Project Looking Glass最新版的源代码,您需要经常访问java.net cvs服务器,更新您的CVS workspace:

  1. 进入您的 ~/projects/lg/lg3d-core目录:

    % cd ~/projects/lg/lg3d-core

  2. 删除当前版本的建造文件:

    % ant clean

  3. 转到 ~/projects/lg目录:

    % cd ~/projects/lg

  4. 再用最新版的Project Looking Glass源代码来更新workspace:

    % cvs -d :pserver:用户名@cvs.dev.java.net:/cvs update -Pd lg3d-core

    并更新演示程序:

    % cvs -d :pserver:用户名@cvs.dev.java.net:/cvs update -Pd lg3d-demo-apps

    把上述用户名替换为您在 java.net上的用户名。

现在既然您已经成功建造了Project Looking Glass,何不浏览一下lg3d-core/ 的目录结构,熟悉一下源程序?

7. Project Looking Glass源程序简要介绍

Project Looking Glass源代码保存在 lg3d-core/src 目录下。 下面是lg3d-core源代码CVS仓库中各种文件的概括:

目录 描述
build/ 建造文件保存在这个目录下。
build-tools/ 建造Project Looking Glass 所需的工具。
build.xml Ant建造控制文件
ext/ 随Project Looking Glass一起发布的各个组件,具体地说,包括escher (X11的Java绑定) 和一个lg3d-x11的稳定版本。
ext-unbundled/ 您可以把未获得许可 与Project Looking Glass一起发行的组件放在这个目录下(例如:junit、Java3D loaders,等等)。 您还可以把自己建造的lg3d-x11放在这个目录下,而不用$LGX11HOME。
src/ lg3d-core源代码树的根目录。
    classes/ 所有.java文件都存在这个目录中。
如欲了解更多信息,请到docs/javadoc/api 目录下,参阅二进制包的java文档。
    devscripts/ 各种 Project Looking Glass开发脚本的源文件。这些脚本用来实现build/ 目录下的类。
        HelloUniverse 在Project Looking Glass会话中运行JAVA 3D旋转立方体演示程序。
        README 这个目录下部分脚本的文档。
        Xtest
用来测试Java X11类在没有X11支持的情况下运行状态的脚本。
        displayserver 运行显示服务器。
        lg3d-dev 以窗口模式运行Project Looking Glass会话(这是“开发”模式,或"No X" 模式)。
        lg3d-session
在X11支持下以全屏模式运行Project Looking Glass会话。
        setup 供其它脚本使用的帮助脚本。
    etc/ 包含各种配置文件。
        jz/ 废弃。
        lg3d/
            README 各种lgconfig*文件的文档。
            lgconfig* Project Looking Glass 可在其中运行的各种模式的配置脚本。
            logging.properties 配置文件,用来控制显示服务器日志文件/var/tmp/lgserver.log当中日志输出的长度。
                  displayconfig/ 提供给高级用户,通过这个目录下的文件,您可以在更复杂的显示环境下运行Project Looking Glass,如多屏幕环境、立体环境或动力墙(power wall)。可选配置选项由lgconfig.xml文件控制。

警告!其它显示选项尚未通过全面测试!
    native/org/jdesktop/lg3d/displayserver/fws/x11/ 用于X11 集成的C代码。
    resources/images/ Project Looking Glass 当中用到的各种图片。
    scripts/ 用来运行Project Looking Glass发行版本的脚本。这些脚本用来实现发行版本jar文件里的类。
        displayserver 运行显示服务器(用户不应直接运行该文件)。
        lg3d-dev 以窗口模式运行Project Looking Glass会话(这种模式是“开发”模式,或“No X”模式)。
        lg3d-session 在X11支持下以全屏模式运行Project Looking Glass会话。
        setup 供其它脚本使用的帮助脚本(用户不应直接运行该文件)。
tests/ Project Looking Glass 的测试软件包以后要放到这个目录下。
www/ java.net网站的网页以及各种文档。

8. 为Project Looking Glass出力

“出力”意味着什么

如欲了解更多信息,请阅读为Project Looking Glass出力文档,然后如果您感兴趣,就申请lg3d项目 的访问权限。

申请LG3D项目的访问权限

申请LG3D项目的访问权限的过程:

  1. 如果您还没有登陆到java.net, 请浏览http://www.java.net,然后在 网页顶部的文本框里输入您的用户名和密码,然后点击[Login]按钮。
  2. 浏览https://lg3d.dev.java.net 网页,把这一页添加到收藏夹里,以备日后查询之便。您将来会经常需要访问这一页!
  3. 点击申请项目成员身份/角色链接
  4. 选择适当的角色:
    - 如果您只想尝试建造Project Looking Glass,就选观察人员(Observer)
    - 如果您计划为Project Looking Glass开发新代码,就选开发人员(Developer)
  5. 提交申请之后,您会收到一封EMail,里面有指导信息,告诉您怎样对项目进行访问。
从现在起,每次访问 LG3D 项目网站的时候,您都要登陆,这样才能访问项目文档。

9. 怎样 为Project Looking Glass开发3D应用程序

Project Looking Glass包括几个3D程序范例,您可以通过这些例子来学习 怎样编写3D程序,以便充分发挥Project Looking Glass桌面环境的3D特性。 这些例子在lg3d-demo-apps 项目当中可以找到。

参阅:

开始Project Looking Glass
Project Looking Glass开发版说明
为Project Looking Glass出力


$修订版本: 1.11 $ $日期: 2004/10/11 16:51:32 $