[Best Practice]如何在SharePoint团队开发中利用WSPBuilder

From:http://blog.joycode.com/ipark/archive/2009/01/15/115435.joy

 

WSPBuilder

到目前为止,我觉得WSPBuilder是SharePoint社区中最好的辅助开发工具之一(VSeWSS 1.3 CTP版本有一些功能就是“模仿”了WSPBuilder,呵呵)。

WSPBuilder的特点是根据文件夹结构来生成WSP文件,这是我个人觉得WSPBuilder最好的特性,也是最有用的功能。现在,CodePlex上WSPBuilder提供了Visual Studio Addin的安装项目,该Extensions也可以在Visual Studio 2008上使用,该Extensions使得WSPBuilder更好的融合到Visual Studio的开发操作中,安装完“WSPBuilder Extensions 1.03 - Visual Studio Addin (0.9.8.0830)”后,你打开Visual Studio可以有如下WSPBuilder项目:

image

在创建好的WSPBuilder项目后,右键点击项目可以看到以下WSPBuilder菜单:

image

以上菜单中,值得注意的是以下两个:

> Build WSP: 创建WSP文件,仅仅是创建而已,不会帮你部署!有很多时候我们其实只需要WSP文件(使用VSeWSS的人应该很希望VSeWSS也能这样)

> Attach to IIS Worker Processes: 不用在点好几步,然后查找w3wp.exe进程,然后附加了,只要点一下即可开始调试!

 

SharePoint的团队开发

在SharePoint团队开发,我感觉比较焦点的话题有几点:

0)团队开发怎么个模式比较好;

这个请先看看http://msdn.microsoft.com/en-us/library/bb428899.aspx

然后,我补充一点我个人的看法:

> 你会需要一个集中代码管理服务器,SharePoint开发集成环境,SharePoint测试服务环境,然后你会想要自动编译部署(WSPBuilder为你的这个愿望提供了很好的基础)

> 我偏向于程序员每个人都有自己的SharePoint开发环境(与生产环境相同的版本),环境中的Visual Studio有Web Application开发模板,安装WSPBuilder 的Visual Studio Extensions。

> 如果有条件开发人员的SharePoint环境使用虚拟机为好(如果SharePoint环境坏了,恢复快,好处肯定不止这个)。

> 另外,开发人员应该有一个非Windows Server的环境(用来自己做测试用,模拟一个真正的开发机和客户机环境,所有的开发测试都在SharePoint环境里面做是不明智的,很多时候你会发现当用客户机访问的时候,问题才能暴露)。也就是说,或者开发人员本机是非Windows Server环境,虚机是SharePoint开发环境;或者是本机是SharePoint环境,有一个非Windows Server的虚机环境。

1)开发的各种SharePoint部件(事件处理、Web Part、模板等)怎么方便的组合起来集成部署(知道用WSP,但是总是没有找到比较好的实施的方法);

做Solution Package的最主要的问题在于

a、如何正确的使用Solution Schema里的Element来部署不同的开发产出;

b、编写正确的manifest.xml文件,打包成WSP文件

WSPBuilder的好处就在于,你需要做的就是把开发出来的东西放对文件夹!其他一切交给WSPBuilder

使用WSPBuilder自己的模板创建出来的项目,WSPBuilder会自动生成正相应的文件夹结构

image

所以,我的做法是使用WSPBuilder项目加上Visual Studio的Post-Event来满足要求:

1、专门创建一个WSPBuilder Project,作为维护创建WSP文件的文件夹结构的项目(也就是说专门用来生成WSP文件的项目);

2、为不同的功能模块(某个Web Part、事件处理程序等)创建不同的项目,这样方便进行代码管理,工作分配,多人协作,创建的项目加入到第一步创建的解决方案中;

3、然后接着就是在WSPBuilder Project项目中,创建文件夹,直到每个功能模块对应的项目都能在该项目中找到相应的文件夹;对于每个功能模块对应的项目则在Post-Built中加入命令行脚本,使在编译通过以后,把编译的结果拷贝到第一步创建的项目的文件夹目录下。

---------------------------------例子开始了----------------------------

举个例子,你创建一个WSPBuilder的项目作为维护生成WSP文件的项目:

image

创建一个Web Part项目(用的是VSeWSS的Web Part模板),加入到解决方案中

image

在WSPBuilder项目中,添加一个叫DemoWebPartFeature的Blank Feature:

image

image

解决方案变成:

image

我会把自动生成的elements.xml文件删除,然后修改feature.xml文件:

把ElementManifests节改成以下样子:

<ElementManifests>
  <ElementManifest Location="WebPart1.xml"/>
  <ElementFile Location="WebPart1.webpart"/>
</ElementManifests>

然后在WSPBuilder项目中创建出80\bin目录,这时候解决方案样子如下:

image 

