当前页面: 开发资料首页 → Netbeans 专题 → 通过 NetBeans 构建和运行 Project Looking Glass
通过 NetBeans 构建和运行 Project Looking Glass
摘要: 通过 NetBeans 构建和运行 Project Looking Glass 本文档演示了通过 NetBeans 启动和运行 java.net Project Looking Glass 的开发环境...
本文档演示了通过 NetBeans 启动和运行 java.net Project Looking Glass 的开发环境是非常容易的。正如您将在本文档中所阅读的一样，将 NetBeans 用作开发工具来构建和运行 Project Looking Glass 使 Project Looking Glass 开发非常简单。
入门
要入门，首先需要设置您的环境。验证环境设置正确之后，您将准备从 NetBeans 中构建和运行 Looking Glass。
平台要求
开始设置 Project Looking Glass 开发环境之前，首先要检查一下，看看您的系统是否符合以下最低要求。
| 组件 | Linux 平台 |
| 操作系统 | 尽管最流行的 linux 分布在基于 Portage 的 java 安装上运行时会遇到一些问题，但是它应该可以正常工作。我们建议按照该指南来手动安装列出的所有组件，而不使用 Portage 安装。 |
| CPU | 建议 2 GHz 或更快 |
| RAM | 建议 512MB |
| 图形卡 | 3D 图形加速卡、至少 16MB VRAM、驱动程序支持 1.2 版本或更高版本的 OpenGL。 16 位或 32 位颜色。 重要信息！ 要求 24 位颜色深度！有关如何配置该项的信息，请参阅下面的说明。 |
| 磁盘空间 | 350MB |
已经经过测试的视频卡
- NVIDIA GeForce 2 或同等的采用 1.0-5336 和 1.0-6629 版 NVIDIA 驱动程序的卡。
请参阅以下 NVIDIA 驱动程序安装技巧。
注意：如果您最近已将驱动程序升级到 1.0-6629，由于 LG3D 要求对 1.0-6629 进行附加配置，因此参考这些说明特别重要。
- ATI Radeon 7500，带有 DRI 驱动程序。请参阅 ATI Radeon 的 DRI 驱动程序安装。
- 对于特定卡的设备驱动程序配置说明，请参考： Installing and Configuring Device Drivers for 3D Desktop Project Looking Glass
如果您成功地在其他卡上运行 Project Looking Glass，或想报告特定卡的问题，请通过论坛告诉我们
设置环境
构建和运行 Project Looking Glass 之前，您需要安装很多 Java 组件。完成此操作的最简单方法是下载所有组件，然后按照下文列出的顺序安装它们。
下载组件
注意： 安装说明假设您将所有组件下载到 /tmp 中。
- Java 2 SDK 标准版本 1.5.0 或更高版本。
http://java.sun.com/j2se/1.5.0/download.jsp
注意：下面的安装说明假设您下载了 RPM 版本的 JDK。
- NetBeans 4.1 IDE
http://www.netbeans.info/downloads/download.php?type=4.1
注意：如果您没有打算进行 J2EE 开发，则您可以下载 NetBeans 4.1 安装程序 linux.bin 版本。
- Java 3D SDK 1.3.2 或更高版本
https://j3d-core.dev.java.net/servlets/ProjectDocumentList
注意：导航到 j3d-core/Release_Builds/1.3.2 子文件夹并下载 java3d-1_3_2-linux-i586.zip。
- Java Advanced Imaging API (JAI) 1.1.2 JDK
http://java.sun.com/products/java-media/jai/downloads/download-1_1_2.html
注意：选择 JDK(TM) Install: Bundle for installation in a JDK Download.阅读并接受软件许可协议之后，选择 Linux JDK Install 项 (jai-1_1_2-lib-linux-i586-jdk.bin)。
安装组件
下载所有组件之后，按照下面的说明安装它们。
- 首先，变为 root 身份：
% su root
Password:输入 root 密码
#
- 安装 Java 2 SDK：
# cd /tmp
# /bin/bash jdk-1_5_0_02-linux-i586-rpm.bin
# rm jdk-1_5_0_02-linux-i586.rpm
# rm jdk-1_5_0_02-linux-i586-rpm.bin
- 安装 Java 3D SDK：
# cd /tmp
# unzip java3d-1_3_2-linux-i586.zip
# cd /usr/java/jdk1.5.0/jre
# unzip /tmp/java3d-1_3_2-linux-i586/j3d-132-linux-x86.zip
# cd /tmp
# rm -r java3d-1_3_2-linux-i586/
- 安装 Java Advanced Imaging API：
# cd /usr/java/jdk1.5.0
# /bin/bash /tmp/jai-1_1_2-lib-linux-i586-jdk.bin
- 退出 root shell：
# exit
%
- 现在，需要对您的 shell 配置文件中的几个环境变量进行设置。下面的示例适用于 bash(1)：
JAVA_HOME=/usr/java/jdk1.5.0
PATH=$JAVA_HOME/bin:$PATH
- 安装 NetBeans IDE：
% cd /tmp
% chmod +x netbeans-<version>-linux.bin
% ./netbeans-<version>-linux.bin
% rm netbeans-<version>-linux.bin
其中 netbeans-<version>-linux.bin 是您所使用的此版本 NetBeans 的文件名，例如 netbeans-4_1-linux.bin 或类似名称。
在 java.net 网站上注册
如果您以前没有在 java.net 上注册过，那么您需要创建一个帐户：
- 导航到 http://www.java.net，然后单击页面顶部的 Register 链接。
- 输入您喜欢的用户名和电子邮件地址，然后按 [Register] 按钮。
- 您将收到一封说明如何为帐户设置密码的电子邮件。您输入密码并接受 java.net 网站的参与条款之后，您便可以登录了。
配置显示器的颜色深度
Project Looking Glass 开发版要求颜色深度至少为 24 位。默认情况下，很多系统都配置为 16 位颜色深度，但是在这个深度上，Project Looking Glass 开发版将不能正确运行。您可以通过运行以下命令，获取当前的显示深度：
% xdpyinfo | grep "depth of root"
depth of root window: 24 planes
如果您看到低于 24 的值，则必须更改颜色深度。更改颜色深度的过程因平台而异。请参考以下平台配置说明：
Java 桌面系统 1 和 2，以及 SUSE8.1：
- 从桌面会话中，运行 sax2 命令：
% /usr/X11R6/bin/sax2
SaX: root Password:输入 root 密码
- 在 SaX2 应用程序中，针对新配置的桌面，单击 Color and Resolution，然后单击 [Properties...] 按钮。
- 在 Color selection... 面板中，单击该菜单然后选择 16.7 Mio.[24 Bit]。
- 在 Resolution(s) for 16.7 Mio.[24 Bit] colors 选项卡上，为您的桌面选择首选的分辨率，然后按 [Ok]。
- 单击 [Finish] 按钮，然后单击 [Finalize>>]。
- 将打开 SaX2 final steps... 对话框。单击 [Test...] 按钮可测试新的分辨率。
- 将出现蓝色测试屏幕，如果显示器显示稳定，则单击 [Save] 按钮，然后返回 SaX2 窗口时单击 [Ok]，之后再单击 [Yes] 退出 SaX2。
- 如果测试屏幕显示不正确，则 30 秒之后将退出测试，并且将恢复到上一个桌面会话。然后您应该在 24 位颜色深度时改变分辨率，以找到适合您系统的分辨率。
- 如果您对这些设置很满意，则注销并重新登录您的桌面会话，然后使用上面的 xdpyinfo 命令验证现在的颜色深度是否为 24 位或更高。
RedHat Fedora 2：
- 首先，变为 root 身份：
% su root
Password:输入 root 密码
#
- 编辑文件： /etc/X11/xorg.conf
- 查找标有以下内容的文件部分： Section "Screen"
- 在该部分中，找到条目：Identifier "Screen0"
将 DefaultDepth 和 DefaultFbBpp 属性更改为：
DefaultDepth 24
DefaultFbBpp 32
- 保存该文件，然后注销并重新登录您的桌面会话，使用上面的 xdpyinfo 命令验证现在的颜色深度是否为 24 位或更高。
RedHat 8、RedHat 9 和其他 Linux 平台：
很多 Linux 平台都使用 XF86Config 文件配置显示器属性。在这些系统上更改颜色深度的步骤如下：
- 首先，变为 root 身份：
% su root
Password:输入 root 密码
#
- 编辑文件： /etc/X11/XF86Config
- 查找标有以下内容的文件部分：Section "Screen"，将 DefaultDepth 属性更改为 24：
DefaultDepth 24
- 在该部分中，找到标有“Display”的子部分：
SubSection "Display"
，将 Depth 属性更改为：
Depth 24
- 保存该文件，然后注销并重新登录您的桌面会话，使用上面的 xdpyinfo 命令验证现在的颜色深度是否为 24 位或更高。
使用 NetBeans 构建和运行 Looking Glass
您已经具有构建 Looking Glass 所需的环境了，现在开始准备启动 NetBeans、获得 Looking Glass 源代码、从源中构建 Looking Glass 并从 NetBeans 中运行所有 Looking Glass。
启动 NetBeans
要启动 NetBeans，只需在终端窗口的命令提示符下键入 netbeans：
% netbeans
以上命令将启动 NetBeans IDE。
获得 Looking Glass 源代码
下一步是配置 NetBeans IDE 以从 java.net CVS 存储库中检索 Looking Glass 源代码。必须从中检索源文件的存储库有两个 Looking Glass CVS，即 lg3d-core 和 lg3d-demo-apps。在 NetBeans 中设置和检索源文件的步骤将在下面两个子部分即“获得 lg3d-core 源”和“获得 lg3d-demo-apps 源”中介绍。
获得 lg3d-core 源
在 NetBeans IDE 中，从主菜单中选择 Versioning > CVS > Check Out，如下图 1 所示。
图 1 Versioning > CVS > Check Out
选择 Versioning > CVS > Check Out 菜单项之后，您将看到“Enabling Advanced CVS Command Options”对话框，如图 2 所示。
图 2 Enabling Advanced CVS Command Options
勾选标签“Do Not Show This Dialog Box Again”旁边的复选框，如图 2 所示，然后按“Check Out”按钮。
接下来您将看到“CVS Checkout”对话框。在这个屏幕上您需要输入几个值。在此屏幕上应该输入以下每个值。
Working Directory:<放置 Looking Glass 源文件的源路径>记住这个目录路径，之后您需要再次输入它
CVS Server Type: pserver选择“Use Built-in CVS Client”
CVS Server Name: cvs.dev.java.net
Port:2401
User Name:<输入您的 java.net 用户名>
Repository Path: /cvs
Password:<输入您的 java.net 密码>选择“Module(s)”按钮
Module(s): lg3d-coredev-0-6-2 是到 2005 年 4 月 3 日为止最新的分支。
Revision or Tag: dev-0-6-2
CVS Checkout 窗体的外观类似于下面图 3 中所示的窗体外观。
图 3 CVS Checkout
注意到 Password 字段和 Login 按钮下面的标签“You are not logged in.”。现在按 Login 按钮。标签将更改为“You are logged in”。
我的环境中的 CVS Checkout 窗体如下图 4 所示。
图 4 已登录的 CVS Checkout
完成 CVS Checkout 窗体之后，显示“you are logged in”，然后按“Ok”按钮。
按“Ok”按钮之后，CVS Checkout 窗体将消失，您将注意到 NetBeans IDE 底部的输出窗口将显示运行 CVS 签出的 VCS Output。这个 VCS Output 窗口中的输出非常类似于下面图 5 中所示的输出。
图 5 VCS Output 窗口 - 单击可获得最大尺寸的图像
完成 CVS 签出之后， VCS Output 窗口底部的状态消息将显示已经完成签出。
从主菜单中选择 Window > Versioning > Versioning。现在，NetBeans IDE 的左上角将出现 Versioning 窗口，如下图 6 所示。
图 6 Versioning 窗口
获得 lg3d-demo-apps 源
正如在上一部分“获得 lg3d-core 源”中一样，从主菜单中选择 Versioning > CVS > Check Out（如图 7 所示）以启动检索 lg3d-demo-apps 源代码的序列。
这将再次显示“CVS Checkout”窗口。填写“CVS Checkout”窗体上的值，如下图 8 所示。
重要信息：确保使用与“获得 lg3d-core 源”部分中指定的相同工作目录，更新 Module(s) 字段以便它的内容为“lg3d-demo-apps”。
图 8 CVS Checkout (lg3d-demo-apps)
在 CVS Checkout 窗口中指定值之后，按“Ok”按钮即可启动 lg3d-demo-apps 源的 CVS 签出。
再次注意到，NetBeans IDE 的输出窗口将显示 lg3d-demo-apps 的 VCS Output，如下图 9 所示。
图 9 VCS Output (lg3d-demo-apps) - 单击可获得最大尺寸的图像
在 NetBeans 中打开 Looking Glass 项目
现在，您准备在 NetBeans 中打开 Looking Glass 项目。
在 NetBeans IDE 中，选择 File > Open Project 菜单项，如下图 10 所示。
图 10 File > Open Project
将显示“Open Project”对话框。浏览到在 CVS Checkout 中指定的工作目录，然后选择 lg3d-core 项目。注意到在 lg3d-core 文件夹和名称 lg3d-core 的旁边有一个小图标，表示它是 NetBeans 项目。图 11 中显示了“Open Project”对话框的示例，该图显示工作目录为 /home/huntch/my-lg3d。
图 11 Open Project - 单击可获得最大尺寸的图像
选择 lg3d-core 项目之后，按“Open Project Folder”按钮将 Looking Glass NetBeans 项目加载到 NetBeans IDE 中。
在 NetBeans IDE 的项目窗口中，您将看到“lg3d-core”项目，如下图 12 所示。
图 12 lg3d-core
现在，您已经成功地将 Looking Glass 项目加载到 NetBeans 中。现在可以准备在 NetBeans 中构建 Looking Glass。
在 NetBeans 中构建 Looking Glass 项目
在 NetBeans 项目窗口中，右键单击 lg3d-core 项目，然后选择“Build Project”，如下图 13 所示。
图 13 Build Project
这将启动构建 Looking Glass 项目。您将注意到 NetBeans IDE 底部的输出窗口将显示构建 Looking Glass 源文件的结果。构建 Looking Glass 的 NetBeans 输出窗口示例，如下图 14 所示。
图 14 Looking Glass 构建输出 - 单击可获得最大尺寸的图像
完成构建 Looking Glass 之后，您将在输出窗口的底部看到一条状态消息，内容是已经完成构建 Looking Glass。
现在，您已经在 NetBeans 中成功构建了 Looking Glass。接下来您将从 NetBeans 中运行 Looking Glass 窗口管理器。
在 NetBeans 中运行 Looking Glass 项目
要从 NetBeans 中运行 Looking Glass 窗口管理器，请右键单击 lg3d-core 项目，然后选择“Run Project”选项，如下图 15 所示。
图 15 正在运行的 Looking Glass
如果您已经按照本文档中所述的步骤配置您的环境，以便运行 Looking Glass 窗口管理器，而且您在 NetBeans 中已成功地构建了 Looking Glass，那么您将看到运行 Looking Glass 窗口管理器的窗口，该管理器类似于下图 16 中所显示的管理器。在本文编写时还向 Looking Glass 窗口管理器中添加了其他应用程序。因此，任务栏上的应用程序可能与图 16 中显示的应用程序稍有不同。
图 16 Looking Glass 窗口管理器 - 单击可获得最大尺寸的图像
注意，单击任务栏上的光盘图标将打开 CD 查看器，它是一个 3D 演示应用程序。如果您将鼠标放在光盘堆上并单击光盘图像，您将看到应用程序正在运行。
对于其他操作信息，请单击任务栏上 CD 查看器右侧的图标。将打开一个概述演示所支持操作的面板。注意，最左边的计算机图标会启动 xterm 窗口。该项目演示了 X11 应用程序集成，但是它并不是在所有配置中都有效。
单击最右边的颅骨和交叉骨骼的图标将退出 Looking Glass 窗口管理器。
这就是拥有构建和运行 Looking Glass 窗口管理器的环境的全部内容。是不是很有趣？
为 Looking Glass 演示程序设置 NetBeans 项目
既然您已经能够很方便地在 NetBeans 中构建和运行 Looking Glass，现在就来设置 NetBeans 项目，以便您除了能够修改 lg3d-core 的源代码之外，还可以对 lg3d-demo-apps 进行修改。
本文档中，在标题为“获得 lg3d-demo-apps 源”的部分中以前曾经检索到 lg3d-demo-apps 的源文件。本部分将设置 NetBeans 项目，因此您可以对 lg3d-demo-apps 进行修改，通过在 NetBeans 中重新构建和运行 Looking Glass 可以查看这些更改。
图 17 创建一个新项目
选择 File > New Project 菜单项之后，NetBeans IDE 将启动 New Project 向导。在 New Project 向导中，选择 General Category and Java Project with Existing Sources 项目类型，如图 18 所示。
图 18 选择包含现有源的常规 Java 项目 - 单击可获得最大尺寸的图像
按 Next 按钮转到 New Project 向导的 Name and Location 屏幕。输入项目名称。我所选的项目名称为“lg3d-demo-apps”。输入 lg3d-demo-apps 源的目录路径。lg3d-demo-apps 源是您在“获得 lg3d-demo-apps 源”一节中指定的目录。然后，取消选中“Set as Main Project”按钮。
New Project 向导（在目录中我放置了 lg3d-demo-apps 源）的屏幕快照示例，如图 19 所示。
图 19 新项目名称和项目位置 - 单击可获得最大尺寸的图像
按 Next 按钮转到 New Project 向导的 Existing Sources 屏幕。在 Existing Sources 屏幕上，您告知 NetBeans 查找 lg3d-demo-apps 源文件的位置。
通过单击 Source Package Folders 的 Add Folder 按钮来添加 lg3d-demo-apps 源文件夹。浏览到并选择 lg3d-demo-apps/src/classes 目录。我的开发环境的屏幕快照示例，如图 20 所示。
图 20 lg3d-demo-apps 源的位置 - 单击可获得最大尺寸的图像
按 Finish 按钮离开 New Project 向导。
为了利用 NetBeans 语法高亮显示、代码完成和即时编译，我们需要告知 NetBeans 查找 lg3d-core 类文件（lg3d-demo-apps 所依赖的文件）的位置。您可以通过右键单击项目窗口中为 lg3d-demo-apps 新创建的项目，然后选择“Properties”选项来做到这一点，如图 21 所示。
图 21 选择 lg3d-demo-apps 项目属性
在 Project Properties 窗口上，告知 NetBeans 查找所依赖的 lg3d-core 类文件的位置，对于类别选择“Libraries”，然后选择“Compile”选项卡，如图 22 中所示。
图 22 选择编译时库 - 单击可获得最大尺寸的图像
单击“Add Jar/Folder”按钮添加 lg3d-core/build/classes 目录。浏览到并选择 lg3d-core/build/classes 目录。该目录的路径将是以前在“获得 lg3d-core 源”一节中指定为目录的路径。
显示我使用的 lg3d-core 目录的屏幕快照示例，如图 23 所示。
图 23 选择编译时库 - 单击可获得最大尺寸的图像
按“Ok”按钮离开“Project Properties”向导。您将看到 NetBeans 用 lg3d-core 类文件更新 lg3d-demo-apps 类路径信息。
将 lg3d-demo-apps 项目展开到源文件 org.jdesktop.lg3d.apps.tapps.WebIcon.java，如图 24 所示。
图 24 展开 lg3d-demo-apps 源树
双击 WebIcon.java 文件将其加载到 NetBeans 编辑器中。通过按快捷键“F9”或选择 Build > Compile 菜单项，您可以对该文件进行编辑并直接对其进行编译。
您可以在新创建的 lg3d-demo-apps 项目下编辑任何文件以及对其进行编译。要在 Looking Glass 窗口管理器中测试对任何 lg3d-demo-apps 源代码的修改或更改，您只需右键单击项目窗口中的 lg3d-core 项目，然后从主菜单中选择 Run Project 或选择 Run > Main Project。或者您只需按“F6”即可编译所编辑的文件。记住 lg3d-core 项目就是您使用其运行 Looking Glass 窗口管理器的项目。它将自动拾取对 lg3d-demo-apps 项目所做的修改。
致谢
Looking Glass 项目团队衷心感谢 Charlie Hunt (huntch) 提供了这些说明。
$修订：1.9 $ $日期： 2005/11/30 15:44:46 $
↑返回目录
前一篇: 在 NetBeans 中为 TiVo 开发应用程序
后一篇: 通过 NetBeans 构建和运行 Java PathFinder