三、实例演练
前面我们讨论了.NET应用程序更新是如何工作的,现在我们来将它应用在实例中。
第一步:建立应用程序来进行更新
1. 使用VS.NET生成一个新的Windows应用项目,命名为"SampleApp"。
2. 给窗体一个你选择的有趣的背景色。我们将使用背景色来与后面更新的版本区别。
3. 现在让我们给这个应用程序增加一个细微的功能,首先给你的窗体增加一个按钮。压缩文件中包含一个拥有简单Windows窗体的程序集。给压缩文件中Samples\SampleApp\SimpleForm 程序集增加一个引用。然后在你的按钮事件句柄中添加两行代码:
.. SimpleForm.Form1 F = new SimpleForm.Form1(); F.Show(); |
4. 将你的build标志从debug转换为RELEASE。这将允许我们避免稍后当我们生成一个应用程序的新版本而同时原始拷贝正在运行产生的pdb文件锁定问题。生成并测试你的应用程序。
第二步:添加.NET应用程序更新组件
1. 在VS.NET工具栏的组件标签上,右击选择“自定义工具栏”。选择“.NET框架组件”标签。点“浏览”并选择位于压缩文件中AppUpdater 项目下的AppUpdater.dll,单击OK。
2. 一个AppUpdater图标现在应该出现在工具栏的组件列表的底部。将AppUpdater 组件拖放到SampleApp窗体上。一个名为appUpdater1的.NET应用程序更新组件的实例会出现在窗体的底部。
第三步:设置.NET应用程序更新组件
在这一步我们将设置.NET应用程序更新组件。注意这个示例你只需改变最开始的四个属性,其它的采用默认值。
AppUpdater属性:这是.NET Application应用程序更新的核心,对于本程序需要做以下设置:
(1)AutoFileLoad:这个控制后面要描述的命令下载特征,现在将它设置为true。
(2)ChangeDetectionMode:该枚举决定如何为更新进行检查。在该例中,我们将使用一个服务器显式检查,因此将这个值设置为“ServerManifestCheck ”。
(3)ShowDefaultUI: .NET 应用程序更新组件具有一系列用户界面来通知用户一些事件,比如有一个新的更新可以使用了或者在更新期间发生错误等。这种用户界面可以通过设置默认的用户界面为无效而用自定义应用程序指定的用户界面来代替它,挂钩适当的事件(比如
OnUpdateComplete)并弹出自定义用户界面。对于该例我们将使用默认的用户界面,因此将这个值设置为true 。
(4)UpdateUrl :UpdateUrl 是决定更新程序到何处去寻找更新的。在该例中我们使用一个服务器显式文件来检查更新,因此这个属性应当设置为服务器显式文件的URL 。
在该例中将它设置为:http://yourWebserver/SampleApp_ServerSetup/UpdateVersion.xml。请用你的Web 服务器名
称来代替“yourWebserver ”。
Downloader 属性:AppUpdater 组件有两个子组件。第一个称之为Downloader,它控制组件的下载和Poller属性:AppUpdater的第二个子组件是Poller,Poller控制更新检查。
(1)AutoStart:布尔值,在应用程序启动时控制Poller 是否应当开始轮询或它是否应当等待直到有计划的更新查询开始。
(2)DownloadOnDetection:布尔值,控制Poller 在一个新的更新发现时是否立即开始下载更新,或者是否通过调用DownloadUdpate() 方法开始显式下载。
(3)InitialPollInterval:应用程序启动后在第一次执行更新检查前等待的秒数。
(4)PollInterval:第一次更新检查之后,PollInterval 控制后续每次更新检查之间间隔的秒数,注意:默认为每30 秒进
行一次检查;显然,你会希望你的应用程序减少更新检查的频率。
所有这一切完成之后,你的属性表格看起来应当是下面这个样子:
Samples\SampleApp\SampleApp_Complete目录包含应用程序正确安装的一个版本。 |
安装:
(1)DownloadRetryAttempts:在下载期间如果有错误发生(比如Web 服务器宕机)downloader 会稍后重试。这个属性控制downloader 认为是彻底的应用程序更新错误之前重试网络请求的次数。
(2)SecondsBeteweenDownloadRety:重试网络请求之前等待的秒数。
(3)UpdateRetryAttempts: 在更新期间如果发生严重错误,(例如downloader 超过了试图重试的次数),就会产生一个应用程序更新错误。默认的,将会停止试图更新。但是在应用程序下一次启动时会试图恢复(比如更新Web 服务器可能会宕机好几天)。这个属性控制试图更新的次数。如果超过这个值,updater 就会取消更新,重置它的状态并返回更新检查。
(4)ValidateAssemblies: 这个属性控制下载程序集有效完成的级别。更多信息参见这篇文章的安全一节。
第四步:生成并在客户端部署应用程序V1版本。
在SampleApp项目中,打开AssemblyInfo.cs文件。将AssemblyVersion的值从“1.0”修改为“1.0.0.0”。这会引起在生成程序集时获得值为“1.0.0.0”.. 的标记,该标记代替VS.NET通常指定为递增的值。
1. 生成应用程序。
2.从压缩文件中将Samples\SampleApp\SampleApp_ClientSetup目录拷贝到你的本地机器上。要注意此目录已经包含了AppStart.exe。AppStart.config已经设置为指向1.0.0.0目录并且启动SampleApp.exe。
从SampleApp的release目录下拷贝SampleApp(Appupdater.dll,SimpleForm.dll和SampleApp.exe)
到客户端SampleApp_ClientSetup\1.0.0.0目录下。至此,一个功能完整的应用程序版本已被“安装”到了客户端,可以通过运行AppStart.exe来执行。
第五步:安装Web服务器
在这一步我们将安装Web服务器以提供更新轮询功能。.NET应用程序更新组件使用HTTP-DAV来下载应用程序更新,因此需要一个支持HTTP-DAV的Web服务器。Windows 2000上的IIS5.0和更新的操作系统都支持HTTP-DAV。
1.将Samples/SampleApp_ServerSetup目录拷贝到你的Web服务器上的wwwroot目录下。
2. 将SampleApp的V1版本拷贝到Web服务器的1.0.0.0文件夹。
3. 在Web服务器上为SampleApp_ServerSetup目录启用IIS的“目录浏览”权限。
第六步:自动更新应用程序
OK,.. 现在是时间来通过自动安装一个新版本来看看以上这些艰苦工作的结果了。
1. 如果你部署在客户端的SampleApp版本没有运行,加载它让它运行,记得使用AppStart.exe。
2. 回到VS.NET并在SampleApp窗体中做一些可以被注意到的修改(比如修改背景色)。
3. 将AssemblyInfo.cs的版本信息改为2.0.0.0。
4. 重新生成。
5. 回到Web服务器并生成一个和1.0.0.0目录同等的目录2.0.0.0。从release生成目录下将新版本应用程序拷贝到Web服务器上新建的2.0.0.0目录下。
6.打开UpdateVersion.xml 并修改AvailableVersion为2.0.0.0。修改ApplicationURL为指向新的2.0.0.0路径。
7. 保存对UpdateVersion.xml所做的修改。
一旦你保存了新的UpdateVersion.xml,在30秒之内,运行中的SampleApp拷贝将会探测到新的可用版本。