工作台(IDE)- 发行说明

1.0 启动工作台
   1.1 高级启动主题
   1.2 在工作台的标题栏中显示工作空间位置
   1.3 通过代理访问更新站点
   1.4 将 WebSphere Studio V5.1 与 V5.0 工作空间配合使用
2.0 与工作台相关的已知问题
   2.1 在工作台外部修改文件时需要进行手工刷新
   2.2 用户界面不响应
   2.3 从“任务”列表复制项
   2.4 DBCS 字体问题
   2.5 最低显示分辨率
   2.6 外部工具会自动用引号将包含空格的路径变量引起来
   2.7 在多页编辑器中更新工具栏
   2.8 对于阿拉伯语键盘布局,某些快捷键不起作用
   2.9 如果 NumLock 是打开的,则控制键不起作用
   2.10 不要对同一工作空间目录运行多个工作台
   2.11 不受支持的颜色浓度错误
   2.12 在只读组合框中复制不起作用
   2.13 如果从 WebSphere Studio 的另一个安装导入首选项设置,则必须复位类路径变量
   2.14 在恢复迁移工作空间的透视图时会遇到错误
   2.15 当 Motif 为窗口视图系统时移动视图
   2.16 创建简单项目应打开“资源”透视图
   2.17 链接资源和多个输出文件夹
   2.18 KDE 采用 Ctrl+Fn 键
   2.19 不能对 AbstractTextEditor 及子类禁用改写方式
   2.20 使用大型项目和文件
3.0 与编辑器相关的已知问题
   3.1 没有正确地除去标记
   3.2 缺省 HTML 和 JSP 编辑器不支持双向语言
4.0 在不同的 VM 上运行
   4.1 在 J9 上运行
5.0 由 utc.dll 引起的程序错误
6.0 Ant
   6.1 “外部工具”首选项页面上的“首选输出级别”对于 Ant 无效
   6.2 在所有情况下,“外部工具”中的 Ant 用户界面都不会处理 ENTITY 条目
   6.3 Xerces JAR 在运行时 Ant 类路径上不再是必需的
   6.4 定制 Ant 任务和 Ant 类型必须与插件库 JAR 分开
   6.5 并发 Ant 构建不受支持
   6.6 运行某些 Ant 任务导致内存泄漏
   6.7 需要输入的任务锁定工作空间
   6.8 基于 Ant 1.5 的“Ant 编辑器”代码补全
7.0 Linux GTK 问题
   7.1 缺少某些 OS 对话框的转换
   7.2 Linux GTK 上的 DBCS 支持
   7.3 使用不同版本的 GTK
   7.4 GTK 2.2.0 上的韩国语转换问题
   7.5 调用候选值窗口后日语输入方法停止工作

1.0 启动工作台

1.1 高级启动主题

Eclipse(构建 WebSphere Studio 所基于的平台)提供了许多令开发或调试插件的人员感兴趣的执行选项。运行可执行文件的一般格式是:

platform [platform options] [-vmargs [Java VM arguments]]

其中,platform 是在安装目录的顶级目录中找到的可执行文件的名称,有效平台选项包括:

-application <app id> 标识要运行的应用程序。如果未指定,则运行工作台。应用程序由向 org.eclipse.core.runtime.applications 扩展点提供扩展的插件声明。
-boot <boot code path> 定义至引导插件代码(即,boot.jar)的路径。仅当更改 startup.jar 和 boot.jar 的相对位置时才是必需的。
-consolelog 将平台的错误日志镜像到用来运行平台的控制台。
-data <workspace path> 定义要在其上运行平台的工作空间的路径。
-debug [options file path] 将平台置于调试方式下并将调试选项装入指定的文件中。如果未给出文件路径,则平台将在平台安装目录中和工作空间的元数据目录中查找名为 .options 的文件。
-dev [classpath entries] 使平台处于开发方式下。将可选的类路径条目(用逗号分隔的列表)添加至每个插件的类路径中。例如,在开发插件时,使用 -dev bin 来为每个插件添加 JavaTM 工具的 bin 目录。冗余的或不存在的类路径条目将被清除。
-nosplash 运行平台而不显示闪屏。
-os <os-id> 定义正在其上运行平台的操作系统。通常,平台可以检测出 OS,但有些情况可能会需要进行显式指定。此处指定的值与 Platform.getOS() 相关。
-vm <vm path> 指定要用来运行平台的 Java VM。如果未指定的话,则相对于可执行文件来定位 Java VM。
-ws <ws-id> 定义正在其上运行平台的窗口系统。在许多情况下,平台可以检测出窗口系统,但有些情况可能会需要进行显式指定。此处指定的值与 Platform.getWS() 相关。