然后,对DemoWebPart项目做一些设置,首先把WebPart1.webpart和WebPart1.xml文件的属性改成“Copy Always”,这样在该项目的Debug目录中会出现这两个文件:

image

接下来,就是在Post-built中添加Copy命令行,把生成的文件拷贝到WSPBuilder项目对应的文件夹下:

copy "$(TargetDir)DemoWebPart.dll" "$(SolutionDir)WSPBuilder\80\bin\";
copy "$(TargetDir)WebPart1\WebPart1.xml" "$(SolutionDir)WSPBuilder\12\Template\Features\DemoWebPartFeature";
copy "$(TargetDir)WebPart1\WebPart1.webpart"  "$(SolutionDir)WSPBuilder\12\Template\Features\DemoWebPartFeature";

这样,整个项目的初始创建和设置就完成了,把项目迁入到代码管理服务器中,以后就不需要再改动这些设置了。

当你编译DemoWebPart项目的时候,WSPBuilder项目的文件夹下就会是如下样子:

image

在WSPBuilder项目的文件夹里面就已经有了所有DemoWebPart相关的文件了,然后我们可以在WSPBuilder项目中创建WSP文件(Deploy和Upgrade菜单在第一次点击Build WSP后才会变成可用)

image

所有在WSPBuilder解决方案中的项目右键点击都会出现以上菜单,可以方便的点击“Attach to IIS Worker Processes”来调试。

---------------------------------例子结束了----------------------------

这样的话

> 开发人员的工作过程就是:从代码管理服务器上获取解决方案的最新版本,然后迁出自己开发的项目,直接选择Deploy Solution,WSP会生成并自动部署到他的环境中,然后在代码中设置断点,点击“Attach to IIS Worker Processes”即可进行调试。

> 集成人员的工作过程:从代码管理服务器上获取最新的项目版本,然后Build WSP,把WSP部署到开发集成服务器上。这个过程,大家可以想象,使用自动build部署的方案完全是可以完成的。

2)可视化Web Part开发的最佳实践;(下一篇文章,我会介绍一个WSPBuilder和QuickPart合作进行Web Part开发的好方法)

打印 | 张贴于 2009-01-15 23:55:07 | Tag:SharePoint

留言反馈

#feature激活出错 编辑

楼主你好,

我按你博文里说的按部就班的做

项目发布成功,管理中心中解决方案已经部署,网站功能中也有相应的Feature但是在激活Feature的时候报错。

错误信息如下:

未能实例化模块“WebParts”的文件“WebPart1.webpart”: 指定的列表不存在。

这是怎么回事啊?

 

谢谢指教!

2009-08-04 17:33:07 | hollydsj
#re:[Best Practice]如何在SharePoint团队开发中利用WSPBuilder 编辑

楼主你好!

我刚开始学习sharepoint不久,发现sharepoint部署起来实在太麻烦。所以上网找部署的相关资料,看了你的这篇文章,发现wspbuilder的确是个好东西。

 

可是很遗憾,我好像找不到你说的WSPBuilder Extensions 1.03 - Visual Studio Addin (0.9.8.0830),

我的机子是32位的,我也下了CodePlex上的代码,可是全都编译不通过(缺了很多东西,我没能找到)

 

不知楼主能否提供一个现成的WSPBulider Extensions 的安装程序,谢谢。

2009-08-03 16:57:27 | hollydsj
#re:[Best Practice]如何在SharePoint团队开发中利用WSPBuilder 编辑

能否帮忙写一个WSPBuilder的中文使用文档呢

安装wspbuilder是不是就不用安装微软的那个extension了

 

2009-02-06 13:24:16 | virusswb
#re:[Best Practice]如何在SharePoint团队开发中利用WSPBuilder 编辑

应该是找不到site和web的原因吧

用微软的extension的时候还要配置项目的启动操作,的使用URL启动浏览器为sharepoint网站site的URL,这个wspbuilder好像没有地方设置

2009-02-06 13:23:23 | virusswb
#re:[Best Practice]如何在SharePoint团队开发中利用WSPBuilder 编辑

Build WSP报错,提示值不在预期范围

2009-02-06 13:17:39 | virusswb
#re:[Best Practice]如何在SharePoint团队开发中利用WSPBuilder 编辑

这个插件安装在2005呢还是2008呢,有没有影响呢

2009-02-06 13:14:28 | virusswb
#re:[Best Practice]如何在SharePoint团队开发中利用WSPBuilder 编辑

我的WSPBuilder菜单中的deploy和upgrade都是灰的

不可用是怎么回事呢

谢谢

2009-02-06 13:06:30 | virusswb
#re:[Best Practice]如何在SharePoint团队开发中利用WSPBuilder 编辑

我的WSPBuilder菜单中的deploy和upgrade都是灰的

不可用是怎么回事呢

posted on 2009-11-26 22:15  黑木 Kang  阅读(350)  评论(0编辑  收藏  举报

导航