通常,构建小组用户界面的第一步是实现向导页,它允许用户为插件的小组支持配置项目。 将在此处将小组提供程序的标识添加至项目的属性。通过添加至 org.eclipse.team.ui.configurationWizards 扩展点来参予项目配置。当用户选择小组 -> 共享项目... 时将显示此向导。
将在 CVS 客户机实现的上下文中看到它。下面是其配置向导的 CVS 用户界面标记:
<extension point="org.eclipse.team.ui.configurationWizards"> <wizard name="%SharingWizard.name" icon="icons/full/wizards/newconnect_wiz.gif" class="org.eclipse.team.internal.ccvs.ui.wizards.SharingWizard" id="org.eclipse.team.ccvs.ui.SharingWizard"> </wizard> </extension>
通常,插件提供一个类,该类实现扩展和标识其扩展的唯一标识。 如果要从多个提供程序中选择,则名称和图标将显示在项目配置向导的第一页中。
一旦用户选择了提供程序,下一页将显示该提供程序的特定配置信息。(如果该提供程序是安装的唯一小组提供程序, 则向导将直接跳至页面。)向导必须实现 IConfigurationWizard,它初始化指定工作台和项目的向导。余下的实现取决于向导的设计。必须收集将项目与小组支持相关联所需的所有信息。
向导完成时,必须使用 RepositoryProvider.map(IProject, String) 将小组提供程序映射至项目。 映射处理将正确的项目持久属性指定给项目这一操作。
CVS 客户机提供程序在其提供程序的 setSharing 方法中完成此操作,向导完成时将调用该方法:
public void setSharing(IProject project, FolderSyncInfo info, IProgressMonitor monitor) throws TeamException { // 确保提供的信息与项目的信息相匹配 ... // 确保提供的位置是受管的 ... // 向小组注册该项目 RepositoryProvider.map(project, CVSProviderPlugin.getTypeId()); }