iOS-H5离线包本地缓存CCCandyWebCache

495 阅读5分钟
原文链接: www.jianshu.com

一、离线包缓存的简介

离线包缓存含几个包的概念:
  1. 预装包:指通过脚本文件在程序编译时期下载的包。
  2. 增量包:指通过包的文件比对,生成的diff文件(差量包)
  3. 全量包:指完整的包文件
CCCandyWebCache离线包缓存的逻辑
  1. 第一次启动的时候先请求预装包接口安装预装包,同时将预装包请求的response配置表放在本地中,获取预装包zip的文件名字,先去判断是否在预装包配置表里面,然后判断预装包文件的MD5值和预装包配置表fullPackageMD5是否匹配。如果信息都匹配上则将预装包移动到指定的本地目录下(....../webapps/res/),然后解压预装包zip文件。
  2. 预装包解压成功后,会将本地包的信息组装成body去请求检查更新接口,将返回的数据结构转模型,根据state判断是否需要更新,如果要的话去判断是全量更新还是增量更新。然后和本地数据库的模块名字对比是否有匹配,有的话判断该包是否正在更新或者有其他错误状态,如果状态是正确的则使用版本号做对比,看是否需要更新包,如果服务器返回数据的版本号更大则去更新资源。
  3. 如果是增量更新,将diff文件下载下来后,将其MD5值与请求更新的response的对应模块的MD5值做匹配,匹配失败则做全量更新,如果匹配成功则开始增量合并,如果本地老的资源zip包已经不存在则增量合并失败,做全量更新。如果增量包合并失败则进行全量更新。增量包合并成功则解压zip包,替换掉原来的解压后的文件。资源更新成功清除内存缓存。
  4. 全量更新,下载成功后,匹配zip包的MD5值,如果成功则移除原来的模块文件,然后进行解压。
  5. 每次启动都会去请求检查更新这个接口,判断资源是否需要更新。
  6. 拦截的URl的时候,先判断URL 是否包含本地存储的domain,包含则进行本地资源匹配,然后匹配上则去加载本地的html,css,js,等文件。否则正常去请求这个URL。

二、集成SDK遇到的坑

  • 1.因为使用swift项目,pod是动态库,所以需要用本地库去pod

1.SDK的podspec 去掉了作者信息,导致pod不成功.所以要加上
2.SDK的podspec ,homepage 指向不对,导致pod不成功.
3. SDK的podspec 用了ZipArchive第三方库但没有指明依赖关系,导致pod不成功.
  • 2.预装包解析字段不正确

CCCacheManger 360行 开始  // 字段不正确
appVersionInfos -> resInfos
appId -> resID
Version -> resVersion

info.domains = [dic objectForKey:@"domains"];  // 取值不正确
// 更换如下:
if (dic[@"userData"]) {
    info.domains = [dic[@"userData"] objectForKey:@"domains"];
  }
  • 3.字段fullMD5服务器要进行Des加密+Base64,因为SDK对fullMD5进行了Base64 decodo 和 Des解密

  • 4.预装包和检查更新是post请求

  • 5.检查更新返回的response 解析数据不正常导致 crash

HTResourceVersionChecker 214行 SDK模型里面的userData 是字符串 这里是Data类型
  • 6.由于CCCancahce 是正对UIWebView做的缓存,而我们项目是WKWebView ,所以拦截不到网页的请求,需要做一些处理 添加NSURLProtocol+WebKitSupport 这个类,才可以拦截WKWebView的网络请求

// .h文件
#import <Foundation/Foundation.h>

@interface NSURLProtocol (WebKitSupport)

+ (void)wk_registerScheme:(NSString*)scheme;

+ (void)wk_unregisterScheme:(NSString*)scheme;

@end 


// .m文件
#import "NSURLProtocol+WebKitSupport.h"
#import <WebKit/WebKit.h>

/**
 * The functions below use some undocumented APIs, which may lead to rejection by Apple.
 */

