一、离线包缓存的简介

离线包缓存含几个包的概念：

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 -> resInfosappId -> resIDVersion -> resVersioninfo.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;