1.0 简介
2.0 已知问题与限制
2.1 PDE XML 编辑器的源代码页面中的注释
2.2 属性视图中的剪贴板操作
2.3 导入片段时发生问题
2.4 假设输出位于 bin/ 文件夹中
2.5 首选项对于导入/导出不起作用
2.6 剪贴板操作在“功能部件清单编辑器”中不工作
2.7 选择计算构建路径导致不再构建 JavaTM 项目
2.8 由于插件目录路径中的版本号而使 ECLIPSE_HOME 产生易损坏的类路径
2.9 插件导入向导不允许导入不同版本的插件
2.10 进行插件清单语法检查所需要的 PDE 特性
2.11 PDE 不保留原始清单文件布局
2.12 清单编辑器中的转至行导致大纲视图显示空白
2.13 新建功能部件向导不生成 build.properties 文件
2.14 更新类路径连接错误安装的源
2.15 无法指定插件库类型
2.16 通过 2 个以上的插件导出的运行时库不在类路径中
2.17 按“应用”时 PDE 源代码页面颜色不会立即生效
2.18 某些 PDE 模板的 bin.includes 中不包括 Icons 文件夹
2.19 Emacs 键绑定在清单编辑器字段中不起作用
本节包含有关插件开发环境的已知问题与限制的信息。
PDE 提供了许多包含原始源代码页面的多页编辑器。在大多数情况下,处理 XML 文件(插件、片段和功能部件清单)的编辑器将保留注释。然而,如果添加在根 XML 元素前面,或者添加在父元素中包含的最后一个子元素后面,则将不会保留注释。
剪贴板快捷键(Ctrl+X、Ctrl+C 和 Ctrl+V 等等)在属于“PDE 插件清单编辑器”的属性的单元格编辑器中不工作。使用弹出菜单来激活这些操作。
如果工作空间包含插件的二进制项目和引用该插件的片段,则会将片段库添加至被引用的插件项目的类路径。当尝试使用另一个构建的版本来覆盖插件和片段时,删除旧片段可能会失败。如果失败了,则重复该操作以修复工作空间。只有受影响的插件和片段才需要重新导入。
PDE 假定包含 Java 代码的所有插件和片段项目都具有一个或多个源文件夹,并且在 bin/ 文件夹中构建输出。尽管可以在“属性”对话框中更改输出文件夹的名称,但是,如果您这样做的话,PDE 运行时工作台启动程序不能正常工作。
不会保留在目标平台 PDE 首选项页面中设置的首选项。因此,它们不遵从“首选项”对话框中的“导入/导出”操作。
“功能部件清单编辑器”的 GUI 页面支持包含标准剪贴板操作(例如,剪切、复制和粘贴)的弹出菜单。然而,这些操作中的任何操作对于结构窗口小部件(树和列表)都无效。这些操作仅在信息和源代码页面中的文本窗口小部件中起作用。
PDE 通过在 build.properties
文件中查找源映射来计算插件项目的构建类路径。此文件定义如何将源文件夹编译成运行时库。如果没有此文件,则 PDE 将计算不包含源文件夹的类路径,这将导致编译错误。必需的 build.properties
文件是在创建新插件项目时由 PDE 生成的。如果插件项目是以其它方式创建的,则必须手工添加 build.properties
文件。有关 build.properties
文件的格式的详细信息,请参阅 PDE Guide。
通常,构建 Eclipse 产品以使插件位于同一目录中,并且每个插件都在这样的目录中:其名称中同时包括插件标识和版本标识(例如,“org.eclipse.ui_2.0.0
”)。如果在自管理时使用外部插件,则这些插件目录名显示在 PDE 生成的类路径中。这些类路径与插件版本更改有关,如果目标平台使用其它版本号,则必须重新计算这些类路径。
如果标识相同但是版本不同的两个插件只用于运行时库的话,WebSphere Studio 允许它们共存。然而,PDE 不能处理这些插件,原因是在导入二进制项目期间 PDE 使用插件标识来创建项目名。
如果插件项目具有 PDE 插件特性,则 PDE 将只能对插件清单提供语法检查和错误/警告标记。当 PDE 向导创建插件项目时,插件项目将自动获得此特性。仅当已经使用常规 Java 项目来主管插件时才会发生这种情况。通过将常规 Java 项目转换为 PDE 项目就可以修正此问题。
当使用 PDE 清单编辑器的非“源代码”页面时,PDE 将通过重新生成文件来把更改转换回 XML。尽管保留了总体内容和注释,但是未保留实际的文件布局。这可能会导致问题,即,在文件比较期间显示错误更改。如果文件布局非常重要,则在“源代码”页面中执行所有编辑。换句话说,应完全避免使用“源代码”页面。由于 XML 文件是按照遵守和保持主要元素(扩展和扩展点等)的相对顺序的方式生成的,因此,在 PDE 清单编辑器的非“源代码”页面中所作的更改不会导致在文件比较期间增加错误。
当在 PDE 清单编辑器的“源代码”页面中调用了源代码 > 转至行命令时,“大纲”视图将变灰。由于“源代码”页面没有起作用的概述,因此实际上没有丢失任何功能。
当创建新的功能部件项目时,PDE 向导不会自动生成 build.properties
文件。因此,构建功能部件时将创建没有任何内容的功能部件 JAR。要解决此问题,使用 PDE Guide 中提供的指示信息来手工创建 build.properties
。
Java 库根据在 PDE 首选项中指定的源代码位置来与源代码相关联。缺省情况下,这些位置是由设计时 WebSphere Studio 实例的插件注册的。如果目标平台与设计实例不相同,则这些插件提供的源代码将与库不同步。变通方法是取消选择缺省位置并定义指向目标 WebSphere Studio 安装中的源位置插件的新源代码位置。
PDE 清单编辑器不提供用于将运行时库类型指定为“代码”或“资源”的窗口小部件。指定此属性的唯一方法是在源代码页面中手工添加它。
如果插件需要通过两个以上插件导出的运行时库,则在生成 build.xml
文件时不会自动将它添加到编译类路径中。示例:插件 A 导出它的库,插件
B 需要插件 A 并重新导出 A,插件 C 需要插件
B 并重新导出 B。如果插件 D 需要插件 C,则在生成 build.xml
文件时,将不会把插件
A 库添加至编译路径,即使它们在运行时可用。可按如下所示解决此问题:
- 使用 PDE 生成
build.xml
(选择plugin.xml
文件,并单击创建插件 JAR)- 编辑
build.properties
并添加下面这一行:
custom = true- 在
build.xml
中将缺少的 JAR 添加至 javac 任务的类路径。
在按了插件开发 > 编辑器首选项页面上的“应用”按钮之后,在打开的编辑器中不能立即看到 PDE 对它的多页编辑器的源代码页面所作的颜色更改。要解决此问题,应关闭编辑器然后再打开它。
PDE 提供了一些模板,可以使用这些模板来创建全功能的插件项目和/或扩展。当创建了项目时,为 build.properties
文件创建了初始内容,这包括属性“bin.includes”,该属性列示插件清单及其代码 JAR。但是,它省略了由模板创建的其它文件(例如,icons/
文件夹)的叙述。作为一项要求,当使用 Ant 构建文件进行构建或者使用“导出可部署的插件和片段”向导来导出时,这些额外的文件不要在插件中结束。要解决此问题,应在
build.properties 文件中手工添加这些文件和目录。
非缺省键绑定当前在 PDE 清单编辑器的非源代码页面上的字段中不起作用。
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.