利用Github服务器做一个软件自动升级系统

完整原文（含源码）：http://exp-blog.com/2018/10/19/pid-2453/
（转载请注明出处，仅供分享学习，严禁用于商业用途）

---

声明

• 写这个插件纯粹是出于学习目的，此博文主要作用是功能展示
• 未经允许禁止出于商用目的使用此插件，违者列入授权黑名单并公开示众，所带来的一切后果自负

---

环境

---

简介

此插件是供开发者使用的，通过它可以利用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 静态页面维护应用的版本信息和升级补丁：

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

---

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

• 01.　通过 maven install 命令发布本插件作为 jar构件，目标应用通过 pom.xml 依赖此构件：

<dependency>
  <groupId>exp.augroupId>
  <artifactId>auto-upgraderartifactId>
  <version>1.0version>
dependency>

• 02.　构件内提供了API：exp.au.api.AppVerInfo.existNewVersion() ，可据此检查 xxx-url 中是否存在新版本补丁
• 03.　构件内提供了API：exp.au.api.AppVerInfo.export() ，让其在应用的main方法中执行，可在应用每次运行时导出其版本信息到 ./conf/au.ver 文件，同时在应用根目录生成 软件升级.exe 用于升级
• 04.　运行 软件升级.exe 会连接到你的版本补丁管理页面 xxx-url ，点击 检查更新 按钮会与 ./conf/au.ver 文件记录的当前版本进行比较，若存在更高版本时，点击 一键升级 按钮即可自动下载补丁文件并安装升级，如：
  
  
• 05.　另外，下载的升级补丁会保存到 ./patches 目录，升级成功后会自动删除

---

版权声明

• Site: http://exp-blog.com
• Mail: [email protected]

---