将跟在 -vmargs 条目后面(但不包括该条目)的所有自变量作为虚拟机自变量直接传递至所指示的 Java VM(即,在类运行之前)。将 -vmargs 条目前面的所有自变量(-vm-nosplash 除外)直接传递至平台以进行解释。

1.2 在工作台的标题栏中显示工作空间位置

如果想要将工作空间的位置显示在工作台的标题栏中,则必须使用以下命令来启动 WebSphere Studio:

WS_installdir\wsappdev50 -showlocation -data /workspace

其中 WS_installdir 是安装 WebSphere Studio 的位置,而 /workspace 是工作空间的位置。

可以从命令提示符处使用此命令来启动 WebSphere Studio,或者更改桌面快捷方式。

1.3 通过代理访问更新站点

要通过代理访问更新站点,将需要使用下列命令行选项启动工作台:

wsappdev50 -vmargs -DproxySet=true -DproxyHost=<proxy_name> -DproxyPort=<proxy_port>

目前不支持需要用户认证的代理。 

1.4 将 WebSphere Studio V5.1 与 V5.0 工作空间配合使用

当使用现有 When WebSphere Studio V5.0 工作空间第一次启动 WebSphere Studio V5.1 时,会出现一个对话框,显示从版本 5.0 迁移至版本 5.1 的一种方法。单击确定以将版本 5.0 工作空间迁移至版本 5.1,或者单击取消以停止启动 WebSphere Studio。

当工作空间被迁移至版本 5.1 时,仍可将该工作空间与版本 5.0 一起使用,这是因为版本 5.1 的新项目功能部件的元数据被忽略并可由版本 5.0 读取。不能在版本 5.0 中对该工作空间中的项目进行任何更改,这些更改将影响元数据或覆盖版本 5.1 项目的新项目功能部件的元数据。

有关版本 5.1 中的新项目功能部件的更多信息,参阅《WebSphere Studio 迁移指南》。

2.0 与工作台相关的已知问题

以下是本发行版中与工作台用户界面相关的已知问题。

2.1 在工作台外部修改文件时需要进行手工刷新

当在 WebSphere Studio 外部添加或除去了项目中的文件,或者当使用外部编辑器来修改项目中的文件时,必须执行手工刷新以使更改显示在工作台中。为此,在“导航器”视图中选择项目,并单击其弹出菜单中的刷新。这将只刷新所选择的项目。单击 F5 以刷新所有项目。

2.2 用户界面不响应

工作台用户界面由视图和编辑器组成。具有焦点的视图或编辑器的选项卡会突出显示为蓝色。突出显示的用户界面组件拥有控制权,并且在编辑器具有焦点的情况下,会确定对公共工作台菜单树和操作图标集所起的作用。即,激活编辑器时,可能会有附加的菜单选项和操作图标出现在工作台用户界面上。当在编辑器中使用资源时,还可能与支持该编辑器的视图(例如,支持 Java 源代码编辑器的“大纲”视图)进行交互作用。当视图具有焦点时,与编辑器相关联的菜单选项和操作图标可能会消失。要重新显示这些菜单选项和操作图标,需激活编辑器。

可以使用多种技术来激活编辑器。需要的技术可能取决于您正在使用的编辑器的类型。

要激活编辑器,必须单击标题选项卡或编辑器本身的可编辑区域。

