Skip to content

EXP-Codes/auto-upgrader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

auto-upgrader

升级补丁列表 : [ Management-Page ]


运行环境

插件介绍

此插件是供开发者使用的,通过它可以利用 Github 服务器发布若干个应用的升级补丁。

然后这些应用可以通过 Github 服务器提取自身的升级补丁实现在线升级。

实现原理

实现原理

在 Github的 每个 Repository 都是可以发布一个静态页面的,而且这个静态页面可以在公网访问。

这个静态页面初衷是用来介绍 Repository 的,但是也可以利用它作为一个静态服务页,实现其他功能。

为某个Repository发布静态页面的方法:
  (1) 打开这个Repository的仓库首页
  (2) 进入 Settings 页面
  (3) 找到 GitHub Pages,在 Source下面有一个下拉框, 默认是 None, 修改为 master branch
  (4) 然后刷新 Settings 页面,在 GitHub Pages 的位置会提示:Your site is published at xxx-url
  (5) 在Repository根目录新建一个 index.html 文件,写入页面内容,就可以通过这个 xxx-url 访问它了

回到这个插件,其实原理就很简单了,要实现的功能主要有两个:

  • (在开发环境)通过更新 index.html,在 xxx-url 静态页面维护若干个应用的版本信息和升级补丁
  • (在生产环境)应用从 xxx-url 静态页面提取比当前版本更高的补丁,下载并进行升级

使用方式

由于插件存在两部分功能,因此使用方式也是对应拆分为两部分。


 (开发环境)在 xxx-url 静态页面维护应用的版本信息和升级补丁:

  1. 通过 git 命令 clone 这个插件仓库到本地
  2. 修改 src/main/resources/exp/au/au_conf.xml 中的版本补丁管理页面为你的 xxx-url
  3. 准备好某个应用在升级到下一个版本时需要用到的文件,随便放在一个目录内
  4. 运行 exp.au.PatchMaker,通过UI读取这个目录,制作升级补丁:
    制作升级补丁
  5. 制作补丁的过程根据 UI 的指引去操作即可,简单来说就是告诉升级程序,应用程序在升级时,需要新增、删除、替换、移动哪些文件。点击 一键生成补丁 按钮后,会在 ./patches-for-page/%应用名称%/%补丁版本% 目录下生成补丁包,同时会更新 ./index.html 静态页面中的补丁列表。
  6. 通过 git 提交变更,即成功把应用的版本信息和升级补丁提交到了 Github 服务器
  7. 此时刷新静态页面地址 xxx-url,会发现页面内容已变更,如: 补丁列表


 (生产环境)应用从 xxx-url 静态页面下载高版本补丁并升级:

  1. 通过 maven install 命令发布本插件作为 jar构件,目标应用通过 pom.xml 依赖此构件:
<dependency>
    <groupId>com.exp-blog</groupId>
    <artifactId>auto-upgrader</artifactId>
    <version>${LATEST_VERSION}</version>
</dependency>
  1. 构件内提供了 API:exp.au.api.AppVerInfo.existNewVersion() ,可据此检查 xxx-url 中是否存在新版本补丁
  2. 构件内提供了 API:exp.au.api.AppVerInfo.export() ,让其在应用的 main 方法中执行,可在应用每次运行时导出其版本信息到 ./conf/au.ver 文件,同时在应用根目录生成 软件升级.exe 用于升级
  3. 运行 软件升级.exe 会连接到你的版本补丁管理页面 xxx-url ,点击 检查更新 按钮会与 ./conf/au.ver 文件记录的当前版本进行比较,若存在更高版本时,点击 一键升级 按钮即可自动下载补丁文件并安装升级,如:
    应用升级
  4. 另外,下载的升级补丁会保存到 ./patches 目录,升级成功后会自动删除