Hybird-App离线缓存系统

目录

• 背景

• 接口格式

• 离线资源包格式

• 离线资源下发

• 离线资源缓存

背景

因为线上乐刻客户端 App 第一次打开平台 H5 须要几秒的加载时间，这个体验对用户来讲并不友好，为了让用户跳转 H5 和跳转到原生同样的用户体验，就须要把 H5 相关的离线资源包下发给客户端，客户端就可使用离线资源来代替实际网络请求，节省用户等待时间和流量消耗。而且随着业务的发展，不一样的业务升级进度不同，就须要 App 支持模块化升级。

<!--more-->

接口格式

offlineResourceInfo 接口请求方法: POST

offlineResourceInfo 接口请求参数:

Json 形式：

{
    //"appVersion": "2.4.0", 能够去掉，由于请求头会包含
    "resourceversionList": [{
        "name": "m",
        "version": "1.0.0"
    },{
        "name": "coach",
        "version": "1.0.0"
    },{
        "name": "activity",
        "version": "1.0.0"
    }]
}

Form 表单形式：

resourceNames=m,coach,activity&resourceVersions=1.0.0,1.0.0,1.0.0

offlineResourceInfo 接口返回结构体:

{
    "data": {
        "resourceList": [{
                "name": "m",
                "version": "1.0.1",
                "url": "http://cdn.xxx.com/resource/m/m_update_1.0.0_1.0.1.zip",
                "md5": "a4d7feecbcae8e2ccba3b5ba90aa8a83",
                "isfull": false
            },{
                "name": "coach",
                "version": "1.0.1",
                "url":  "http://cdn.xxx.com/resource/coach/coach_full_1.0.1.zip",
                "md5": "a4d7feecbcae8e2ccba3b5ba90aa8a83",
                "isfull": true
            }
        ]
    }
}

参数说明：

"name": 模块名
"version": 升级版本
"url": 资源包下载地址
"md5": 资源包 md5
"isfull": 是不是全量升级包

离线资源包格式

增量和全量升级包拥有一样的结构，包含 config.json 文件和资源文件。

config.json 格式以下，version 记录的是下发的资源版本号，validate 记录的是全部文件的路劲和相应的 md5 hash 值。

{
    "version": "1.0.1",
    "validate": [{
       "path": "528/app.min.cs",
       "md5": "md5($cssFileContent)"
    },{
       "path": "528/app.min.js",
       "md5": "md5($jsFileContent)"
    }]
}

具体的资源与 config.json 平级。

--[528]
----app.min.css
----app.min.js

离线资源下发

下发时机

App 启动时设置定时器定时器-> wifi 环境下 -> 请求服务器接口获取 offlineResourceinfo 接口 response，根据resourceList 的结果来决定是否须要更新，须要更新的模块能够下载 zip 文件

资源包存放目录

按模块目录存放资源包。其中目录 moduleszip 用于存放资源压缩包的路径，目录 modules 用于存放解压后的压缩包路径。

因此每次请求 offlineResourceInfo 接口的时候，也须要遍历全部模块目录下的 config.json 去获取资源版本号。因此第一次请求的话，因为本地目录是空的，对于接口 offlineResourceInfo 的参数 resourceversionList 也是空的。

--[offlineResource]
----[moduleszip]
------[m]
--------[zip]
----------m.update.1.0.0_1.0.1.zip
----------m.full.1.0.1.zip
--------[temp] 解压临时目录
--------[backup] 原有资源备份目录

------[coach]
--------[zip]
----------coach.update.1.0.0_1.0.1.zip
----------coach.full.1.0.1.zip
--------[temp] 解压临时目录
--------[backup] 原有资源备份目录

----[modules]
------[m]
--------config.json
--------其余资源文件

------[coach]
--------config.json
--------其余资源文件

----[modulesflag]
------[m]
--------flag.json

------[coach]
--------flag.json

资源包解压

解压

当下载完资源包，解压以前须要根据接口返回的 md5 值来校验资源包的合法性。

校验子文件过程：须要结合 config.json 和资源来校验每一个文件的合法性，若是不合法，就不添加该资源文件 就不保留整个资源包。

更新资源

增量更新：文件的替换和增长。并且须要合并新老 config.json。
全量更新：覆盖模块目录。

模块资源包更新以前，须要先备份以前的模块资源。例如：拷贝目录 offlineResource/modules/m 到目录offlineResource/moduleszip/m/backup 来进行备份。

容错处理

须要设置标志位，并持久化到 flag.json:

{
    "doingUpgradeFlag": false, // false, 表示升级过程正常，不然升级过程有错误。
    "doingBackupFlag": false // false, 表示备份过程正常，不然备份过程有错误。
}

• 正在升级标志位 (总标志位)

• 正在备份标志位 (是正在升级标志位的一个子集)

正在升级的过程包括， md5 校验资源包，md5 校验每一个资源文件，备份和更新过程。

若是整个升级过程当中发生普通错误，恢复全部标志位，而后结束升级流程。

若是整个升级过程当中发生崩溃或者被杀掉进程，App 再次启动后。此时 正在升级标志位 没有复位 (升级失败)，有如下几种状况须要作容错处理:

1. 若是 正在备份标志位 也没有复位 (备份失败)，此时并不会影响目标模块资源，直接恢复全部标志位。

2. 若是 正在备份标志位 已经复位 (备份成功)，先清空目标模块资源，而后作回滚操做：

   • 回滚成功，直接复位全部标志位。

   • 回滚失败，先清空目标模块资源：

     1. 正常失败，恢复全部标志位。

     2. App 崩溃或被杀掉进程，Nothing To Do.

容错反作用

当 正在升级标志位 没有复位时。此时 App webview 请求不走缓存系统。
不然 App webview 能够继续使用缓存系统。

升级流程图

离线资源缓存

使用缓存时机

只针对 webview 的以 xxx.com 为主域名的请求进行拦截，而后根据请求连接，找到具体文件缓存。

找具体文件缓存的方式：

• 遍历全部模块下的 config.json 文件，看可否找到具体的资源文件。这样效率会比较慢，可是更适合现有的场景。

• 根据连接的一级路径找到对应模块下的 config.json 文件，看可否找到具体的资源文件。这样效率会比较高，可是目前连接的一级路径并不规范。

• 直接根据请求 URL 的 PATH 去本地查找是否存在具体的资源文件。PATH 的一级路径表明模块名，剩余部分表明资源路径。

App 这里会使用第二种方式去找缓存文件，这样的话就须要前端小伙伴规范连接路径。

拿到缓存文件以后，须要再次校验缓存文件的合法性，合法则使用缓存，不合法就须要下面的容错处理。

使用缓存容错处理

若是找到的缓存文件已经损坏或者不存在（解压过程被中断，杀掉进程或者 crash），此时须要继续走网络，而且把网络结果进行 md5 校验，若是合法，须要把该结果保存到缓存系统，若是不合法，不作处理。