有时,当您遵循特定的单击模式后,编辑器会保持具有焦点(其标题选项卡为蓝色),即使当您单击别处(例如,另一个视图中的条目)时亦如此。例如,当 DTD 编辑器打开并且可以看到“大纲”视图时,执行下列操作:

  1. 确保 DTD 编辑器中有内容(以便您在“设计”页面上可以看到一组控件)
  2. 单击“大纲”视图中的条目 - 视图标题应该获得焦点(变成蓝色)
  3. 单击 DTD 编辑器的标题选项卡 - 编辑器标题应该获得焦点(变成蓝色)
  4. 单击“大纲”视图中的条目 - 编辑器通常将保持具有焦点。

这种行为使编辑器菜单和操作图标添加项保持处于活动状态,即使在您与其它视图交互作用时亦如此。您仍然可以为视图中的所选条目请求上下文菜单。唯一的问题是当蓝色标题告诉您编辑器仍然具有焦点时,这似乎挺古怪。

一些编辑器会受到与如何更改焦点及何时更改焦点相关的另一个问题的影响。当失去焦点时,只将文本字段中所进行的输入注册为对字段的更改。如果在一个字段(例如,web.xml 编辑器中的 URI 映射字段)中输入数据,然后只单击编辑器页面的灰色区域,则不会将输入的数据看作是对该字段的更改。如果您执行下列任何操作,都会将输入的数据注册为更改:

编辑器将通过在显示在编辑器选项卡中的文件名前面添加星号(*)来告诉您已注册了更改。

2.3 从“任务”视图复制项

验证警告和错误、编译器错误以及消息都显示在“任务”视图中。要将文本粘贴到文件中,请选择相关任务的行,然后将各项拖动至适当的编辑器(例如,写字板)。任务将以整洁的报告格式出现。

2.4 DBCS 字体问题

如果在正在运行 DBCS 语言的机器上,在“首选项”对话框中将工作台字体更改为非 DBCS 字体(例如,Arial),则 DBCS 字符将显示为问号;这是期望的行为。然而,当您将字体改回支持 DBCS 的字体时,确保在设置字体的同时在字体对话框上设置脚本设置。如果没有同时设置这两者,则 DBCS 字符仍将保留为问号。此问题的另一个解决方案是在工作台字体首选项页面上单击使用系统字体按钮。

建议 DBCS 用户更改 WebSphere Studio 中用来显示文本的字体。可以在“首选项”窗口的“字体”页面(窗口 > 首选项 > 工作台 > 字体)中更改字体。

建议使用下列字体:

2.5 最低显示分辨率

WebSphere Studio 中的许多对话框(例如,“首选项”对话框)都要求最低显示分辨率至少为 800 x 600。

2.6 外部工具会自动用引号将包含空格的路径变量引起来

当启动了外部工具时,包含空格的扩展路径变量会自动用双引号(" ")引起来。虽然 Windows 程序通常将包含空格的路径用引号引起来,但是在其它平台上这样处理会导致问题。变通方法是为外部工具生成脚本,该脚本将在启动具有那些参数的程序之前去掉引号。

2.7 在多页编辑器中更新工具栏

操作栏的客户机可以在它们的 IToolBarManager(例如,多页编辑器)上创建许多 SubToolBarManagers。客户机通常将使一个 SubToolBarManager 可视,使其余的不可视,并调用 updateActionBars。各项的可视性可能不会正确更新。

使客户机显式地更新工具栏的一种变通方法是:

actionBars.updateActionBars();
actionBars.getToolBarManager().update(false);

2.8 对于阿拉伯语键盘布局,某些快捷键不起作用

对于阿拉伯语键盘布局,某些快捷键不起作用。可以通过将键盘布局更改为英语来解决此问题。

2.9 如果 NumLock 是打开的,则控制键不起作用

如果 Ctrl-s、Ctrl-空格键或其它 Ctrl 键组合不起作用,按 NumLock 键以关闭 NumLock。

2.10 不要对同一工作空间目录运行多个工作台

使用同一工作空间目录启动工作台两次是无效的。这样做将得出不可预测的结果。工作空间目录的缺省位置为 ~/workspace,可通过使用类似如下的 -data 标志指定另一个目录来覆盖它:wsappdev50 -data /home/username/newworkspace。

