插件开发环境(PDE)- 发行说明

1.0 简介
2.0 已知问题与限制
    2.1 PDE XML 编辑器的源代码页面中的注释
    2.2 属性视图中的剪贴板操作
    2.3 导入片段时发生问题
    2.4 假设输出位于 bin/ 文件夹中
    2.5 首选项对于导入/导出不起作用
    2.6 剪贴板操作在“功能部件清单编辑器”中不工作
    2.7 选择计算构建路径导致不再构建 Java 项目
    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 Icons 文件夹未包括在某些 PDE 模板的 bin.includes 中
    2.19 Emacs 键绑定在清单编辑器字段中不起作用

1.0 简介

本节包含有关插件开发环境的已知问题与限制的信息。

2.0 已知问题与限制

2.1 PDE XML 编辑器的源代码页面中的注释

PDE 提供了许多包含原始源代码页面的多页编辑器。在大多数情况下,处理 XML 文件(插件、片段和功能部件清单)的编辑器将保留注释。然而,如果添加在根 XML 元素前面,或者添加在父元素中包含的最后一个子元素后面,则将不会保留注释。

2.2 属性视图中的剪贴板操作

剪贴板快捷键(Ctrl+X、Ctrl+C 和 Ctrl+V 等等)在属于“PDE 插件清单编辑器”的属性的单元格编辑器中不工作。使用弹出菜单来激活这些操作。

2.3 导入片段时发生问题

如果工作空间包含插件的二进制项目和引用该插件的片段,则会将片段库添加至被引用的插件项目的类路径。当尝试使用另一个构建的版本来覆盖插件和片段时,删除旧片段可能会失败。如果失败了,则重复该操作以修复工作空间。只有受影响的插件和片段才需要重新导入。

2.4 假设输出位于 bin/ 文件夹中

PDE 假定包含 Java 代码的所有插件和片段项目都具有一个或多个源文件夹,并且在 bin/ 文件夹中构建输出。尽管可以在“属性”对话框中更改输出文件夹的名称,但是,如果您这样做的话,PDE 运行时工作台启动程序不能正常工作。

2.5 首选项对于导入/导出不起作用

不会保留在目标平台 PDE 首选项页面中设置的首选项。因此,它们不遵从“首选项”对话框中的“导入/导出”操作。

2.6 剪贴板操作在“功能部件清单编辑器”中不工作

“功能部件清单编辑器”的 GUI 页面支持包含标准剪贴板操作(例如,剪切、复制和粘贴)的弹出菜单。然而,这些操作中的任何操作对于结构窗口小部件(树和列表)都无效。这些操作仅在信息源代码页面中的文本窗口小部件中起作用。

2.7 选择计算构建路径导致不再构建 Java 项目

PDE 通过在 build.properties 文件中查找源映射来计算插件项目的构建类路径。此文件定义如何将源文件夹编译成运行时库。如果没有此文件,则 PDE 将计算不包含源文件夹的类路径,这将导致编译错误。必需的 build.properties 文件是在创建新插件项目时由 PDE 生成的。如果插件项目是以其它方式创建的,则必须手工添加 build.properties 文件。有关 build.properties 文件的格式的详细信息,请参阅 PDE Guide。

2.8 由于插件目录路径中的版本号而使 ECLIPSE_HOME 产生易损坏的类路径

通常,构建 Eclipse 产品以使插件位于同一目录中,并且每个插件都在这样的目录中:其名称中同时包括插件标识和版本标识(例如,“org.eclipse.ui_2.0.0”)。如果在自管理时使用外部插件,则这些插件目录名显示在 PDE 生成的类路径中。这些类路径对插件版本更改敏感,如果目标平台使用其它版本号,则必须重新计算这些类路径。

2.9 插件导入向导不允许导入不同版本的插件

如果标识相同但是版本不同的两个插件只用于运行时库的话,WebSphere Studio 允许它们共存。然而,PDE 不能处理这些插件,原因是在导入二进制项目期间 PDE 使用插件标识来创建项目名。

2.10 进行插件清单语法检查所需要的 PDE 特性

