一、离线包缓存的简介

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

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;