如何简单部署用VSTO SE 2005开发的Excel,Word插件

原创 2007年12月19日 22:08:00
 

如何简单部署用VSTO SE 2005开发的ExcelWord插件

本文标题之所以要加上简单二字,是为了区别于msdn上的两篇讲述VSTO部署的经典长文。

http://msdn2.microsoft.com/en-us/library/bb332051.aspx

http://msdn2.microsoft.com/en-us/library/bb332052.aspx

其实VSTO插件的部署无非就是Prerequisitesgrant full trust (因为注册表是模板帮我们处理好的,我们不需要去关心,下文有详述)。上面的两篇文章为了一步到位的解决好以上两个问题,并打包.msi文件,用了一些技术。一,给Setup项目添加prerequisites,并且使用launch condition来要求用户在安装setup.exe前必须保证所有的prerequisites都已经安装在目标机器上;二,利用Custom Action在安装过程完成后,调用caspol工具来设置程序集的权限。

第一篇文章讲解了各个技术点,第二篇文章通过具体的例子来完成两种类型项目的部署,并且提供了一个Sample,里面包含了要用到一些工程,如SetSecurity。例子就是引用这个工程做为Custom Action来设置权限的。

与上两者不同的是,本文抛开所有这些技术不看,仅仅打包一个最最简单的.msi文件,把prerequisitesgrant trust的事情,留待插件安装完再去人工做。希望如此,能给在VSTO项目部署时遇到困难的人一个直观的印象,让大家看到VSTO项目要运行,其实就是这么几个东西。然后回头再看Microsoft提供的这两篇文章,幸许又会有另外的收获。

 

一.概述

如果你的VSTO SE插件在开发机器上工作良好,一旦装到客户机上,就不再装载了。可能的原因无非就是一下几种:(在此排除了软禁用,硬禁用的情况)

1.一些prerequisites没有装:

a.       .NET Framework (这是所有.NET应用程序运行的必备,没有什么好说的。如果我们用VSTO SE开发的插件,我们应该在客户机上装上.NET 2.0以上的版本)

b.       Office PIAs(这是连接.NETOffice COM的桥梁,CLR通过它来操作OfficeCOM对象,没有它,你的程序一样不能跑)

c.       VSTO Runtime(这是所有用VSTO开发出来的软件,运行时必备的,目前有三个主本版,第三个版本用来支持ClickOnce部署,本文中不涉及。本文只用到第二个主版本的升级版)

2. 注册表,任何一个VSTO SE插件程序要运行,都是Office启动的时候先从注册表中找到插件的相关信息,主要是LoadBehaviorManifest的地址,然后根据Manifest的地址,找到manifest文件,manifest文件中记录了dll的地址和一些配置信息 (manifest文件可以用notepad打开) ,根据manifest来装载程序集。我们用VSTO SE新建一个插件项目的时候,Microsoft提供给我们的模板会帮我们自动添加一个Setup项目。这个项目中已经默认地帮我们把要写入的注册表键值写好,无须我们多费心思。当然如果你把默认的Setup项目删掉了 (我经常这么干,因为看着碍眼,并且我一般只要Debug,不要Deploy),自己再添加一个新的Setup项目,这时候,新项目中,系统不会帮你写好注册表的键值。关于注册表,下面是默认Setup项目的注册表视图的截图:

3. 权限的设置问题,Office装载任何VSTO SE开发出来的.NET插件时,都需要这个插件被完全信任。有两种方法完成这个任务:

a.       Microsoft .NET Framework Wizard (图形化界面)

b.      Caspol.exe (命令行,本文采用这种方式,原因是好表述,不要图)

 

二.部署案例

                下面我们动手,用VSTO SE创建一个Excel 2007的插件(2003也是一样的,只不过客户机要装Excel 2003Excel 2003 PIA,还有不要在同一台机器上同时安装Office 20032007),并且将它部署到一个客户机上。(由于手头只有英文版VS,菜单名都是英文的,大家自己对应看看吧)

1.       打开Visual Studio 2005,新建项目,在左边的导航板块中,选中C#->Office->2007 Add-ins,在右边选中Excel Add-in。取名ExcelAddIn,点OK

然后系统会在solution中默认的创建两个项目,一个是插件项目,一个是Setup项目,如图:

 

2.       ThisAddIn.cs文件中的ThisAddIn_Startup函数里加一句代码,以供回头测试是否部署成功。修改后的代码如下:

