使用 ClickOnce 细分发布版本

ClickOnce 是微软在.NET 2.0 框架中发布的一项技术，允许大家在 Visual Studio 中方便地部署和更新.NET 的 Windows 应用程序。部署功能是通过把应用程序文件复制到一个文件夹中、FTP 目录中或者某个 Web 位置上，并同时附加一个清单文件来实现的。清单文件是一个具有.application 扩展名的 XML 文件，它包含了所有程序文件的一个列表，以及类似发布者标识这样的安全相关信息。ClickOnce 应用程序每发布一个新的版本，一个新的子目录就被创建，并把更新的文件放在这个目录中。程序的所有部署版本都是相互独立存在的，这意味着我们只需要识别用户，并把用户导向应用程序适合的版本，从而控制它们需要接受那个版本的程序。

首先，让我们来创建一个简单的 Windows 应用程序，并通过 ClickOnce 来部署它。创建一个新的 Windows 应用程序项目，放置一个标签控件到窗体上，并在 New() 过程中编写一些代码，以便让我们能看到我们拥有的是哪个版本。

<span color="#800080">label1.Text</span> = "Version: " & _ <br></br><span color="#800080">System.Reflection.Assembly.GetExecutingAssembly.GetName.Version.ToString</span>现在，打开项目属性界面并浏览签名（Signing）标签页，勾选“Sign the ClickOnce manifest”复选框，并通过点击“Create Test Certificate”按钮及输入密码来创建一个测试证书。

现在，我们已经拥有证书了，因而可以设置 ClickOnce 部署了。选择发布（Publish）标签页，输入发布位置即安装 URL（你也可以使用底部的发布向导（Publish Wizard）来直接输入这些）。发布位置是将要存放部署文件的物理位置。安装 URL 是用户用于下载和安装应用程序的 URL。我们打算让这个应用程序能够脱机运行，所以选择在“Install Mode and Settings”之下的第二个单选框。为了实现我们控制版本的功能，我们需要把程序文件部署到一个 Web 应用程序的文件夹树中，在选择部署位置时务必注意这一点。

注意，更新选项要通过点击“Updates…”按钮来显示。

至此，我们已经具有了一个可以进行部署的 ClickOnce 应用程序了。一旦部署并安装好，利用显示出来的更新选项设置，应用程序将会在每次启动的时候检查更新。

如果有新版本存在，那么用户将被提示进行更新。

此时，我们已经部署好一个 ClickOnce 应用程序了，接下来可以准备实现版本控制。进行版本细化控制的原理是为主文件.application 设置一个基于 Web 的转向功能. 首先，我们要把.application 扩展名添加到 ISS 的允许文件列表中。这可以通过 IIS 里的 Web 站点属性，设置界面中的 Home Directory 标签页上的 Application Configuration 配置节来实现。

一旦完成这步工作，就可以创建一个新的 WebApplication 并添加一个 Handler 类到其中。

接着，在应用程序的 web.config 文件中注册这个 Handler。Handler 类型的格式是 [Namespace].[ClassName], [Assembly]

<<span color="#800000">httpHandlers</span>><br></br> <<span color="#800000">add</span> <span color="#ff0000">verb</span>="<span color="#0000ff">GET</span>" <span color="#ff0000">path</span>="<span color="#0000ff">*.application</span>" <span color="#ff0000">type</span>="<span color="#0000ff">WebApplication1.MyHandler,WebApplication1</span>"/><br></br>httpHandlers><br></br>system.web><br></br>configuration><br></br>现在，返回到我们的示例 ClickOnce 应用程序，重新打开 Publish 标签页下的 Updates 对话框。输入指向这个 Web 应用程序的更新位置。

最后，编辑我们之前创建的 HttpHandler，让其针对请求返回适合的版本。这里，我们返回一个硬编码的版本，不过一个真实的实现应该处理验证等功能，以提供更好的灵活性。

标头可以在 IIS 中进行配置或如这里所示的在代码中设置。

一些注意事项

在为 ClickOnce 签名使用临时证书时，一旦证书过期，就需要使用一个新的来代替，那么，应用程序的当前安装就不能再升级了，所有用户都必须重新安装应用程序。这是一个已知的缺陷。幸运的是，已经有一种方式能够无限地延长证书的过期时间。访问这个地址来获取详细信息： http://support.microsoft.com/Default.aspx?kbid=925521 。

使用更新位置来同步部署应用程序清单的位置非常重要。IIS 不能处理未在列表中的文件，所以如果更新路径无效的话你的处理器将永远不会触发。

如果使用 Visual Studio 2008，部署文件夹略有不同。每个版本的.application 文件都放在他们特定的子目录中，而非在主文件夹中。如果你有一个在 VS 2005 下设计的版本方案，并在 VS 2008 中来部署应用程序的话，这就会引起问题。

查看英文原文： Fine Grained Versioning with ClickOnce 。

志愿参与 InfoQ 中文站内容建设，请邮件至 editors@cn.infoq.com 。也欢迎大家到 InfoQ 中文站用户讨论组参与我们的线上讨论。