ClickOnce部署

（1）：一些发布方式

ClickOnce是什么玩意儿，这个问题嘛，在21世纪的互联网严重发达的时代，估计也没有必要大费奏章去介绍了，弄很差的话，还有抄袭之嫌。所以，有关ClickOnce的介绍，各位朋友能够直接查找MSDN文档，或者看下面这里，这是百度百科上的，其实也是Ctrl + C版本。http://baike.baidu.com/view/1390498.htm

若是你对这些理论的东西不感兴趣，不要紧，上面所说起的内容你彻底能够无视之。咱们只要知道，ClickOnce是一种应用程序部署方式便可。那什么是部署呢? 咱们不妨查一查词典，部署的释义为安排、布置等，而放到咱们的应用程序来讲，咱们通俗的叫法就是安装。即把你开发好的应用程序布置到客户的计算机上，或者说安装到客户的计算机上，这就是部署。

因此咱们能够说ClickOnce应用程序就是一类安装包装，它能够一步到位进行安装，而不像咱们所使用的传统安装包那样，要N个"下一步"，而后才是完成。

也许有人也说，发布ClickOnce包不是很简单吗? 在VS里面点几下鼠标就完事了吗? 你还拿来写博客干嘛? 首先，法律并无规定简单的东西不能拿来写博客；其次，对于许多初学者朋友来讲，我想是有参考价值，至少会有；再者，有些小问题可能你们常常会忽略的。

咱们先来发布一个Windows Forms应用程序，练练手。

准备条件：先确保安装了IIS，若是没有，就赶忙动手吧，由于下面咱们要作的例子，是把ClickOnce同时发布到本地文件和IIS服务器上的。至于如何安装，请Search the Internet吧。

1. 以管理员身份运行VS。新建一个Windows窗体应用程序项目。
2. 把窗口的标题（Text属性）改为你要的标题，我这里改成"宇宙无敌应用程序"。而后再拖一个Label控件，把文本改成"超级应用，天下无敌。"。大概就以下图所示。是否是很霸气?

1. 好了，就这样吧，够简单，这就是咱们待会儿要发布的应用程序。
2. 好，开始发布ClickOnce安装程序。打开"解决方案资源管理器"，在项目节点上右击，从弹出的快捷菜单中选择【属性】，打开项目属性窗口，切换到"发布"选项卡。

1. 以下图所示，有两个发布位置。

发布位置能够选择本地文件夹，也能够选择IIS上的Web服务器地址，固然FTP也行。这两个地方也没什么特别，若是你计划把应用程序直接发布到本地，就这样填：

若是你想把安装程序发布到服务器，能够这样填，也能够单击右边的按钮来选择一个位置。

若是你但愿在本地文件目录中发布一份，同时又想放到服务器上让用户下载，能够这样填。

1. 安装模式通常选择第二项，不用解释，看字面意思就明白了，以下图。

1. 咱们的程序通常来讲不多是"终极"版，一般咱们会不断更新或升级，因此，在"发布"页面中，咱们能够单击"更新"按钮，随后会弹出一个窗口，以下图。

咱们能够设置应用程序在何时检查更新，这里我改成每次运行时都检查更新。

获取更新位置，可填可不填，一般与发布位置相同。

点击肯定按钮，关闭窗口。

1. 发布版本号，勾选"随每次发布自动递增修订号"。这样一来，咱们既能够本身填写版本号，若是忘记修改，也能够自动更新。

1. 单击"发布向导"按钮，打开向导窗口，这里咱们能够从新设置发布位置。

1. 单击下一步，选择一种安装来源。

咱们前面设置了IIS服务器的位置，因此默认是从网站安装，若是咱们的应用程序是刻到光盘中来分发给客户的，也能够选择从CD/DVD安装。

1. 单击下一步，选择应用程序的运行方式，若是选择CD/DVD安装，则不须要此步。

一般较好的作法是选择既能够离线使用，也能够在链接时使用。

1. 单击下一步，再单击完成按钮，这时候咱们会看到VS正在发布ClickOnce应用程序。

只要看到"发布成功"四个字就说明大功告成了。

 

下面咱们来测试一下。

本地安装：咱们上面的例子是生成了两个ClickOnce安装程序的，一个在本机文件中，一个在IIS服务器上。找到发布后的本地目录，如上面的d:\MyPublic\。双击setup.exe或MyApp.application文件，均可以启用安装程序。