如果插件项目具有 PDE 插件特性,则 PDE 将只能对插件清单提供语法检查和错误/警告标记。当 PDE 向导创建插件项目时,插件项目将自动获得此特性。仅当已经使用常规 Java 项目来主管插件时才会发生这种情况。通过将常规 Java 项目转换为 PDE 项目就可以修正此问题。

2.11 PDE 不保留原始清单文件布局

当使用 PDE 清单编辑器的非“源代码”页面时,PDE 将通过重新生成文件来把更改转换回 XML 中。尽管保留了总体内容和注释,但是未保留实际的文件布局。这可能会导致问题,即,在文件比较期间显示错误更改。如果文件布局非常重要,则在“源代码”页面中执行所有编辑。换句话说,应完全避免使用“源代码”页面。由于 XML 文件是按照遵守和保持主要元素(扩展和扩展点等)的相对顺序的方式生成的,因此,在 PDE 清单编辑器的非“源代码”页面中所作的更改不会导致在文件比较期间增加错误。

2.12 清单编辑器中的“转至行”导致“大纲”视图显示空白

当在 PDE 清单编辑器的“源代码”页面中调用了源代码 > 转至行命令时,“大纲”视图将变灰。由于“源代码”页面没有功能性的大纲,因此实际上没有丢失任何功能。

2.13 “新建功能部件”向导不生成 build.properties 文件

当创建新的功能部件项目时,PDE 向导不会自动生成 build.properties 文件。因此,构建功能部件时将创建没有任何内容的功能部件 JAR。要解决此问题,使用 PDE Guide 中提供的指示信息来手工创建 build.properties

2.14 更新类路径连接错误安装的源

Java 库根据在 PDE 首选项中指定的源代码位置来与源代码相关联。缺省情况下,这些位置是由设计时 WebSphere Studio 实例的插件注册的。如果目标平台与设计实例不相同,则这些插件提供的源代码将与库不同步。变通方法是取消选择缺省位置并定义指向目标 WebSphere Studio 安装中的源位置插件的新源代码位置。

2.15 无法指定插件库类型

PDE 清单编辑器不提供用于将运行时库类型指定为“代码”或“资源”的窗口小部件。指定此属性的唯一方法是在源代码页面中手工添加它。

2.16 通过 2 个以上的插件导出的运行时库不在类路径中

如果插件需要通过两个以上插件导出的运行时库,则在生成 build.xml 文件时不会自动将它添加到编译类路径中。示例:插件 A 导出它的库,插件 B 需要插件 A 并重新导出 A,插件 C 需要插件 B 并重新导出 B。如果插件 D 需要插件 C,则在生成 build.xml 文件时,将不会把插件 A 库添加至编译路径,即使它们在运行时可用。可按如下所示解决此问题:

  1. 使用 PDE 生成 build.xml(选择 plugin.xml 文件,并单击创建插件 JAR
  2. 编辑 build.properties 并添加下面这一行:
    custom = true
  3. build.xml 中将缺少的 JAR 添加至 javac 任务的类路径。

2.17 按“应用”时 PDE 源代码页面颜色不会生效

插件开发 > 编辑器首选项页面上按“应用”按钮之后,对 PDE 用于其多页编辑器的源代码页面的颜色的更改在打开的编辑器中不会立即可视。要解决此问题,关闭编辑器然后重新打开它。

2.18 Icons 文件夹未包括在某些 PDE 模板的 bin.includes 中

PDE 提供可用来创建全功能插件项目和/或扩展的若干模板。创建项目时,将创建具有初始内容的 build.properties 文件,包括列示插件清单及其代码 JAR 的属性“bin.includes”。但是,它没有提到该模板创建的其它文件,例如 icons/ 文件夹。作为请求,在使用 Ant 构建文件进行构建或使用“导出可部署的插件和片段”向导进行导出时,这些额外的文件不会在插件中结束。要解决此问题,在 build.properties 文件中手工添加这些文件和目录。

2.19 Emacs 键绑定在清单编辑器字段中不起作用

非缺省键绑定目前在 PDE 清单编辑器的非源代码页面上的字段中不起作用。

返回到主自述文件