【Android OTA】用nodejs搭建服务器

timg.jpeg

(原文链接)[https://moshuqi.github.io/2017/04/21/Android-OTA-用nodejs搭建服务器/]

OTA,Over-the-Air的简写,OTA升级就是通过GPRS、3G、无线网络下载升级补丁升级,不用通过有线连接来升级。Android的应用或者是整个系统,都可以通过OTA的方式进行版本的更新升级。

OTA具体原理自行google,或者参考这篇文章。本文和接下来的两篇文章主要介绍的是具体的实现过程。

OTA升级大致过程

  1. 设备向服务器进行版本更新检测请求
  2. 服务器将更新信息返回到设备端
  3. 设备通过返回信息下载指定的更新文件
  4. 下载完成后设备安装升级

Android单个应用和整个系统的升级方式存在差异,接下来两篇文章会分别介绍实现。

本文重点实现升级过程中的第二步,搭建一个服务器Demo,以方便后续的测试工作。服务器用的nodejs,使用较为简单,没接触过的也可以跟着下面的步骤将服务器搭建在本地运行起来。

OTA服务器搭建

安装nodejs

用的是Mac系统,安装命令

brew install node

查看是否安装完成

$ node -v
v6.2.0

npm 是专门管理nodejs包的工具,用来方便地安装第三方模块,安装nodejs时应该也默认同时安装了npm,可以命令查看

$ npm -v
3.8.9

运行

安装完成后,先实现个简单的Demo,只需简单几行代码便可在本地运行起一个服务器。

先创建一个文件夹 Server,在文件夹充创建文件 SimpleServer.js

用文本编辑工具打开SimpleServer.js,代码实现:

var http = require('http');

var server = http.createServer(function(req, res) {
    res.end('Hello!');
}).listen(3001);
console.log('Server listening at port: 3001');

然后打开命令行工具,cdServer 目录下,敲入命令运行服务器:

node SimpleServer.js

命令行打印输出:

Server listening at port: 3001

此时服务器开始监听来自本地端口3001的请求。

打开浏览器,地址栏输入 http://localhost:3001 ,可以看到浏览器界面返回文本 Hello!。即一个最简单的服务器。

Express框架

上边实现的服务器对任何请求都返回Hello!文本,现实中服务器当然没那么简单。OTA服务器在接到请求时需要返回对应信息,并提供更新文件的下载接口。

Express 是一种保持最低程度规模的灵活 Node.js Web 应用程序框架,为 Web 和移动应用程序提供一组强大的功能。Express 提供的各种 HTTP 实用程序方法和中间件能帮助我们方便的处理网络请求。具体可参考官方文档

使用Express应用生成器快速搭建框架

使用以下命令安装 express:

npm install express-generator -g

输入如下命令,在当前目录下创建名为 ota 的 Express 应用

express --view=pug ota

看结果打印,在ota目录下自动创建了对应文件

1.jpg

cdota 目录下,安装需要的依赖

cd ota/
npm install

完成后,在node_modules目录下会下载好项目需要的第三方依赖模块

2.jpg

项目的运行文件为 bin/www,打开查看源文件,可看到服务器运行端口默认情况下为 3000

3.jpg

命令行运行服务器

node bin/www 

浏览器打开网址 http://localhost:3000

Express框架默认生成的界面

4.jpg

同时可以看到访问服务器时命令行的打印信息

5.jpg

Ps. 关闭服务器时,在命令行敲 Ctrl + C,如果通过 Ctrl + Z 或者直接关闭命令行窗口界面的方式来退出服务器,会导致服务器监听的端口一直被占用,再次重启服务器时会失败。此时要么修改服务器监听的端口,要么将原端口所对应的进程杀掉。

杀指定端口进程方法,通过 lsof -i:端口号 查看端口对应PID, 然后 kill -9 PID

杀掉node相关的进程

6.jpg

OTA服务器实现

ota更新文件

在项目根目录下创建文件夹 ota_file,将更新文件命名为 update.zip 放在该目录下

7.jpg

路由实现

获取更新信息

通过 /update_info 请求更新信息,将设备当前的版本信息作为参数,例如 http://localhost:3000/update_info?versionName=v01

直接打开文件 routes/index.js,看到代码

/* GET home page. */
router.get('/', function(req, res, next) {
  res.render('index', { title: 'Express' });
});

大概可以理解为,对于 / 请求,服务器会通过代码 res.render('index', { title: 'Express' });,将指定页面返回到浏览器,即我们看到的页面。

对于 /update_info 请求,我们实现个类似的处理方式

具体代码:

router.get('/update_info', function(req, res, next) {
    var name = req.query.versionName;
    console.log('current version:' + name);

    var info = {
        'url': '/ota_file/update.zip',
        'updateMessage': 'Fix bugs.',
        'versionName': 'v2',
        'md5': ''                           
    };

    var dir = process.cwd() + '/ota_file'
    var filePath = path.join(dir, 'update.zip');
    var md5 = getFileMD5(filePath);
    info.md5 = md5;

    res.writeHead(200, {'Content-Type': 'application/json;charset=utf-8'});
    res.end(JSON.stringify(info));
});

当我们在浏览器输入 http://localhost:3000/update_info?versionName=v01 便会运行到该处代码

var name = req.query.versionName;

获取请求中 versionName 参数的值。

检测是否有更新时,设备会将当前版本做为参数发送到服务器,通过与服务器最新的版本进行对比以决定是否需要升级。

var info = {
    'url': '/ota_file/update.zip',
    'updateMessage': 'Fix bugs.',
    'versionName': 'v2',
    'md5': ''                           
};
  • url:更新文件的下载地址
  • updateMessage:用来描述新版本的更新信息
  • versionName:新版本的版本名称
  • md5:更新文件的md5值,用来和设备下载完成的更新包后md5值对比,保证下载完成的文件和服务器的文件一致

获取更新文件的md5值,filePath 为更新文件的目录

var dir = process.cwd() + '/ota_file'
var filePath = path.join(dir, 'update.zip');
var md5 = getFileMD5(filePath);
info.md5 = md5;

最后将 info 转成 json 格式返回

res.writeHead(200, {'Content-Type': 'application/json;charset=utf-8'});
res.end(JSON.stringify(info));

Android设备最终获取到json格式的数据,通过特定字段将对应的值解析出来。

getFileMD5 函数用来获取文件md5值,实现代码:

function getFileMD5(filePath) {
    var buffer = fs.readFileSync(filePath);
    var fsHash = crypto.createHash('md5');

    fsHash.update(buffer);
    var md5 = fsHash.digest('hex');
    console.log("文件的MD5是:%s", md5);

    return md5;
}

一些处理操作用到了系统特定的模块,使用前需要引入

var express = require('express');
var router = express.Router();

// add module
var fs = require('fs');
var path = require('path');
var crypto = require('crypto');

加上代码后,重新运行服务器,进行更新信息的请求,可以看到浏览器返回了对应的json数据

8.jpg
提供文件下载

返回的json数据中可看到其中

'url': '/ota_file/update.zip'

/ota_file/update.zip 即为我们下载文件的路径

文件的下载路由实现代码

router.get('/ota_file/:filename', function(req, res, next) {
    var filename = req.params.filename;
    var dir = process.cwd() + '/ota_file'
    var filePath = path.join(dir, filename);

    fs.exists(filePath, function(exist) {
        if (exist) {
            console.log('downloading:' + filename);
            res.download(filePath); 
        }
        else {
            res.set('Content-type', 'text/html');
            res.end('File not exist.');
        }
    });
});

/ota_file/update.zip 中的 update.zip 对应 /ota_file/:filename 中的 filename,所以下载请求的文件名可通过 filename 参数获取

var filename = req.params.filename;

通过文件名合成文件路径

var dir = process.cwd() + '/ota_file'
var filePath = path.join(dir, filename);

fs.exists 检验指定文件路径是否存在,若是则进行文件下载

服务器的文件下载通过内置的 download 方法实现。

res.download(filePath); 

download 方法实现了http的断点续传协议,用浏览器下载时可尝试暂停下载,再继续下载时会延续之前的下载进度。

Ps. 下载也可通过打开文件将数据流写到客户端的方式来实现,不过过程略麻烦,若要实现断点续传还得根据http协议range属性自行处理。

文件下载实现完成后,重启服务器生效,浏览器输入 localhost:3000/ota_file/update.zip,回车后可看到文件下载到了本地

9.jpg

以上

服务器大概实现完成。实际生产环境中的处理流程会做更多判断和容错,这里只做了简单处理,用来方便给后续Android OTA升级提供测试。

源码地址

关注 ota/routes/index.js 文件即可

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,524评论 5 460
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,869评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,813评论 0 320
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,210评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,085评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,117评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,533评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,219评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,487评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,582评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,362评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,218评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,589评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,899评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,176评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,503评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,707评论 2 335

推荐阅读更多精彩内容