2021.06.24  最新版本的OAUS

已经支持Windows、Linux、国产化操作系统以及国产CPU。

只要是以下载客户端的形式分发的程序，绝大多数都需要自动升级的功能。

目前主流的程序自动升级策略是，下载最新的安装包，然后重新安装整个客户端。这种方式虽然简单直观，但是缺陷也很明显。

比如，即使整个客户端有100M，而本次更新仅仅只是修改了一个1k大小的dll，那也意味着要重新下载100M的全部内容。这对带宽

是极大的浪费，而且增加了用户茫然等待的时间。傲瑞自动升级系统OAUS可以完美地解决这个问题，在类似的场景中，使用OAUS

就可以只更新那个1k大小被修改了的dll。

一.OAUS的主要功能

OAUS 是一套能够按需更新的智能升级系统，以单个文件而不是整个客户端为升级的基础单元。OAUS提供了高性能的可直接执行的

客户端程序和服务器程序，能以最简洁的方式与您的应用进行集成。

OAUS主要有如下特点：

(1)内核基于ESFramework构建，性能卓越。

(2)版本管理的基础单元为被分发的客户端程序中的每个文件。

(3)程序升级时，支持两种形式：文件添加、文件删除。

(4)升级启动时，只更新那些发生变化的文件。

(5)升级完成后，自动启动新版本的客户端应用程序。

(6)部署简单，方便集成。

本文将着重介绍OAUS的相关背景、使用方法，至于详细的实现细节，大家可以直接下载源码研究。如果了解了OAUS的使用，源码的理解就非常容易了。如果需要直接部署使用自动升级系统，那么，可下载文末的可执行程序压缩包。

二.OAUS的使用(Windows版本)

1.OAUS服务端结构

OAUS提供了可直接执行的服务端程序和客户端程序：AutoUpdaterSystem.Server.exe 和 AutoUpdater.exe。 OAUS服务端的目录结构如下所示：

OAUS的客户端与服务器之间通过TCP通信，可以在AutoUpdaterSystem.Server.exe.config配置文件中配置服务器通过哪个TCP端口提供自动升级服务。

FileFolder文件夹初始是空的，其用于部署被分发的程序的各个文件的最新版本。注意，其下的文件结构一定要与被分发的程序正常部署后的结构完全一致 -- 即相当于在FileFolder文件夹下部署一个被分发的程序。

2.OAUS客户端结构

OAUS客户端文件位于AutoUpdater文件夹中，OAUS规定AutoUpdater文件夹必须位于分发程序的根目录。

比如，以部署好的VideoChatSystem系统客户端为例，如下所示的VideoChatSystem文件夹就是其客户端分发程序的根目录，所以，AutoUpdater文件夹就放在这个目录下。

说明一下，VideoChatSystem文件夹下被分发的每个客户端文件(包括子目录下的文件)都可以实现自动更新，但是，AutoUpdater文件夹是不能更新它自己的。

AutoUpdater文件夹下的文件如下所示：

可以在AutoUpdater.exe.config配置文件中配置OAUS服务器的IP、端口等信息，其内容如下所示：

请注意配置的CallbackExeName，其表示当升级完成之后，将被启动的分发程序的exe的名称。这个CallbackExeName配置的为什么是名称而不是路径了？这是因为使用和部署OAUS客户端时是有要求的：

(1)被分发的程序的可执行文件exe必须位于部署目录的根目录。

(2)OAUS的客户端(即整个AutoUpdater文件夹)也必须位于这个根目录。

如此，AutoUpdater就知道分发程序的exe相对自己的路径，如此就可以确定分发程序的exe的绝对路径，所以就可以在升级完成后启动目标exe了。另外，根据上述的两个约定，再结合前面讲到的服务端的FileFolder文件夹的结构约定，当服务端更新一个文件时，AutoUpdater便可以确定该文件在客户端机器上的绝对路径了。

3. OAUS自动升级流程

下面我们就详细讲讲如何使用OAUS来构建自动升级系统，大概的步骤如下。

(1)运行OAUS服务端。

(2)将被分发的客户端程序的所有内容放到OAUS服务端的FileFolder文件夹下，其结构与客户端程序正常部署后的结构要完全一致。我们以部署VideoChatSystem为例。

(3)使用OAUS服务端为被分发的客户端程序的每个文件生成默认版本号，并创建版本信息配置文件UpdateConfiguration.xml。这个配置文件也将被客户端使用。

点击服务端界面上的“文件版本管理”按钮，将弹出用于管理各个文件版本的【文件版本信息】窗体。

当用新版本的文件覆盖老的文件后，点击“自动扫描”按钮，服务端就会检索FileFolder文件夹下文件的名称、大小、最后更新时间，然后得出本次更新结果：变化了几个文件(变化文件的版本号都会自动增加1)、新增了几个文件、删除了几个文件。

当关闭【文件版本信息】窗体时，只要有某个文件版本变化，则“最后综合版本”的值(int类型)会递增1。通过比较OAUS的客户端保存的“最后综合版本”的值与OAUS的服务端最新的“最后综合版本”的值，就可以快速地识别客户端是否已经是最新版本了。

另外，初次打开这个窗口时，将在OAUS服务端的目录下，自动生成一个版本信息配置文件UpdateConfiguration.xml。而且，每当通过该窗体来设置某个文件的新版本时，UpdateConfiguration.xml会自动同步更新。

(4)将UpdateConfiguration.xml添加到OAUS的客户端程序(即上述的AutoUpdater的文件夹)中。