2.11 不受支持的颜色浓度错误

启动工作台时,如果接收到有关不受支持的颜色浓度的错误,则必须将显示器的颜色浓度更改为除 15 或 32 bpp 以外的值。这需要重新启动 X 服务器。查阅系统文档以获取有关执行此操作的指示信息。

2.12 在只读组合框中复制不起作用

从只读组合框复制文本目前在 Linux 上不起作用。

2.13 如果从 WebSphere Studio 的另一个安装导入首选项设置,则必须复位类路径变量

如果将来自 WebSphere Studio 的另一个安装的首选项设置导入 WebSphere Studio,则可能会收到指示缺少库的编译错误。为了正确地复位类路径变量,关闭任何打开的 XML 透视图。然后,关闭工作台,重新启动它并打开 XML 透视图。

2.14 在恢复迁移工作空间的透视图时会遇到错误

在当前版本的 WebSphere Studio 中第一次打开使用先前版本的 WebSphere Studio 创建的工作空间时,可能会在恢复透视图时遇到错误。如果遇到这些错误,从菜单栏选择窗口 > 复位透视图来恢复透视图。要避免这些错误,在迁移至当前版本之前关闭先前版本的 WebSphere Studio 中的工作空间中的所有透视图。

2.15 当 Motif 为窗口视图系统时移动视图

如果在 Linux 上使用 WebSphere Studio 且窗口视图系统为 Motif,则必须使用鼠标中间按钮选择视图才能来回移动该视图。否则,如果使用两个按钮的鼠标,则在选择想要移动的视图时同时按住两个按钮。

2.16 创建简单项目应打开“资源”透视图

在 WebSphere Studio 中创建简单项目(文件 > 新建 > 其它 > 简单项目)时,系统应提示您切换至“资源”透视图,但您并未得到提示。要解决此问题,在创建简单项目之后手工切换至“资源”透视图(“窗口”>“打开透视图”>“其它”>“资源”)。

2.17 链接资源和多个输出文件夹

链接资源和多个输出文件夹在此版本的 Websphere Studio 中不受支持。

2.18 KDE 采用 Ctrl+Fn 键

在 Linux 系统上使用 KDE 桌面时,Ctrl+Fn 键序列将用于在虚拟桌面之间进行切换。这意味着绑定至这些键序列(包括 Ctrl+F1(“帮助”)、Ctrl+F4(“文件”>“关闭”)和 Ctrl+F6(“下一个编辑器”))的 WebSphere Studio 命令不会激活。

可使用“控制中心”在 KDE 中重新指定这些键。选择外观 > 快捷键 > 快捷键方案 > 快捷键序列 > 系统 > 桌面切换,并将所有项设置为或设置为不同的键序列(例如,Ctrl+Alt+Fn)。另一种备用方法是在 WebSphere Studio 中使用窗口 > 首选项 > 工作台 > 键首选项页面来指定不同的键序列。

2.19 不能对 AbstractTextEditor 及子类禁用改写方式

工作台 > 键首选项页面上除去“切换改写方式”命令的键绑定后,单击 Insert 键时仍会切换该方式。编辑器的状态行中的方式指示就会与实际方式不同步。

2.20使用大型项目和文件

如果在使用大型项目和文件时存在 OutOfMemoryError 问题,可通过在启动 WebSphere Studio 时使用 -vmargs -Xmx500M 命令行选项增加堆大小。将 500M(500 兆字节)调整为适合于您的情况的数量。

3.0 与编辑器相关的已知问题

以下是与编辑器相关的已知问题。

3.1 没有正确地除去标记

当将标记添加至未保存的文本时,如果未保存文本更改就关闭编辑器,则不能正确更新或除去那些标记。在关闭编辑器之后,那些标记可能会指向不存在或者不相关的文本区域。

3.2 缺省 HTML 和 JSP 编辑器不支持双向语言