FOUNDATION_STATIC_INLINE Class ContextControllerClass() {
    static Class cls;
    if (!cls) {
        cls = [[[WKWebView new] valueForKey:@"browsingContextController"] class];
    }
    return cls;
}

FOUNDATION_STATIC_INLINE SEL RegisterSchemeSelector() {
    return NSSelectorFromString(@"registerSchemeForCustomProtocol:");
}

FOUNDATION_STATIC_INLINE SEL UnregisterSchemeSelector() {
    return NSSelectorFromString(@"unregisterSchemeForCustomProtocol:");
}

@implementation NSURLProtocol (WebKitSupport)

+ (void)wk_registerScheme:(NSString *)scheme {
    Class cls = ContextControllerClass();
    SEL sel = RegisterSchemeSelector();
    if ([(id)cls respondsToSelector:sel]) {
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Warc-performSelector-leaks"
        [(id)cls performSelector:sel withObject:scheme];
#pragma clang diagnostic pop
    }
}

+ (void)wk_unregisterScheme:(NSString *)scheme {
    Class cls = ContextControllerClass();
    SEL sel = UnregisterSchemeSelector();
    if ([(id)cls respondsToSelector:sel]) {
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Warc-performSelector-leaks"
        [(id)cls performSelector:sel withObject:scheme];
#pragma clang diagnostic pop
    }
}

@end
  • 7.增量更新MD5校验失败,进行全量更新,资源是更新但是没有更新本地的version

// 要在CCCandyWebCache  333行进行新的版本赋值
NSArray* comps = [info.composeVersion componentsSeparatedByString:@"&"];
info.version = (comps.count == 2 ? comps[1] : comps[0]);
  • 8.多个包domain应该对应于ResID 的目录名 而不是域名,要不然多个离线包会有问题。

// 如 https://www.baicu.com/feature/task
// feature/task 是zip包解压后的文件目录
  • 9.拦击到的URL匹配规则有问题,要截取到domain的域名去拼接路径,然后去匹配本地是否有缓存。

// CCCacheManager 187行
[_domainWebappInfos enumerateKeysAndObjectsUsingBlock:^(NSString * _Nonnull domain, CCWebAppInfo * _Nonnull webappInfo, BOOL * _Nonnull stop) {
            NSString *domainLastObject = [domain componentsSeparatedByString:@"://"].lastObject;
            if ([url hasPrefix:domainLastObject]) {
                if (webappInfo.status != CCWebAppStatusAvailable) {
                    CCLogWarn(@"[CCCacheManager]:资源正在更新或已出错,请求不使用缓存,url==>:%@。",url);
                }
                if (url.length > domainLastObject.length) {
                    NSString *domainOrigin = [domainLastObject componentsSeparatedByString:@"/"].firstObject;
                    key = [NSString stringWithFormat:@"%@/%@",webappInfo.name,[url substringFromIndex:domainOrigin.length+1]];
                }
                [_urlToKeyMapCache setObject:key forKey:url];
                *stop = YES;
            }
        }];


// CCCacheManager 174 对 webView reload方法 低版本系统做兼容
NSArray* strs = [url componentsSeparatedByString:@"://"];
        if (strs.count == 2) {
            NSArray *strsurl = [strs[1] componentsSeparatedByString:@".html"];
            if (strsurl.count == 2 && [strsurl[1] isEqualToString:@"#/"]) {
               url = [strsurl[0] stringByAppendingString:@".html"];
            } else {
               url = strs[1];
            }
        }
  • 10.移除缓存下载进度观察者 不能放在deinit方法里面 要不然会影响内存泄漏,添加和移除要放在viewWillAppear 和 viewWillDisappear方法里面

  • 11.缓存url不支持带?号访问

  • 12.增量或全量更新判断条件不正确

//  CCCandyWebCache.m 206行
  webappInfo.isDiffTask = _diffEnable ? (versionInfo.diffUrl.length  ? YES : NO) : NO; 
// 更换如下:
  webappInfo.isDiffTask = _diffEnable ? (versionInfo.diffUrl.length > 0 ? YES : NO) : NO;