private void ThisAddIn_Startup(object sender, System.EventArgs e)

        {

            #region VSTO generated code

            this.Application = (Excel.Application)Microsoft.Office.Tools.Excel.ExcelLocale1033Proxy.Wrap(typeof(Excel.Application), this.Application);

            #endregion

 

            MessageBox.Show("Deploy successfully");

}

3.       Solution Expolrer里面,右击ExcelAddInSetup项目,点击Build

4.       Setup项目文件夹中的debug目录下找到ExcelAddInSetup.msi文件,拷贝到目标机器上。

5.       在目标机器上,安装:

.Net Framework 2.0 http://www.microsoft.com/downloads/details.aspx?FamilyID=0856EACB-4362-4B0D-8EDD-AAB15C5E04F5&displaylang=en

Office 2007 PIAs: (运行完下载文件后,还要点击得到的o2007PIA.msi才是安装PIAs)

http://www.microsoft.com/downloads/details.aspx?familyid=59DAEBAA-BED4-4282-A28C-B864D8BFA513&displaylang=en

VSTO Runtime2.0:

http://www.microsoft.com/downloads/details.aspx?FamilyId=4468D8CB-B43E-4B09-82F6-8BA3F7B5E935&displaylang=en#filelist

还有目标机上要有对应的Office程序,比如这里就需要Excel 2007

6.       双击刚刚拷贝到目标机器上的ExcelAddInSetup.msi,选择安装目录并安装,假设安装到了C:/Test目录下。安装完,该目录下会出现两个文件:ExcelAddIn.dllExcelAddIn.dll.manifest,其中的.dll文件就是我们下面要设置权限的程序集

7.       回到桌面,点击开始->运行,输入cmd,在命令行提示下,输入cd C:/WINDOWS/Microsoft.NET/Framework/v2.0.50727,回车

然后输入下面命令:

Caspol –u –ag All_Code –url “C:/Test/ExcelAddIn.dll” FullTrust –n “Test”

回车

输入yes

回车   (请勿直接拷贝这段命令行,因为Word好像改变了字体,大家还是自己敲一下,顺带加深一下印象)

8.       打开ExcelMessageBox对话框跳出。

[小结]VSTO addin 安装部署

VSTO addin刚接触,对于此类部署没有做过,好在找到一篇很全面的文章。   http://www.cnblogs.com/brooks-dotnet/archive/2011/11/04/223...

(转)将 VSTO 插件部署给所有用户(上篇)

注:本文原作者 Misha Shneerson 是 VSTO 团队的工程师。原文可以在下列地址找到:http://blogs.msdn.com/mshneer/archive/2007/09/05/d...

VSTO程序的部署和安装

在用windows installer安装VSTO程序时需要安装很多乱七八糟的东西:(1) 确保客户机器上安装了.NET2.0Framework(2)office2003(支持VSTO)(3)安装主互...

独乐乐不如众乐乐——将 VSTO 插件部署给所有用户

 VSTO 插件(也叫“托管代码 Office 插件”)在部署方面有一个严重的不足,简单来说,微软只告诉了我们如何把这些插件部署到单个用户环境;而“如何一次性部署到一台机器的所有用户环境中”成为了我们...
  • snlei
  • snlei
  • 2009年02月05日 15:17
  • 1283

C# RichTextBox行高自适应

第一种: richTextBox1.ScrollBars = RichTextBoxScrollBars.None; richTextBox.ContentsResized += new Cont...

Excel AddIn 开发(二)

客户有个需求,上一次进行的操作yao

如何简单部署用VSTO SE 2005开发的Excel,Word插件

如何简单部署用VSTO SE 2005开发的Excel,Word插件 本文标题之所以要加上简单二字,是为了区别于msdn上的两篇讲述VSTO部署的经典长文。 http://msdn2.micros...

vsto插件部署清除缓存mage工具

  • 2016年11月13日 22:12
  • 229KB
  • 下载

Addin Vsto Excel小插件

  • 2017年06月22日 11:40
  • 2.23MB
  • 下载

《北塔教你做插件 从RibbonX开始》第二讲:首建Ribbon——VSTO的星际穿越

前言: “Visual Studio Tools for Office”是微软针对Office开发而推出工具集,可以使用VB或C#扩展Office应用程序。最大的变化是使用VS开发环境来构建...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:如何简单部署用VSTO SE 2005开发的Excel,Word插件
举报原因:
原因补充:

(最多只允许输入30个字)