咱们看到，出现安全提示，若是肯定应用程序来源合法，能够点击"安装"按钮进行安装。

安装成功后，咱们的超级应用程序就运行起来了。

 

既然是叫ClickOnce了，那为何咱们刚才Click了不止一次呢? 那是由于缺乏可信任的发布者证书致使出现安全提示的。在下一节中，咱们会介绍如何本身制做证书，并在客户计算机中安装证书，那时候你们就会看到真正的ClickOnce，只要Click一下就能够安装了。

如今，咱们能够打开"程序和功能"控制面板把应用程序卸载掉。

 

网站安装：打开浏览器，输入刚才发布的Web地址，在后面加上一个.application后缀的文件名。好比咱们这个例子的清单文件叫MyApp.application。但咱们会发现，找不到资源。

打开服务器上的目录一看，里面居然是空的，我晕。

不要紧，咱们只要把刚才的发布选项改一下就好了。

而后从新发布就能够了。

咱们看到，安装程序能够被激活了。

不管是哪一种方式发布，无非就是把安装给客户，而后安装到他们的机器上罢了，因此，你们以为哪一种作法最简单就用哪一种。这些东西也没有说什么硬性的条条框框，一切都是技巧而已。

 

（2）：自动更新

上次咱们说了如何用最基本的方式用ClickOnce技术部署应用程序项目，本篇咱们来认识一下如何让应用程序具有自动更新的功能。

咱们依然经过实例来学习。

第一步，随便建一个应用程序项目，至因而控制台、WPF仍是WinForm就随意吧，咱们的重点发布应用程序。好比这样：

为了更好的演示，咱们能够在窗口上显示当前发布的版本号。我这里是一个WinForm项目，故我就用一个Label控件来显示当前发布版本。

注意，这里的版本号是ClickOnce发布的版本号，不是程序集的版本号。因此要使用ApplicationDeployment类（位于System.Deployment.Application命名空间，在程序集System.Deployment.dll中，若是没有引用，就引用吧）。经过静态属性CurrentDeployment能够获得一个与当前部署的应用程序有关的ApplicationDeployment对象。而后从ApplicationDeployment的CurrentVersion属性中就能获得当前版本号。代码以下，至于写在哪一个地方，你本身想一想吧，这是很基础的事了。

using System.Deployment.Application;

 

……

public partial class Form1 : Form

{

public Form1()

{

InitializeComponent();

// 获取当前部署

ApplicationDeployment appd = ApplicationDeployment.CurrentDeployment;

// 取得版本号

this.lblVer.Text = appd.CurrentVersion.ToString();

}

}

好，OK，如今咱们能够发布该应用程序了，由于咱们要让它可以自动更新，一来咱们要发布到IIS或其余服务器上，记得以管理员身份运行VS，否则发布不上去；另外，要开启检查更新功能，上一节中说过，操做也很简单。

在项目属性窗口中，切换到"发布"选项卡，单击"更新…"按钮，启用检查更新便可，至于如何更新，按照默认就能够了，没有必要去改了。

而后肯定，这样就算配置好了。而后发布到服务器上。

 

第二步，经过浏览器输入地址，安装并运行应用程序，以下图所示，注意如今的版本是1.0.0.0。

 

第三步，关闭应用程序，回到VS，咱们把刚才的程序改一下，来模拟升级。好比我在窗口上再加一个按钮，以下图。

 

第四步，一样，打开项目属性中的"发布"选项卡，再发布一次。

咱们看到修订版本号变成1了。

而后直击点击下面的"当即发布"按钮便可。

 

第五步，发布成功后，从"开始"中再次运行刚才安装的应用程序，会看到提示更新的对话框。

 

点击肯定，就会自动下载并安装更新。这时候咱们看到版本号是1.0.0.1了。

 

（3）：使用证书

在讲述证书的使用前，咱们先来了解另一个知识——发布网页。

在前面所说的ClickOnce部署中，若是你们细心的话，应该会发现这么个问题。

如上图，发布成功后，在"输出"窗口中提示没法查看发布网页。

好，咱们先无论那是什么，如今咱们不妨发布一个项目，但在"项目属性"窗口中的"发布"选项卡上，点击"选项"按钮，打开"发布选项"对话框。

在"说明"页中输入基本信息，产品名称和发布者。

而后进入到"部署"页，在部署网页处输入一个页面名称，最好用index.htm或default.htm之类的名字，由于IIS等服务器的默认页面一般是这些。而且勾选"每次发布后都自动生成部署网页"项。

