如何生成WebPart的部署文件（wsp文件）
使用VS2008进行WebPart开发时，用其自带的部署菜单项进行部署时，总是有各种各样的错误，最终无法生成部署文件和部署批处理文件。所以我一直想搞清楚VS2008是如何生成这些部署文件的。现在终于有了一个结果，可以与大家分享。
要生成部署文件需要以下几个文件。
- Manifest.xml
Defines the list of features, site definitions, resource files, web part files, and assemblies to be included in the Solution package
Manifest.xml文件通常作为Solution的入口点，用来指明在这个Solution中需要去处理的Package—你可以在FeatureManifests节点下指定多个FeatureManifest来执行多个Feature的部署。在英文解释中提到还可以指定别的一些类型的文件，但Assemblies是通常会在这里指定，其他文件最好被声明在各个Feature中。 - Feature.xml
Defines the feature and specifies the location of assemblies, files, dependencies, or properties that support the Feature.
Feature.xml是很常见的配置文件，用来指定所安装的Feature中要包含的DLL，以及其详细配置文件Elements.xml的路径。Feature.xml我们可以认为是单个Feature的入口点，大多数时间之需要指明Elements.xml的路径，而无需将具体操作置入Feature.xml。这样做是为了让我们的配置文件更结构化，功能化。 - MyWebPartManifest.xml
Element manifest file containing definitions to the feature's elements.
Elements.xml文件是最终这个Feature所要做的动作的具体描述。在这里可以应用诸如CustomAction, Module, ModuleGroup, Assemblies, ActivationDependencies, Recievers等扩展标记来告诉Package在部署时要做的动作。 - MyWebpart.webpart
Web Parts control description files contain property values, state data, and assembly or source file details exported from a WebPart control (or other ASP.NET server or user control used in a Web Parts application) to an XML file with a .WebPart extension.
.webpart文件包含了Webpart的属性、数据等信息。 - MyWebpart.ddf
Package.ddf is a MakeCab diamond directive file used to define the structure and contents of the solution package.
.ddf文件指定了将来生成的.CAB文件或.WSP文件包含的内容。这里定义了所有需要部署的文件结构信息。需要注意的是，目录结构的变化需要用.SET DESTINATIONDIR=’’ 来显式指定。
（注：以上部分说明引自博客：初探SharePoint部署 – WSS Solution Package ）
以下是各个文件的具体实例：
- Manifest.xml
Code
- Feature.xml
Code
注意：此处的.webpart文件的名字为MeetingSchedule.webpart；ElementManifest文件的名字为MeetingSchedule.xml。 - MyWebPartManifest.xml
Code
- MyWebpart.webpart
Code
- MyWebpart.ddf
Code
这些文件的目录结构为：
\root
manifest.xml
MeetingSchedule.ddf
MeetingSchedule.ddl
\MeetingSchedule
feature.xml
\MeetingSchedule
MeetingSchedule.webpart
MeetingSchedule.xml
注：这其中的feature.xml、manifest.xml文件、.webpart文件和ElementManifest文件，都由VS2008自动生成。但是manifest.xml文件中不含有SafeControls的信息，需要自己添加。查看方法：选择View->Other Windows->WSP View。除了ddf文件外，其他文件在VS2008能够正常部署时也可以自动生成（包括正确的manifest.xml文件）。实际上我的这些文件就是这样得到的。
好了，到此为止我们已准备好了所有文件，现在就可以开始生成部署文件了。生成的部署文件，实际上是由Makecab压缩成的cab文件，只不过其后缀改为了wsp而已。在root下执行：
Makecab /F meetingschedule.ddf
就可以生成一个新的目录Package，在此目录下含有生成的部署文件：MeetingSchedule.wsp。
现在可以进行部署了。通常执行Stsadm就可以进行部署，但是为了每次部署及解除部署的方面，最好使用一个批处理文件自动进行。VS2008在能够正常部署时，会自动生成这样一个名为“Setup.bat”批处理文件。我就把这个文件照搬到此，作为模板，以后可以根据需要改动。
注意：其中的Feature Id，就是Feature.xml中的ID。
@rem======================================================================
@rem
@rem setup.bat
@rem
@rem======================================================================
@echo off
setlocal
pushd .
goto LInitialize
@rem----------------------------------------------------------------------
@rem LInitialize
@rem----------------------------------------------------------------------
:LInitialize
set SPAdminTool=%CommonProgramFiles%\Microsoft Shared\web server extensions\12\BIN\stsadm.exe
set Install=
set Uninstall=
set PackageFile=%~dp0Package\MeetingSchedule.wsp
set PackageName=MeetingSchedule.wsp
set DefaultWebUrl=http://myserver:40000
set DefaultSiteUrl=http://myserver:40000
set TargetWebUrl=
set TargetSiteUrl=
goto LParseArgs
@rem----------------------------------------------------------------------
@rem LParseArgs
@rem----------------------------------------------------------------------
:LParseArgs
@rem --- help ---
if "%1" == "/?" goto LHelp
if "%1" == "-?" goto LHelp
if "%1" == "/h" goto LHelp
if "%1" == "-h" goto LHelp
if "%1" == "/help" goto LHelp
if "%1" == "-help" goto LHelp
@rem --- Fix execute task ---
if "%1" == "/i" (set Install=1) & shift & goto LParseArgs
if "%1" == "-i" (set Install=1) & shift & goto LParseArgs
if "%1" == "/install" (set Install=1) & shift & goto LParseArgs
if "%1" == "-install" (set Install=1) & shift & goto LParseArgs
if "%1" == "/u" (set Uninstall=1) & shift & goto LParseArgs
if "%1" == "-u" (set Uninstall=1) & shift & goto LParseArgs
if "%1" == "/uninstall" (set Uninstall=1) & shift & goto LParseArgs
if "%1" == "-uninstall" (set Uninstall=1) & shift & goto LParseArgs
@rem --- Fix url ---
if "%1" == "/weburl" (set TargetWebUrl=%2) & shift & shift & goto LParseArgs
if "%1" == "-weburl" (set TargetWebUrl=%2) & shift & shift & goto LParseArgs
if "%1" == "/siteurl" (set TargetSiteUrl=%2) & shift & shift & goto LParseArgs
if "%1" == "-siteurl" (set TargetSiteUrl=%2) & shift & shift & goto LParseArgs
@rem --- Check invalid arguments ---
if not "%1" == "" (
echo Invalid argument.
goto LHelp
)
@rem --- Check arguments ---
if "%Install%" == "1" (
if "%Uninstall%" == "1" (
goto LHelp
)
)
if "%Install%" == "" (
if "%Uninstall%" == "" (
set Install=1
)
)
if "%TargetSiteUrl%" == "" (
if "%TargetWebUrl%" == "" (
set TargetWebUrl=%DefaultWebUrl%
set TargetSiteUrl=%DefaultSiteUrl%
)
if not "%TargetWebUrl%" == "" (
set TargetSiteUrl=%TargetWebUrl%
echo Setting TargetSiteUrl to be %TargetWebUrl%
)
)
if "%TargetWebUrl%" == "" (
set TargetWebUrl=%TargetSiteUrl%
echo Setting TargetWebUrl to be %TargetSiteUrl%
)
goto LMain
@rem----------------------------------------------------------------------
@rem LHelp
@rem----------------------------------------------------------------------
:LHelp
echo Usage:
echo setup.bat [/install or /uninstall][/weburl ^<url^>][/siteurl ^<url^>]
echo [/help]
echo.
echo Options:
echo /install or /uninstall
echo Install specified Solution package (.wsp) to the SharePoint server
echo or uninstall specified Solution from the SharePoint server.
echo Default value: install
echo /weburl
echo Specify a web url of the SharePoint server.
echo Default value: %DefaultWebUrl%
echo /siteurl
echo Specify a site url of the SharePoint server.
echo Default value: %DefaultSiteUrl%
echo /help
echo Show this information.
echo.
goto LTerminate
@rem----------------------------------------------------------------------
@rem LMain
@rem----------------------------------------------------------------------
:LMain
if "%Install%" == "1" (
call :LDeploy
)
if "%Uninstall%" == "1" (
call :LRetract
)
goto LTerminate
@rem----------------------------------------------------------------------
@rem LDeploy
@rem----------------------------------------------------------------------
:LDeploy
这样就可以方面的进行部署与解除。
部署命令：Setup /i
解除命令：Setup /u