插件清单.docxVIP

2.3?? 评审生成代码通过查看由New Plug-in Project项目向导生成的代码展示了示例插件的以下主要部分：插件清单插件类Favorites视图2.3.1?? 插件清单（1）插件清单编辑器显示了插件的两个清单文件—META-INF/MANIFEST.MF 和plugin.xml的内容。这两个文件定义了插件与系统其他部分的关系。创建了该新插件项目之后，该编辑器将自动打开它的第一个页面（图2-9）。如 果插件清单文件编辑器被关闭了，双击METAINF/MANIFEST.MF或plugin.xml文件将重新打开该编辑器。以下是清单文件编辑器的概 述，而插件清单文件的更多细节在第3章。虽然编辑器是一个便利的修改插件描述的方法，但查看源代码以了解编辑器的不同部分是如何与底层代码相关的仍然具有一定意义。点击 MANIFEST.MF选项卡，以显示META-INF/MANIFEST.MF文件的源代码。该文件定义了插件的运行时相关内容（图2-7）。头两行定 义清单文件是一个OSGi 清单文件（参见3.3节）。之后的行定义了插件名称、版本、标识符、classpath和所依赖的插件。所有这些内容都可以在插件清单编辑器的其他页面进 行编辑。Eclipse 3.4新增内容?? MANIFEST.MF文件中的Eclipse-LazyStart: true指令已经由Bundle-ActivationPolicy: lazy替代。两条指令具有相同的含义，只是名称变了。点击编辑器的plugin.xml选项卡将显示plugin.xml文件。该文件定义了插件的扩展内容（图2-8）。第一行声明这是一个XML文件，之后的行定义插件扩展项。清单编辑器的Overview页显示了插件清单的总览（图2-9）。该页面的内容描述了插件的一般信息，如插件标识符（ID）、版本、名称、类和提供者，这些内容对应于META-INF/MANIFEST.MF文件的第一部分：Bundle-Name: Favorites Plug-inBundle-SymbolicName: com.qualityeclipse.favorites; singleton:=trueBundle-Version: 1.0.0Bundle-Activator: com.qualityeclipse.favorites.FavoritesActivatorBundle-Vendor: QualityEclipseBundle-RequiredExecutionEnvironment: JavaSE-1.5你可以在Overview页面编辑相关信息，也可以切换至MANIFEST.MF页面以直接编辑源代码。提示?? 在除了plugin.xml和MANIFEST.MF页面之外的所有页面做出更改都将导致清单编辑器重新格式化源代码。如果你对于清单文件的格式有特殊要 求，那只有两种选择：一是只使用plugin.xml和MANIFEST.MF页面来进行编辑；二是使用另一种编辑器。警告?? META-INF/MANIFEST.MF文件的格式规则包括许多有关于行长度和行包裹的非直观规则。请小心编辑plugin.xml，但对于META-INF/MANIFEST.MF文件，则要慎重！2.3.1?? 插件清单（2）本插件与系统中其他插件的依赖关系出现于插件清单编辑器中的Dependencies页面（图2-10）。这对应于META-INF/MANIFEST.MF文件源代码的Require-Bundle部分：Require-Bundle:?org.eclipse.ui, ??org.eclipse.core.runtime?对于Favorites插件而言，这一部分表明了org.eclipse.core.runtime和org.eclipse.ui插件的依赖关 系。该依赖性声明随着Favorites项目的Java编译路径（也称为编译时classpath）而改变。这是因为Java编译路径是编译时组件，而插 件依赖性声明只在插件执行时才发挥作用。其中的原因在于该项目是作为插件项目创建，并具有org.eclipse.pde.PluginNature性质 （参见14.3节以了解更多有关项目特性的信息）。任何对依赖项列表做出的更改将会自动在Java编译路径中体现，这样，你就可以拥有一个可以编译、创建 但还不能正确执行的插件了。提示?? 请编辑该依赖项列表而不是Java编辑路径，这样这两者可以总是自动保持同步。此外，依赖项还可能表现为清单编辑器Dependencies页面的Imported Packages（图2-10和3.3.3节的结尾部分）中。这将对应于META-INF/MANIFEST.MF文件的Import-Package部分，如下所示：Im