ClickOnce部署

时间:2023-03-08 17:56:44

(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控件,把文本改为"超级应用,天下无敌。"。大概就如下图所示。是不是很霸气?

ClickOnce部署

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

ClickOnce部署

  1. 如下图所示,有两个发布位置。

ClickOnce部署

发布位置可以选择本地文件夹,也可以选择IIS上的Web服务器地址,当然FTP也行。这两个地方也没什么特别,如果你计划把应用程序直接发布到本地,就这样填:

ClickOnce部署

如果你想把安装程序发布到服务器,可以这样填,也可以单击右边的ClickOnce部署按钮来选择一个位置。

ClickOnce部署

如果你希望在本地文件目录中发布一份,同时又想放到服务器上让用户下载,可以这样填。

ClickOnce部署

  1. 安装模式一般选择第二项,不用解释,看字面意思就明白了,如下图。

ClickOnce部署

  1. 我们的程序一般来说不可能是"终极"版,通常我们会不断更新或升级,所以,在"发布"页面中,我们可以单击"更新"按钮,随后会弹出一个窗口,如下图。

ClickOnce部署

我们可以设置应用程序在什么时候检查更新,这里我改为每次运行时都检查更新。

ClickOnce部署

获取更新位置,可填可不填,通常与发布位置相同。

ClickOnce部署

点击确定按钮,关闭窗口。

  1. 发布版本号,勾选"随每次发布自动递增修订号"。这样一来,我们既可以自己填写版本号,如果忘记修改,也可以自动更新。

ClickOnce部署

  1. 单击"发布向导"按钮,打开向导窗口,这里我们可以重新设置发布位置。

ClickOnce部署

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

ClickOnce部署

我们前面设置了IIS服务器的位置,所以默认是从网站安装,如果我们的应用程序是刻到光盘中来分发给客户的,也可以选择从CD/DVD安装。

  1. 单击下一步,选择应用程序的运行方式,如果选择CD/DVD安装,则不需要此步。

ClickOnce部署

通常较好的做法是选择既可以离线使用,也可以在连接时使用。

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

ClickOnce部署

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

下面我们来测试一下。

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

ClickOnce部署

我们看到,出现安全提示,如果确定应用程序来源合法,可以点击"安装"按钮进行安装。

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

ClickOnce部署

既然是叫ClickOnce了,那为什么我们刚才Click了不止一次呢? 那是因为缺少可信任的发布者证书导致出现安全提示的。在下一节中,我们会介绍如何自己制作证书,并在客户计算机中安装证书,那时候大家就会看到真正的ClickOnce,只要Click一下就可以安装了。

现在,我们可以打开"程序和功能"控制面板把应用程序卸载掉。

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

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

没关系,我们只要把刚才的发布选项改一下就行了。

ClickOnce部署

然后重新发布就可以了。

ClickOnce部署

我们看到,安装程序可以被激活了。

无论是哪种方式发布,无非就是把安装给客户,然后安装到他们的机器上罢了,所以,大家觉得哪种做法最简单就用哪种。这些东西也没有说什么硬性的条条框框,一切都是技巧而已。

(2):自动更新

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

我们依然通过实例来学习。

第一步,随便建一个应用程序项目,至于是控制台、WPF还是WinForm就随意吧,我们的重点发布应用程序。比如这样:

ClickOnce部署

为了更好的演示,我们可以在窗口上显示当前发布的版本号。我这里是一个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,不然发布不上去;另外,要开启检查更新功能,上一节中说过,操作也很简单。

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

ClickOnce部署

然后确定,这样就算配置好了。然后发布到服务器上。

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

ClickOnce部署

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

ClickOnce部署

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

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

ClickOnce部署

然后直击点击下面的"立即发布"按钮即可。

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

ClickOnce部署

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

ClickOnce部署

(3):使用证书

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

在前面所说的ClickOnce部署中,如果大家细心的话,应该会发现这么个问题。

ClickOnce部署

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

好,我们先不管那是什么,现在我们不妨发布一个项目,但在"项目属性"窗口中的"发布"选项卡上,点击"选项"按钮,打开"发布选项"对话框。

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

ClickOnce部署

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

ClickOnce部署

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

ClickOnce部署

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

ClickOnce部署

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

大家还记得这个界面不?

ClickOnce部署

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

这是由于没有识别到受信任的证书造成的。下面我们来看看如何自己来做证书。

其实VS在发布ClickOnce部署时是为我们生成了一个临时证书的,但这样不太好控制,我们希望自己来做一个符合我们要求的证书,至少在证书的过期日期上我们可以自己来定。对于我们小开发者或小团队来说,到证书机构购买证书似乎有点"装逼"了,反正证书就是用来标识我们发布者身份,确保我们的应用安装包在传播过程中不被修改,我们倒不如自己弄一个证书更简便。

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

ClickOnce部署

我们来自己做个证书吧,自己给自己颁发证书,非常有荣誉感的。要完成这件事,我们需要用到几个命令行工具,其实大家网上搜一下,也是有很多相关文章的,这里我也顺便给大家演示一遍。

a、首先粉墨登场的是makecert工具,大家看看它的名字就知道它的长相,有点帅,作用当然是创建一个.cer文件,即证书文件。至于是啥类型的证书,纯属理论课,大家*一下就有了。

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

cd %USERPROFILE%\证书

这样,第一步也完成了,看:

ClickOnce部署

b、用makecert命令生成一个证书文件my.cer,并且附带一个密钥my.pvk。输入以下命令:

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

ClickOnce部署

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

ClickOnce部署

点击OK按钮,然后又弹出一个窗口,注意,这个和上面那个不同,上面那个是创建密码,下面这个是用刚才创建的密码来创建证书。刚才我设置了123456789,所以这里还是要输入123456789,不要输错密码,不然要从头再来了。

ClickOnce部署

点击OK按钮,好,证书和私钥文件就创建完成了。就是这两个文件:

ClickOnce部署

解释一下,-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

完成后我们看到又多了一个文件:

ClickOnce部署

我们离真相越来越近了,还剩最后一个,我们的.pfx证书就要完工了。最后一步就是把.pvk文件转为.pfx文件。所以用pvk2pfx,继续在命令行中输入以下命令:

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

ClickOnce部署

这个工具比较复杂,-pvk指定刚才生成的.pvk文件;-spc就是刚才生成的.spc文件;-pfx是要生成的.pfx文件的名字,-pi是.pvk文件的密码,即我们前面创建的123456789,-po是生成的.pfx文件的密码,你可以重新设,我这里还是用123456789。

pfx弄好了,现在我们把它放进VS中。VS解决方案中,可以把<项目名>_TemporaryKey.pfx删了,那个是VS生成的临时证书,现在我们有自己的证书了,临时证书就没用了,我们可以送它去见列宁了。

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

ClickOnce部署

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

ClickOnce部署

OK,证书就替换了。

ClickOnce部署

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

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

ClickOnce部署

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

ClickOnce部署

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

ClickOnce部署

(4):下载多个安装包

有时候,我们可能会一次性发布多个安装包,当然在网页上多加几个链接让用户逐个安装也是可取的。不过,也可以弄得更方便些,即用户先安装一个,作为一个"引导程序",然后通过这个程序去下载安装其他应用程序。

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

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

ClickOnce部署

第一个应用

ClickOnce部署

第二个应用

最后,重点是如何做这个"引导"安装包,即我们通过这个应用程序来下载前面两个应用来安装。

别急,在开工之前,我想让大家背书,不多,小学生也能背下来的,总共就两句话:

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

第二句:开菜单——做菜——试菜——开饭。

第一句话就不用解释了,如果你不明白说明你还没入门。我们把重点放在第二句话,这句话可能大家觉得很搞笑,怎么好像在做饭啊? 是啊,"民以食为天",做饭很重要。

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

InPlaceHostingManager类使 用按以下几步。

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

第二、开菜单。调用GetManifestAsync方法获取清单,获取后,无论成功与否会引发GetManifestCompleted事件,所以在调用方法前要为GetManifestCompleted事件附加处理代码,这是基础知识,估计我不必解释了。

第三、做菜。调用AssertApplicationRequirements方法检查一下你有没有这个权限,要明白自己是吃几碗饭的,如果权限不够会引发异常,如果力所能及,方法调用后一切正常。一个bool类型的参数表示当权限不足时是否尝试提升,你懂的。

如果权限检查通过,调用DownloadApplicationAsync方法就可以下载应用程序了,在这过程中会引发DownloadProgressChanged和DownloadApplicationCompleted,这两个事件我不说了,你知识怎么处理了,和使用BackgroundWorker一样,如果你不懂,请回家好好细读《C#入门经典》。

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

ClickOnce部署

界面是包括两个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

ClickOnce部署

VS会为我们生成相应的属性,如上面代码中,我们通过当前应用程序所在的程序集中的.Properties.Settings.Default.app1就可以得到app1的值。

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

用来引导的应用就放到根目录,用户只需安装这个就可以了,然后利用这个应用程序来安装其他两个。

ClickOnce部署

App1放到/App1下。

ClickOnce部署

App2放到/App2下。

ClickOnce部署

发布完成后,IIS的根目录如下。

ClickOnce部署

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

ClickOnce部署

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

ClickOnce部署

ClickOnce部署