一、离线包缓存的简介
离线包缓存含几个包的概念：
- 预装包：指通过脚本文件在程序编译时期下载的包。
- 增量包：指通过包的文件比对，生成的diff文件（差量包）
- 全量包：指完整的包文件
CCCandyWebCache离线包缓存的逻辑
- 第一次启动的时候先请求预装包接口安装预装包，同时将预装包请求的response配置表放在本地中，获取预装包zip的文件名字，先去判断是否在预装包配置表里面，然后判断预装包文件的MD5值和预装包配置表fullPackageMD5是否匹配。如果信息都匹配上则将预装包移动到指定的本地目录下（....../webapps/res/),然后解压预装包zip文件。
- 预装包解压成功后，会将本地包的信息组装成body去请求检查更新接口，将返回的数据结构转模型，根据state判断是否需要更新，如果要的话去判断是全量更新还是增量更新。然后和本地数据库的模块名字对比是否有匹配，有的话判断该包是否正在更新或者有其他错误状态，如果状态是正确的则使用版本号做对比，看是否需要更新包，如果服务器返回数据的版本号更大则去更新资源。
- 如果是增量更新，将diff文件下载下来后，将其MD5值与请求更新的response的对应模块的MD5值做匹配，匹配失败则做全量更新,如果匹配成功则开始增量合并，如果本地老的资源zip包已经不存在则增量合并失败，做全量更新。如果增量包合并失败则进行全量更新。增量包合并成功则解压zip包，替换掉原来的解压后的文件。资源更新成功清除内存缓存。
- 全量更新，下载成功后，匹配zip包的MD5值，如果成功则移除原来的模块文件，然后进行解压。
- 每次启动都会去请求检查更新这个接口，判断资源是否需要更新。
- 拦截的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不成功.
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方法里面
// CCCandyWebCache.m 206行
webappInfo.isDiffTask = _diffEnable ? (versionInfo.diffUrl.length ? YES : NO) : NO;
// 更换如下：
webappInfo.isDiffTask = _diffEnable ? (versionInfo.diffUrl.length > 0 ? YES : NO) : NO;