(5)在创建被分发的客户端的安装程序时，将OAUS的客户端(即AutoUpdater的文件夹)也打包进去，并且像前面说的一样，要将其直接部署在运行目录(BaseDirectory)下(与分发的exe同一目录)。

如此，准备工作就完成了，当客户端通过安装包安装好了VideoChatSystem之后，其目录结构像下面这样：

(6)当我们有新的版本要发布时，比如要更新某个文件(因为文件被修改)，只需：

a. 将修改后的文件拷贝到OAUS服务端的FileFolder文件夹下的正确位置(或覆盖旧的文件)。

b. 在OAUS服务端打开【文件版本信息】窗体，点击“自动扫描”按钮，扫描完成后，关闭该窗体即可。

(7)如此，当客户端再启动AutoUpdater.exe时，就会自动升级，更新那些发生变化的文件。 以下是AutoUpdater.exe运行起来后的截图。

(8)当升级完成后，将启动前述的OAUS客户端配置文件中配置的回调exe。(在本例中就是VideoChatSystem.exe)

(9)OAUS客户端会在日志文件UpdateLog.txt(位于AutoUpdater的文件夹下，在OAUS客户端首次运行时自动生成该文件)中，记录每次自动升级的情况。

(10)如果升级的过程中，与服务端连接中断，则会自动重连，在重连成功后，将启动断点续传。

4.OAUS实现更新的原理

(1)客户端启动时，从服务器获取“最后综合版本”的值，然后与本地的“最后综合版本”的值相比较，如果本地的值较小，则启动OAUS客户端。

(2)在实际执行更新时，是依据每个分发文件的版本号来决定该文件是否需要被更新的。比如对于A.dll这个分发文件，如果在OAUS服务端的版本号更高，则OAUS就会更新这个文件。同样，如果有新增文件或删除文件，OAUS客户端也会同步这些操作。

5.何时启动自动升级客户端？

假设某个系统是下载客户端形式的，那么客户端该如何知道是否有新版本了？然后又该何时启动AutoUpdater.exe了？

我们的经验是这样的：客户端启动时，从服务器获取“最后综合版本”的值，然后与本地的“最后综合版本”的值相比较，如果本地的值较小，则表示客户端需要更新。这个过程可以这样做到：

(1)当在OAUS服务端的FileFolder文件夹下放置了新的文件，并通过【文件版本信息】窗体正确的更新了版本号，在关闭【文件版本信息】窗体时，“最后综合版本”的值会自动加1。

(2)系统客户端可以通过调用OAUS.Core.VersionHelper类的静态方法HasNewVersion()来判断是否有新版本。

(3)如果HasNewVersion方法返回true，则通常有两种模式：由用户选择是否升级，或者是强制升级。

一般而言，如果最新客户端程序与老版本兼容，不升级也影响不大，则可以交由用户决定是否升级；如果最新客户端程序不兼容老版本，或者是有重大更新，则将启动强制升级。如果流程要进入启动升级，那么只要启动AutoUpdater的文件夹下AutoUpdater.exe就可以了。要注意的是，启动AutoUpdater.exe进程后，要退出当前的客户端进程，否则，有些文件会因为无法被覆盖而导致更新失败。代码大致如下所示：

if (VersionHelper.HasNewVersion(oausServerIP,oausServerPort)) {string updateExePath = AppDomain.CurrentDomain.BaseDirectory + "AutoUpdater\\AutoUpdater.exe"; System.Diagnostics.Process myProcess=System.Diagnostics.Process.Start(updateExePath); ......//退出当前进程 }

三.OAUS的使用(Linux版本)

1.OAUS Linux服务端结构

与Windows版本不同，OAUS Linux版是通过命令来运行服务端程序和客户端程序：OAUS.Server.NerCore.dll 和

AutoUpdater.NetCore.dll。

2.OAUS Linux客户端结构

同Windows版本一样，OAUS客户端文件位于OrayTalk文件夹中，OAUS规定AutoUpdater.NetCore文件夹必须位于分发程序的根目录。

3.OAUS Linux升级流程

流程几乎同Windows版本完全一样。

(1)运行OAUS服务端。

(2)将被分发的客户端程序的所有内容放到OAUS服务端的FileFolder文件夹下，其结构与客户端程序正常部署后的结构要完全一致。

(3) 当用新版本的文件覆盖老的文件后，在控制台输入Scan，服务端就会检索FileFolder文件夹下文件的名称、大小、最后更新时间，然后得出本次更新结果：变化了几个文件(变化文件的版本号都会自动增加1)、新增了几个文件、删除了几个文件。

(4)当客户端再启动AutoUpdater.NetCore.dll时，就会自动升级，更新那些发生变化的文件。 以下是OAUS客户端运行起来后的截图。

4.何时启动自动升级客户端？

同Windows版本一样，可做如下判断启动OAUS Linux客户端：

if (VersionHelper.HasNewVersion(oausServerIP,oausServerPort)) {string updateExePath = AppDomain.CurrentDomain.BaseDirectory + "AutoUpdater/AutoUpdater.NetCore.dll"; System.Diagnostics.Process myProcess=System.Diagnostics.Process.Start(updateExePath); ......//退出当前进程 }

注意：只有运行的机器上装有NetCore环境，才能运行OAUS客户端，若要在其他架构如ARM64、Mips64el的机器上运行的话，需将对应架构的libSkiaSharp.so文件拷贝到AutoUpdater.NetCore文件夹中再运行客户端

四.相关下载

注：若需要在非x64 CPU架构的Linux或国产化操作系统上运行OAUS客户端，请联系我们获取对应架构的运行时 - runtimes。

-----------------------------------------------------------------------------------------------------------------------------------------------