单击肯定回到发布页，而后咱们点击一下"当即发布"，仔细观察。这一次咱们发现，"输出"窗口再也不提示没法打开部署页面了，并且发布完成后打开了一个页面，就是咱们刚才输入的发布网页，是VS为咱们自动生成的。

 

咱们能够用VS或其余网页编辑工具来修改这个页面，一旦咱们修改后，记得回到项目属性中的发布页，再次打开发布选项对话框，去掉"每一次发布后自动生成部署网页"项前面的对勾，否则，你所修改的页面在下一次发布后会被自动生成的页面所覆盖。

 

好，这段内容就说到这儿。下面开始咱们的正题。

 

 

你们还记得这个界面不?

咱们在安装ClickOnce应用程序的时候，都会弹出这个安全警告，虽然点击"安装"就能够开始安装，可是，这就变成不是ClickOnce了，而是ClickTwice了，是吧，咱们至少点击了两下。

这是因为没有识别到受信任的证书形成的。下面咱们来看看如何本身来作证书。

其实VS在发布ClickOnce部署时是为咱们生成了一个临时证书的，但这样不太好控制，咱们但愿本身来作一个符合咱们要求的证书，至少在证书的过时日期上咱们能够本身来定。对于咱们小开发者或小团队来讲，到证书机构购买证书彷佛有点"装逼"了，反正证书就是用来标识咱们发布者身份，确保咱们的应用安装包在传播过程当中不被修改，咱们倒不如本身弄一个证书更简便。

 

在项目属性窗口中，咱们切换到"签名"选项卡，这里看到VS生成的临时证书。

 

咱们来本身作个证书吧，本身给本身颁发证书，很是有荣誉感的。要完成这件事，咱们须要用到几个命令行工具，其实你们网上搜一下，也是有不少相关文章的，这里我也顺便给你们演示一遍。

a、首先粉墨登场的是makecert工具，你们看看它的名字就知道它的长相，有点帅，做用固然是建立一个.cer文件，即证书文件。至因而啥类型的证书，纯属理论课，你们维基百科一下就有了。

打开Visual Studio命令行窗口，不要告诉我你找不到，而后咱们最好用CD命令修改一下当前目录，咱们但愿把建立的文件放到哪里就定位到哪里，我呢计划把这些荣誉证书文件放到C:\Users\Admin下，即个人我的目录。输入如下命令：

cd %USERPROFILE%\证书

这样，第一步也完成了，看：

 

b、用makecert命令生成一个证书文件my.cer，而且附带一个密钥my.pvk。输入如下命令：

makecert –r –n "CN=老周" –b 10/08/2013 –e 08/11/2016 –sv my.pvk my.cer

按回车后，提示建立密码，输入密码，你喜欢，为了好玩，我这里用123456789做为密码。

点击OK按钮，而后又弹出一个窗口，注意，这个和上面那个不一样，上面那个是建立密码，下面这个是用刚才建立的密码来建立证书。刚才我设置了123456789，因此这里仍是要输入123456789，不要输错密码，否则要从头再来了。

点击OK按钮，好，证书和私钥文件就建立完成了。就是这两个文件：

解释一下，-r参数表示自签名，说白了就是本身给自书颁发证书，必定要加上-r，-n是证书的名字，一般用你的大名或者你公司的名字，以CN开头，格式为CN=<your name>，好比我叫老周（原本收小周，就由于叫小周的人太多，因此我叫老周），就用CN=老周。

-b是证书有效期的开始日期，格式mm/dd/yyyy，注意，别写错，哪怕你是1月份也不要写成1，应该写成01；-e是证书有效期的过时日期，格式和前面同样。

-sv是建立密钥文件，文件名为*.pvk，-sv要加上，后面你会发现，有用的。

最后就是证书文件的名字，文件名为*.cer。

 

c、证书是生成了，但你会看到VS要的.pfx文件，不是.cer文件，因此咱们必须转换，可是没有工具能够一部到位，因此，咱们依次用两个工具来转换。

先是用cert2spc，把.cer文件转换为.spc文件，不要问为何，到了后面一步你就知道为何要转为.spc文件了。继续在命令行中输入：

Cert2spc my.cer my.spc

完成后咱们看到又多了一个文件：

咱们离真相愈来愈近了，还剩最后一个，咱们的.pfx证书就要完工了。最后一步就是把.pvk文件转为.pfx文件。因此用pvk2pfx，继续在命令行中输入如下命令：

