1.0 启动工作台
1.1 高级启动主题
1.2 在工作台的标题栏中显示工作空间位置
1.3
通过代理访问更新站点
1.4 将 WebSphere Studio V5.1 与 V5.0 工作空间配合使用
2.0 与工作台相关的已知问题
2.1 在工作台外部修改文件需要进行手工刷新
2.2 Windows 上的问题:使用 OLE 文档
2.2.1 没有对 OLE 文档正确跟踪脏状态
2.2.2 OLE 文档崩溃可能会导致 WebSphereR Studio 突然退出
2.3 用户界面不响应
2.4 从任务列表复制项
2.5 DBCS 字体问题
2.6 当为已迁移的工作空间恢复透视图时可能会遇到错误
2.7 最低显示分辨率
2.8 外部工具会自动将包含空格的路径变量引起来
2.9 可能不正确地检测了缺省文本文件编码(仅适用于 Windows XP/2000)
2.10 在多页面编辑器中更新工具栏
2.11 对于阿拉伯语键盘布局,某些快捷键不能工作
2.12 使用 V5.0 Beta 版工作空间时可能会发生与 JRE_LIB 相关的构建错误
2.13 如果从 WebSphere Studio 的另一安装导入首选项设置,则必须复位类路径变量
2.14 创建简单项目应该打开资源透视图
2.15 链接资源和多输出文件夹
2.16 不能对 AbstractTextEditor 和子类禁用覆盖方式
2.17 使用大型项目和文件
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 运行时 Ant 类路径上不再需要 Xerces JAR
6.4 定制 Ant 任务和 Ant 类型必须与插件库 JAR 分开
6.5 并发 Ant 构建不受支持
6.6 运行某些 Ant 任务将导致内存泄漏
6.7 需要输入锁定工作空间的任务
6.8 基于 Ant 1.5 的 Ant 编辑器代码补全
在安装之后,通过执行在顶级安装目录中找到的可执行程序来启动工作台。
缺省情况下,工作台将创建一个称为工作空间的目录。此目录用作项目的缺省内容区域,并用来存放任何必需的元数据。对于共享安装或多工作空间安装,应该明确声明工作空间位置而不使用缺省值。可以通过两种方法来控制工作空间的位置:使用当前工作目录,或者使用 -data 命令行自变量。
最简单的使用当前工作目录的方法是使用下列步骤来创建一个快捷方式:
其它选项包括:将 -data 自变量(例如,-data c:\myworkspace)添加到快捷方式中的目标行,或者从命令提示符处启动程序并包括 -data 自变量。
如果将 WebSphere Studio 安装在其路径中包含某些无效字符(包括 :%#<>"!. )的目录中,则它将无法启动。
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 除外)直接传递至平台以进行解释。
如果想要将工作空间位置显示在工作台的标题栏中,则必须使用以下命令来启动 WebSphere Studio:
WS_installdir\wssitedev.exe -showlocation -data c:\workspace
其中 WS_installdir 是安装 WebSphere Studio 的位置,c:\workspace 是工作空间的位置。
可以从命令提示符处使用此命令来启动 WebSphere Studio,或者更改桌面快捷方式。
要通过代理访问更新位置,将需要使用下列命令行选项来启动工作台:
wssitedev.exe -vmargs -DproxySet=true -DproxyHost=<proxy_name> -DproxyPort=<proxy_port>
当前不支持需要进行用户认证的代理。
当第一次使用现有的 WebSphere Studio V5.0 工作空间来启动 WebSphere Studio V5.1 时,将出现一个对话框,告诉您一种从 V5.0 迁移到 V5.1 的方法。单击确定以将 V5.0 工作空间迁移到 V5.1,或者单击取消以停止启动 WebSphere Studio。
当将工作空间迁移到 V5.1 时,仍然可以将工作空间与 V5.0 配合使用, 这是因为 V5.1 的新项目功能部件的元数据将被忽略,并且 V5.0 可以读取。在 V5.0 中,不能对工作空间中将影响元数据的项目进行任何更改,也不能覆盖 V5.1 项目的新项目功能部件的元数据。
有关 V5.1 中的新项目功能部件的更多信息,参阅《WebSphere Studio 迁移指南》。
以下是本发行版中与工作台用户界面相关的已知问题。
当在 WebSphere Studio 外部添加或除去了项目中的文件,或者在使用外部编辑器来修改项目中的文件时,必须手工执行刷新以便使更改显示在工作台中。为此,在“导航器”视图中选择项目,并单击其弹出菜单中的刷新。这将只刷新所选择的项目。单击 F5 以刷新所有项目。
当在工作台中使用 OLE 文档(例如,在 Word 或写字板中编辑 .doc 文件)时,已知会发生下列问题。
没有正确地更新 OLE 文档的脏状态。这会导致即使已经保存了文档内容,但是在关闭文档时工作台仍然会提示您保存文档内容。
如果 OLE 文档崩溃,则工作台菜单可能会变得不一致,或者 WebSphere Studio 可能会突然退出。
工作台用户界面由视图和编辑器组成。具有焦点的视图或编辑器将它的选项卡突出显示为蓝色。突出显示的用户界面组件拥有控制权,并且,对于编辑器来说,确定对公共工作台菜单树和操作图标集所作的添加。即,激活编辑器时,可能会有附加的菜单选项和操作图标出现在工作台用户界面上。当在编辑器中使用资源时,还可以与支持编辑器的视图(例如,支持 Java 源代码编辑器的“大纲”视图)交互作用。当视图处于焦点状态时,与编辑器相关联的菜单选项和操作图标可能会消失。要重新显示这些菜单选项和操作图标,需激活编辑器。
可以使用多种技术来激活编辑器。需要的技术可能取决于您正在使用的编辑器类型。
要激活编辑器,必须单击标题选项卡或编辑器本身的可编辑区域。
有时,在您遵循特定的单击模式后,编辑器会保持具有焦点(其标题选项卡为蓝色),即使单击别处(如另一个视图中的条目)亦如此。例如,当 DTD 编辑器打开并且可以看到“大纲”视图时,执行下列操作:
这种行为使编辑器菜单和操作图标添加项保持处于活动状态,即使在您与其它视图交互作用时亦如此。您仍然可以为视图中的所选条目请求上下文菜单。唯一的问题是蓝色标题告诉您编辑器仍然具有焦点,这似乎挺古怪。
一些编辑器会受到与如何更改焦点以及何时更改焦点相关的另一个问题的影响。当失去焦点时,将文本字段中的输入只注册为对字段的更改。如果在一个字段(例如,web.xml 编辑器中的 URI 映射字段)中输入数据,然后只单击编辑器页面的灰色区域,则不会将输入的数据看作是对该字段的更改。如果您执行下列任何操作,都会将输入的数据注册为更改:
编辑器将通过在显示在编辑器选项卡中的文件名前面添加星号(*)来告诉您已注册更改。
验证警告和错误、编译器错误和消息都显示在“任务”视图中。要将文本粘贴到文件中,请选择相关任务的行,然后将各项拖动至适当的编辑器(例如,写字板)。任务将以整洁的报告格式出现。
在正在运行 DBCS 语言的机器上,如果在“首选项”对话框中将工作台字体更改为非 DBCS 字体(例如,Arial),则 DBCS 字符将显示为问号;这是期望的行为。然而,当您将字体更改回支持 DBCS 的字体时,在设置字体时务必在字体对话框上设置脚本设置。如果没有同时设置这两者,则 DBCS 字符仍将保留为问号。此问题的另一个解决方案是在工作台字体首选项页面上单击使用系统字体按钮。
建议 DBCS 用户更改 WebSphere Studio 中用来显示文本的字体。可以在“首选项”窗口的“字体”页面(“窗口 > 首选项 > 工作台 > 字体”)中更改字体。
建议使用下列字体:
当在当前版本的 WebSphere Studio 中第一次打开使用先前版本的 WebSphere Studio 创建的工作空间时,在恢复透视图时可能会遇到错误。如果要这样做,从菜单栏选择窗口 > 复位透视图来恢复透视图。为了避免发生这些错误,在迁移到当前版本之前,关闭先前版本的 WebSphere Studio 中的工作空间中的所有透视图。
WebSphere Studio 中的许多对话框(例如,“首选项”对话框)都要求最低显示分辨率至少为 800 x 600。
当启动了外部工具时,展开的包含空格的路径变量会自动用双引号(" ")引起来。虽然 Windows 程序经常将包含空格的路径用双引号引起来,但是在其它平台上这样处理将导致问题。变通方法是为外部工具生成脚本,在使用那些参数来启动程序之前它将去掉引号。
当用户语言环境与系统语言环境不同时,显示在工作台 > 编辑器下面的“首选项”对话框中的文本文件编码值在正在运行 Windows XP(或 2000)的平台上可能是错误的。
例如,假定一个用户正在使用 Windows 2000 日语版,但是他却正在美国工作。该用户选择了美国英语作为用户语言环境。WebSphere Studio 显示的文本文件编码值 Cp1252(英语)是不正确的。它应该显示系统语言环境:MS932(日语)。
要解决此问题,可以更改用户语言环境,以便使用户语言环境和系统语言环境完全相同。在以上示例中,这就意味着应将日语设置为用户语言环境,然后重新启动 WebSphere Studio。这样,文本文件编码值就将是正确的:MS932(日语)。
对于 Windows XP:
对于 Windows 2000:
操作栏的客户机可以在它们的 IToolBarManager
(例如,多页编辑器)上创建许多 SubToolBarManagers
。客户机通常将使一个
SubToolBarManager
可视,使其余的不可视,并调用 updateActionBars
。可能不会正确更新各项的可视性。
使客户机显式地更新工具栏的一种变通方法是:
actionBars.updateActionBars();
actionBars.getToolBarManager().update(false);
对于阿拉伯语键盘布局,某些快捷键不起作用。可以通过将键盘布局更改为英语来解决此问题。
当使用 WebSphere Studio V5.0 Beta 版工作空间时,可能会发生与 JRE_LIB 相关的构建错误。要修正此错误,遵循下列步骤:
当重建项目时,就不应再发生 JRE_LIB 错误。
如果将来自 WebSphere Studio 的另一个安装的首选项设置导入 WebSphere Studio,则可能会接收到有关丢失库的编译错误。为了正确地复位类路径变量,关闭任何打开的 XML 透视图。然后,关闭工作台,重新启动它并打开 XML 透视图。
在 WebSphere Studio 中创建简单项目(文件 > 新建 > 其它 > 简单项目)时,系统应提示您切换至“资源”透视图,但您并未得到提示。要解决此问题,在创建简单项目之后手工切换到“资源”透视图(窗口 > 打开透视图 > 其它 > 资源)。
在此版本的 Websphere Studio 中,不支持链接资源和多输出文件夹。
当在工作台 > 键首选项页面上除去“切换改写方式”命令的键绑定时,当单击 Insert 键时仍然会切换该方式。编辑器的状态行中指示的方式就会与实际方式不同步。
如果使用大型项目和文件时发生 OutOfMemoryError 问题,则可以在启动 wsappdev.exe 时使用 -vmargs -Xmx500M 命令行选项增大堆大小。将 500M(500 兆)调整为适合于您的情况的数量。
以下是与编辑器相关的已知问题。
当将标记添加至未保存的文本时,如果未保存文本更改就关闭编辑器,则不能正确更新或除去那些标记。在关闭编辑器之后,那些标记可能会指向不存在或者不相关的文本区域。
缺省 HTML 和 JSP 编辑器不支持双向语言。如果您正在使用双向语言,则应将 Page Designer "Classic" 设置为 HTML 或 JSP 文件的缺省编辑器。为此,选择窗口 > 首选项 > 工作台 > 文件关联,并在此页面中更改关联。有关启用 Page Designer classic 以及更改关联的更多信息,参阅 Web 工具的自述文件。
在当 J9 上运行时,建议使用下列 VM 选项。请参阅 J9 VM 文档和帮助以获取进一步的信息:
platform [arguments] -vm <path to j9w.exe> -vmargs -ms:20 -jit -mo:32000 -mx:200000
其中 platform 是在安装的顶级目录中找到的可执行文件的名称,而 arguments 是那些要传送给平台的自变量。
注意:-vmargs 标志和实际的 VM 自变量必须出现在行末。
如果在 utc.dll 中接收到程序错误,则必须从 WebSphere Studio 的 .exe 文件来启动它。配置设置文件(与 .exe 文件在同一目录中 - 它以 .ini 结尾)在 [Environment Variables] 部分中还必须包含以下条目:
JITC_COMPILEOPT=SKIP{org/eclipse/ui/views/tasklist/TaskListContentProvider}
{resourceChanged}
如果利用在“开始”菜单中创建的快捷方式来启动 WebSphere Studio,则已经添加了该条目。
如果 Ant 脚本作为外部工具运行或者使用运行 Ant 弹出菜单来运行,则它与
WebSphere Studio 在同一 Java VM 上运行。如果正在运行的脚本执行任何将调用 System.exit(int)
的
Ant 任务,则 WebSphere Studio 会退出,并且未保存的任何工作将丢失。这些 Ant 任务的变通方法是将
Ant 配置为外部工具。下列步骤说明了如何将 Ant 配置为外部工具:
- 从 http://jakarta.apache.org/ant 下载并安装 Ant 的二进制版本。
- 单击运行 > 外部工具 > 配置。
- 单击新建。
- 为外部工具输入名称(例如,External Ant)。
- 单击浏览文件系统。
- 查找并选择一个称为
ant.bat
的文件(它应该位于 Ant 安装的 bin/ 文件夹中)。- 在工具自变量字段中,为脚本输入一些自变量,这些自变量是您通常为了在工作台外部运行脚本而输入的自变量。
- 在工作目录字段中,输入脚本的目录。
- 单击确定以退出向导。
- 要运行脚本,单击运行 > 外部工具 > 外部 Ant。
在窗口 > 首选项 > 外部工具中,在标题首选输出级别下面有一组单选按钮 - 信息、详细和调试。更改这些值一点都不会影响 WebSphere Studio。
当运行 Ant 脚本时,使用 Ant 命令行自变量 -verbose
或 -debug
来获取不是缺省值(信息)的输出级别。
通过指定 "file:"
协议,WebSphere Studio 的 Ant 用户界面可正确解析具有基于 URI 的系统值的条目。其它格式和协议(例如,相对路径和"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
(它能正确解析诸如相对路径之类的格式)时,在用户界面中才会发生此问题。
不再需要将 Xerces JAR 显式添加至运行时 Ant 类路径,并且这样做可能会产生问题。Xerces 类是从随
Eclipse 一起提供的 org.apache.xerces
插件中装入的。对于大多数 Ant 分发,
Xerces JAR 甚至不能与 ant.jar
和 optional.jar
处于同一物理位置。这是由包含清单文件的
Ant JAR(它包含指向 Xerces JAR 的类路径条目)引起的。
将定制 Ant 任务或 Ant 类型的类文件包括在插件的常规代码
JAR 中会导致问题。必须在添加至 org.eclipse.ant.core.antTasks
或
antTypes
扩展点(但是在插件的清单中未声明为库)的独立 JAR 中提供这些类文件。这样可以确保
Ant 任务和类型是由特殊的 Ant 类装入程序装入的,而不是由插件类装入程序装入的。
Eclipse 在与 WebSphere Studio 的其余部分相同的 JVM 中运行Ant。Ant 的几个方面及其对全局 Java 资源(例如,System.out 和 System.err)的使用使并发运行多个 Ant 构建变得不安全。
某些 Ant 任务会泄漏内存,这是大家都知道的。
与从命令行中使用 Ant 的情况一样,不会处理来自控制台中的输入的提示。这与利用 <input> 任务不同, <input> 任务在 WebSphere Studio 中能正确工作。
由 Ant 编辑器提供的代码补全不会考虑用户指定的 org.eclipse.ant.core
插件的版本或 ANT_HOME。代码补全建议始终都是基于 Ant 1.5 的。
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.