缺省 HTML 和 JSP 编辑器不支持双向语言。如果您正在使用双向语言,则应将 Page Designer "Classic" 设置为 HTML 或 JSP 文件的缺省编辑器。为此,选择窗口 > 首选项 > 工作台 > 文件关联,并在此页面中更改关联。有关启用 Page Designer Classic 以及更改关联的更多信息,参阅 Web 工具的自述文件。

4.0 在不同的 VM 上运行

4.1 在 J9 上运行

在 J9 上运行时,建议使用下列 VM 选项。请参阅 J9 VM 文档和帮助以获取进一步的信息:

platform [arguments] -vm <path to j9w.exe> 
            -vmargs -ms:20 -jit -mo:32000 -mx:200000

其中,platform 是在安装的顶级目录中找到的可执行文件的名称,而 arguments 是那些要传递给平台的自变量。

注意:-vmargs 标志和实际的 VM 自变量必须出现在行末。

5.0 由 utc.dll 引起的程序错误

如果在 utc.dll 中接收到程序错误,则必须从 WebSphere Studio 的 .exe 文件来启动它。配置设置文件(与 .exe 文件在同一目录中 - 它以 .ini 结尾)还必须在 [Environment Variables] 部分中包含以下条目:

JITC_COMPILEOPT=SKIP{org/eclipse/ui/views/tasklist/TaskListContentProvider}
        {resourceChanged}

如果利用在“开始”菜单中创建的快捷方式来启动 WebSphere Studio,则已经添加了该条目。

6.0 Ant

如果 Ant 脚本作为外部工具运行或者使用运行 Ant 弹出菜单来运行,则它在与 WebSphere Studio 相同的 Java VM 上运行。如果正在运行的脚本执行任何调用 System.exit(int) 的 Ant 任务,则 WebSphere Studio 会退出,并且任何未保存的工作将丢失。对于这些 Ant 任务的变通方法是将 Ant 配置为外部工具。下列步骤显示如何执行此操作:

  1. http://jakarta.apache.org/ant 下载并安装 Ant 的二进制版本。
  2. 单击运行 > 外部工具 > 配置
  3. 单击新建
  4. 为外部工具输入名称(例如,External Ant)。
  5. 单击浏览文件系统
  6. 查找并选择一个称为 ant.bat 的文件(它应该位于 Ant 安装的 bin/ 文件夹中)。
  7. 工具自变量字段中,为脚本输入一些自变量,这些自变量是您通常为了在工作台外部运行脚本而输入的自变量。
  8. 工作目录字段中,输入脚本的目录。
  9. 单击确定以退出向导。
  10. 要运行脚本,单击运行 > 外部工具 > External Ant

6.1 “外部工具”首选项页面上的“首选输出级别”对于 Ant 无效

窗口 > 首选项 > 外部工具中,在标题首选输出级别下面有一组单选按钮 - 信息详细调试。更改这些值不会以任何方式影响 WebSphere Studio。

当运行 Ant 脚本时,使用 Ant 命令行自变量 -verbose-debug 来获取不同于缺省值(信息)的输出级别。

6.2 在所有情况下,“外部工具”中的 Ant 用户界面都不会处理 ENTITY 条目

WebSphere Studio 的 Ant 用户界面可正确解析具有基于 URI 的系统值(指定 "file:" 协议)的条目。其它格式和协议(例如,相对路径和 "http:" URI 等等)是由用户的缺省 XML 解析器解析的,它可以随 JRE 和用户设置等而变化。解析器(例如,org.apache.crimson.parser)只期望有效的 URI,并且对于如下所示的实体引用将失败:

<!ENTITY custom SYSTEM "../../custom.xml">

此问题的变通方法是确保将 "file:" 协议说明符添加至相对路径,如下所示:

<!ENTITY custom SYSTEM "file:../../custom.xml">

此问题仅在用户界面中发生,因为 WebSphere Studio 的 Ant 执行引擎使用 SAXParser,它可以正确解析诸如相对路径之类的格式。

6.3 Xerces JAR 在运行时 Ant 类路径上不再是必需的