pvk2pfx -pvk my.pvk -spc my.spc -pfx my.pfx -pi 123456789 –po 123456789 –f

这个工具比较复杂，-pvk指定刚才生成的.pvk文件；-spc就是刚才生成的.spc文件；-pfx是要生成的.pfx文件的名字，-pi是.pvk文件的密码，即咱们前面建立的123456789，-po是生成的.pfx文件的密码，你能够从新设，我这里仍是用123456789。

 

pfx弄好了，如今咱们把它放进VS中。VS解决方案中，能够把<项目名>_TemporaryKey.pfx删了，那个是VS生成的临时证书，如今咱们有本身的证书了，临时证书就没用了，咱们能够送它去见列宁了。

打开项目属性窗口，切换到"签名"选项卡，点击"从文件选取"按钮，导入刚才生成的.pfx证书。

 

而后输入密码，密码就是上面执行pvk2pfx命令时-po参数指定的密码，我仍使用了123456789。

 

OK，证书就替换了。

 

你只要把刚才的.cer文件（即证书）发给客户，客户在安装你的ClickOnce包以前先把证书安装到他的计算中的可信任区域中，而后再去安装你的应用，就不会有安全提示了。之后你发布的应用都用这个证书就好了，不过，注意证书不要过时了，过时了就从新生成一个日期较新的。

在客户的机子上，打开控制面板，搜索"证书"，而后打开基于计算机的证书管理器，注意不是基于当前用户。

 

打开证书管理，在"受信任的根证书颁发机构"节上右击，从菜中选择导入。

 

在"受信任的发布者"节上的也用一样的方法导入一次。随后咱们再发布一次ClickOnce部署包，如今就真正ClickOnce了，一点击就全自动安装了，没有安全提示了。

（4）：下载多个安装包

有时候，咱们可能会一次性发布多个安装包，固然在网页上多加几个连接让用户逐个安装也是可取的。不过，也能够弄得更方便些，即用户先安装一个，做为一个"引导程序"，而后经过这个程序去下载安装其余应用程序。

咱们仍是说说真实的例子，这样好理解一点。假设我开发了两个应用程序，一个叫App1，另外一个叫App2。我把这两个应用程序同时发布。

咱们能够在IIS服务器的根目录下新建两子目录，咱们分别把这两个应有程序发布到这两个文件夹下，以下面两张截图所示。

第一个应用

 

第二个应用

 

最后，重点是如何作这个"引导"安装包，即咱们经过这个应用程序来下载前面两个应用来安装。

别急，在开工以前，我想让你们背书，很少，小学生也能背下来的，总共就两句话：

第一句：凡是和ClickOnce部署有关的类都位于System.Deployment.Application命名空间下。

第二句：开菜单——作菜——试菜——开饭。

第一句话就不用解释了，若是你不明白说明你还没入门。咱们把重点放在第二句话，这句话可能你们以为很搞笑，怎么好像在作饭啊? 是啊，"民以食为天"，作饭很重要。

这里说的是作这个"引导"安装应用的步骤，咱们要用到InPlaceHostingManager类，它能够实现实时下载安装应用程序包，不要问我这个类在哪里，前面叫你背了第一句话。

InPlaceHostingManager类使 用按如下几步。

 

第1、new一个InPlaceHostingManager对象，这是废话。构造函数中咱们要传 一个URI，部署清单的URI，打包ClickOnce后，那个以.application后缀结尾的文件就是。

 

第2、开菜单。调用GetManifestAsync方法获取清单，获取后，不管成功与否会引起GetManifestCompleted事件，因此在调用方法前要为GetManifestCompleted事件附加处理代码，这是基础知识，估计我没必要解释了。

 

第3、作菜。调用AssertApplicationRequirements方法检查一下你有没有这个权限，要明白本身是吃几碗饭的，若是权限不够会引起异常，若是力所能及，方法调用后一切正常。一个bool类型的参数表示当权限不足时是否尝试提高，你懂的。

若是权限检查经过，调用DownloadApplicationAsync方法就能够下载应用程序了，在这过程当中会引起DownloadProgressChanged和DownloadApplicationCompleted，这两个事件我不说了，你知识怎么处理了，和使用BackgroundWorker同样，若是你不懂，请回家好好细读《C#入门经典》。

 

第4、试菜。打开"开始"菜单或"开始"屏幕，看看有没有新安装应用的快捷方式，若是有，那就下载安装成功了。

 

