部署文档级自定义项 (2003 System)
更新:2007 年 11 月
适用对象 |
---|
本主题中的信息仅适用于指定的 Visual Studio Tools for Office 项目和 Microsoft Office 版本。 项目类型
Microsoft Office 版本
有关更多信息,请参见按应用程序和项目类型提供的功能。 |
为 Microsoft Office Word 2003 或 Microsoft Office Excel 2003 部署文档级自定义项通常意味着处理四个文件:
最终用户使用的 Word 或 Excel 文件(模板、文档或工作簿)。
包含已编译的自定义代码和任何依赖程序集(如资源、附属或帮助器库)的程序集。
部署清单(如果适用的话)。
应用程序清单(如果适用的话)。
在部署解决方案时,请考虑下列基本准则:
用户必须已安装 .NET Framework。有关更多信息,请参见再发行 .NET Framework和使用 .NET Framework 的多个版本。
用户必须已安装 Visual Studio Tools for Office 运行时。有关更多信息,请参见 如何:准备最终用户计算机以运行 Office 解决方案 (2003 System)。
每个最终用户必须至少具有对 Office 文档和程序集的读访问权限。
要使 Word 或 Excel 解决方案能够工作,该文档和程序集都必须具有完全信任。如果文档存储于用户的计算机上,那么,该文档通常会自动具有完全信任。然而,用户计算机上的程序集并不自动接收完全信任。有关更多信息,请参见 Office 解决方案中的安全性 (2003 System)。
若要部署解决方案,请将文档和程序集以及(可选的)应用程序和部署清单复制到部署位置。有关部署类型的更多信息,请参见 部署模型 (2003 System)。
Visual Studio Tools for Office 包括“发布向导”,该向导创建应用程序和部署清单并为您将所有文件复制到部署位置。然而,您也可以手动执行这些步骤。有关更多信息,请参见如何:部署 Office 解决方案 (2003 System)和如何:使用发布向导部署解决方案文件 (2003 System)。
发布向导
“解决方案资源管理器”中的项目的快捷菜单上的“发布”命令启动“发布向导”。标识要将解决方案发布到的文件夹的位置,向导会将文档和部署清单复制到该文件夹中。有关更多信息,请参见 如何:使用发布向导部署解决方案文件 (2003 System)。
该向导还会将程序集和已更新的应用程序清单复制到主部署文件夹的子文件夹中。该子文件夹中包含了版本号。如果在“项目设计器”的“发布”窗格中选择了“自动递增每个版本的修订号”选项,则每次发布解决方案时,都会创建一个新的子文件夹。较旧版本仍然可用。应用程序和部署清单确保解决方案始终使用最新的程序集。有关更多信息,请参见 Office 解决方案中的应用程序和部署清单、如何:使用发布向导部署解决方案文件 (2003 System)、“项目设计器”->“发布”页 (2003 System) 和 发布向导 (2003 System)。
更新已部署的程序集(版本控制)
如果将名为 ExcelWorkbook1 的解决方案部署到文件夹 C:\DeployFolder,则文件结构类似于:
C:\DeployFolder
此文件夹包含以下两个文件和子文件夹:
工作簿 (ExcelWorkbook1.xls)。
部署清单 (ExcelWorkbook1.application)。
C:\DeployFolder\ExcelApplication1_1.0.0.0
此文件夹包含以下文件:
程序集。
应用程序清单 (ExcelWorkbook1.dll.manifest)。
工作簿的副本。
部署清单的副本。
如果更新程序集并重新发布解决方案,则目录结构将如下所示:
C:\DeployFolder
此文件夹包含以下两个文件和子文件夹:
工作簿(含已更新的嵌入式应用程序清单)。
部署清单(已更新以指向 C:\DeployFolder\ExcelWorkbook1_1.0.0.1 中的应用程序清单)。
C:\DeployFolder\ExcelWorkbook1_1.0.0.0
此文件夹包含以下文件:
原始程序集。
原始应用程序清单。
原始工作簿。
原始部署清单。
C:\DeployFolder\ExcelWorkbook1_1.0.0.1
此文件夹包含以下文件:
已更新的程序集。
已更新的应用程序清单。
已更新的工作簿的副本。
已更新的部署清单的副本。
每次更新程序集时将重复此结构。如果您更新了文档或工作簿使其与现有程序集不再兼容,则应将解决方案部署到新的部署文件夹。
在命令提示符处使用 MSBuild
还可以在命令提示符处使用 MSBuild 发布解决方案。在命令提示符处使用 MSBuild 时,可以将解决方案文件发布到某个位置,同时修改工作簿或文档中嵌入的应用程序清单,以指向另外某个位置的部署清单。若要在命令提示符处运行 MSBuild 以发布解决方案,请使用以下语法。
msbuild.exe /target:Publish /property:UpdateUrl=<update location> /property:PublishDir=<publish location> <project file>
例如,如果要将名为 ExcelWorkbook1 的 C# 项目发布到共享文件夹 \\PublishServer\PublishFolder,但需要在以后将部署清单、外部应用程序清单和程序集移动到共享文件夹 \\DeploymentServer\DeploymentFolder,则您要运行以下命令。
msbuild.exe /target:Publish /property:PublishDir=\\PublishServer\PublishFolder\ /property:UpdateUrl=\\DeploymentServer\DeploymentFolder\ C:\ExcelWorkbook1\ExcelWorkbook1.csproj
有关在命令提示符处使用 MSBuild 的更多信息,请参见 从命令行生成 ClickOnce 应用程序。
应用程序和部署清单
应用程序和部署清单用于让文档能够使用最新的程序集来更新文档自身。有关更多信息,请参见 Office 解决方案中的应用程序和部署清单。
更新部署清单
在解决方案的生存期内,您可能会为解决方案更改几次部署清单。更新部署清单有两个主要原因:
部署解决方案程序集的新版本。有关更多信息,请参见 如何:更新已部署的程序集文件 (2003 System)。
更改解决方案程序集的位置。有关更多信息,请参见 如何:更改文档级自定义项的位置 (2003 System)。
更新应用程序清单
您可能始终无须直接更新解决方案中正在使用的现有应用程序清单。通常,您通过创建新的应用程序清单并使用部署清单将新的应用程序清单加载到解决方案中。然而,有两个主要原因使您可能要直接在文档中更新应用程序清单:
由于原始服务器不再提供服务,部署清单和程序集已移至新的服务器中。在这种情况下,您必须更改应用程序清单中的那些项的路径。有关更多信息,请参见 如何:更改文档级自定义项的位置 (2003 System)。
您要从文档中移除应用程序清单。例如,您可能希望将文档存档且不希望它运行代码并进行可能的更改,或者您可能希望将完成的文档发送到工作组以外而不引用任何代码。有关更多信息,请参见 如何:移除文档中的托管代码扩展 (2003 System)。
部署经过本地化的 Microsoft Office 解决方案
部署 Visual Studio Tools for Office 解决方案的本地化版本与使用 Visual Studio 部署其他类型的解决方案大体相同。然而,有关创建和分发本地化版本的 Visual Studio Tools for Office 解决方案,还有一些其他注意事项。有关更多信息,请参见Office 解决方案的全球化和本地化、如何:对 Excel 解决方案进行本地化和部署和本地化。
请参见
任务
如何:准备最终用户计算机以运行 Office 解决方案 (2003 System)
如何:部署 Office 解决方案 (2003 System)
概念
Office 解决方案的脱机模型 (2003 System)