将 Xerces JAR 显式添加至运行时 Ant 类路径不再是必需的,并且会导致问题。Xerces 类会从随 Eclipse 提供的 org.apache.xerces 插件装入。对于大多数 Ant 分发,Xerces JAR 甚至不能与 ant.jaroptional.jar 位于同一物理位置。这是由于 Ant JAR 包含清单文件而该清单文件包含指向 Xerces JAR 的类路径条目造成的。

6.4 定制 Ant 任务和 Ant 类型必须与插件库 JAR 分开

将定制 Ant 任务或 Ant 类型的类文件包括在插件的常规代码 JAR 中将导致问题。必须在单独的 JAR 中提供这些类文件,而这一 JAR 又必须用于 org.eclipse.ant.core.antTasksantTypes 扩展点(且未在插件的清单中声明为库)。这确保 Ant 任务和类型是由特殊 Ant 类装入程序装入的,而不是由插件类装入程序装入的。

6.5 并发 Ant 构建不受支持

Eclipse 在与 WebSphere Studio 的其余部分相同的 JVM 中运行 Ant。Ant 的几个方面及其对全局 Java 资源(例如,System.out 和 System.err)的使用使并发运行多个 Ant 构建变得不安全。

6.6 运行某些 Ant 任务导致内存泄漏

已知某些 Ant 任务会使内存泄漏。

6.7 需要输入的任务锁定工作空间

如同从命令行使用 Ant 一样,提示从控制台输入不会被处理。这与使用 <input> 任务不同,该任务在 WebSphere Studio 内正常工作。

6.8 基于 Ant 1.5 的“Ant 编辑器”代码补全

Ant 编辑器提供的代码补全与用户指定的 org.eclipse.ant.core 插件或 ANT_HOME 的版本无关。 代码补全建议总是基于 Ant 1.5。

7.0 Linux GTK 问题

以下是 Linux GTK 问题。

7.1 缺少某些 OS 对话框的转换

用来选择文件或文件夹的操作系统对话框在 GTK 2.0.6 或 GTK 2.2 上只能进行部分转换。这些对话框和未转换的消息来自 GTK 而不是 WebSphere Studio。

7.2 Linux GTK 上的 DBCS 支持

随 Red Hat Linux 8.0 和 SuSE Linux 8.1 提供的 GTK 的版本支持 Latin-1 语言环境,但不支持 DBCS。GTK 2.2 中的 DBCS 支持应该是足够的,并且,原则上 WebSphere Studio 应该在具有 GTK 2.2 的任何最新 Linux 版本上工作。

7.3 使用不同版本的 GTK

下载和编译 GTK 的新版本(例如,要在 RedHat 8.0 上获取 GTK 2.2.0 中的 DBCS 支持)的用户将需要确保 LD_LIBRARY_PATH 环境变量中列示了正确的 GTK 库。缺省情况下,编译的 GTK 库放在 /user/local/lib/ 中,所以在启动 WebSphere Studio 之前需要执行下列操作:

export LD_LIBRARY_PATH=/usr/local/lib/

注意:必须对每个新的终端会话执行此操作。

7.4 GTK 2.2.0 上的韩国语转换问题

下载和编译 GTK 的新版本(例如,要获取 GTK 2.2.0 中的 DBCS 支持)的用户可能会遇到下列使用韩国语转换的问题:

建议将对话框字体条幅字体设置为 gothic 字体。可以在工作台 > 字体首选项页面中更改字体。

要解决调整窗口大小的问题,建议设置高屏幕分辨率(例如,1280x1024)。

要解决“属性”视图问题,改为使用箭头键。使用左箭头键来折叠各项,使用右箭头键来展开它们。 

7.5 调用候选值窗口后日语输入方法停止工作

如果在 GTK 版本上对日语汉字输入使用 kinput2 和 canna,日语输入方法有时会停止工作。仅当打开“候选值选择窗口”后才会发生这种情况。发生这种问题时,需要关闭一次“编辑器”或“视图”,然后重新打开它以再次启用该输入方法。

要避免此问题,需要使用另一种输入方法,如 wnn。

返回到主自述文件