界面是包括两个Label和两个ProgressBar，标签用来显示文本，进度条固然表示下载的进度。

而后处理Form的Load事件，启动对App1和App2项目的安装包的下载和安装。

public partial class Form1 : Form

{

InPlaceHostingManager appDown1 = null;

InPlaceHostingManager appDown2 = null;

 

// uris

Uri app1Uri, app2Uri;

 

public Form1()

{

InitializeComponent();

app1Uri = new Uri(AppMain.Properties.Settings.Default.app1);

app2Uri = new Uri(AppMain.Properties.Settings.Default.app2);

 

appDown1 = new InPlaceHostingManager(app1Uri, false);

appDown2 = new InPlaceHostingManager(app2Uri, false);

}

 

private void Form1_Load(object sender, EventArgs e)

{

// 开始下载第一个应用程序

appDown1.GetManifestCompleted += appDown1_GetManifestCompleted;

appDown1.GetManifestAsync();

// 开始下载第二个应用程序

appDown2.GetManifestCompleted += appDown2_GetManifestCompleted;

appDown2.GetManifestAsync();

}

 

void appDown2_GetManifestCompleted(object sender, GetManifestCompletedEventArgs e)

{

if (e.Error != null)

{

MessageBox.Show(e.Error.Message); return;

}

lblSecond.Text = "即将下载" + e.ProductName + "，" + e.Version.ToString();

try

{

appDown2.AssertApplicationRequirements(true);

}

catch (Exception ex)

{

MessageBox.Show(ex.Message); return;

}

 

appDown2.DownloadProgressChanged += appDown2_DownloadProgressChanged;

appDown2.DownloadApplicationCompleted += appDown2_DownloadApplicationCompleted;

 

appDown2.DownloadApplicationAsync();

}

 

void appDown2_DownloadApplicationCompleted(object sender, DownloadApplicationCompletedEventArgs e)

{

lblSecond.Text = "下载完成。";

}

 

void appDown2_DownloadProgressChanged(object sender, DownloadProgressChangedEventArgs e)

{

this.progressbarSecond.Value = e.ProgressPercentage;

this.lblSecond.Text = "已下载" + e.BytesDownloaded.ToString() + "字节，共" + e.TotalBytesToDownload.ToString() + "字节。";

}

 

void appDown1_GetManifestCompleted(object sender, GetManifestCompletedEventArgs e)

{

if (e.Error != null)

{

MessageBox.Show("出错：" + e.Error.Message); return;

}

this.lblFirst.Text = "即将下载" + e.ProductName + "，" + e.Version.ToString();

try

{

appDown1.AssertApplicationRequirements(true);

}

catch (Exception ex)

{

MessageBox.Show(ex.Message);

return;

}

appDown1.DownloadProgressChanged += appDown1_DownloadProgressChanged;

appDown1.DownloadApplicationCompleted += appDown1_DownloadApplicationCompleted;

 

appDown1.DownloadApplicationAsync();

}

 

void appDown1_DownloadApplicationCompleted(object sender, DownloadApplicationCompletedEventArgs e)

{

lblFirst.Text = "下载完成。";

}

 

void appDown1_DownloadProgressChanged(object sender, DownloadProgressChangedEventArgs e)

{

this.progressbarFirst.Value = e.ProgressPercentage;

this.lblFirst.Text = "已下载" + e.BytesDownloaded.ToString() + "字节，共" + e.TotalBytesToDownload.ToString() + "字节。";

}

}

而应用安装包的下载地址，咱们放到配置文件中，以便修改。

打开项目属性窗口，切换到"设置"选项卡，而后输入App1的下载地址是http://localhost/App1/App1.application；App2的下载地址是http://localhost/App2/App2.application。

 

VS会为咱们生成相应的属性，如上面代码中，咱们经过当前应用程序所在的程序集中的.Properties.Settings.Default.app1就能够获得app1的值。

两个应用项目，加上这个用来安装其余应用包的程序，共三个，把它们都发布到指定的路径下。

用来引导的应用就放到根目录，用户只需安装这个就能够了，而后利用这个应用程序来安装其余两个。

 

App1放到/App1下。

 

App2放到/App2下。

 

发布完成后，IIS的根目录以下。

 

而后安装根目录下的"引导"包。安装后运行应用程序，就会自动下载另外两个安装包并自动安装。

 

安装完成了，而后打开"开始"菜单或"开始"屏幕，就能看到三个应用程序了。