应用缓存机制可以参考http://www.w3school.com.cn/html5/html_5_app_cache.asp,不再赘述。利用此机制,html5游戏可以实现和native app类似的更新和运行环境,减少文件的频繁下载。
1. Server设置:
nginx, 修改manifest文件的mime type映射,打开文件$nginx/conf/mime.types,增加
text/cache-manifest manifest;
2. 网页文件设置:
在index.html的<html>标签修改
<html manifest="jstest.manifest">
其中jstest.manifest文件为缓存控制文件(测试起得名字),与index.html同级目录
3. manifest文件:
包含3个段, CACHE, NETWORK, FALLBACK
CACHE: 可以缓存起来的部分,离线可用
NETWORK: 永远不会被缓存,且离线时是不可用的
FALLBACK: 规定如果无法建立因特网连接,则用 "offline.html" 替代 /html5/ 目录中的所有文件
CACHE MANIFEST #version 2014-12-20 15:02:29.247754 CACHE: res/CloseNormal.png res/CloseSelected.png res/favicon.ico res/HelloWorld.png src/aaa.js main.js project.json NETWORK: FALLBACK:
第一行,CACHE MANIFEST,是必须的,指定此文件为manifest文件
第二行,#version注释,标记版本号,因为应用的缓存会在其 manifest 文件更改时被更新,所以每次通过更新version号来更新缓存
用cocos2d-html5测试游戏,发现第二次加载会报cc undefined,原因是引擎的js文件并没有缓存。
解决方法:写一个python脚本自动生成manifest文件,其中CACHE段用遍历方法将frameworks/cocos2d-html5目录下的文件遍历加入,排除不需要模块。例如:
def listDir(root, exceptArr, result): for item in os.listdir(root): filepath = root + "/" + item if item.startswith("."): continue if os.path.isdir(filepath): if filepath in exceptArr: continue else: listDir(filepath, exceptArr, result) else: result.append(filepath) engineList = [ "frameworks/cocos2d-html5/CCBoot.js", "frameworks/cocos2d-html5/CCDebugger.js", "frameworks/cocos2d-html5/moduleConfig.json", "frameworks/cocos2d-html5/Base64Images.js"] exceptList = ["frameworks/cocos2d-html5/cocos2d/physics", "frameworks/cocos2d-html5/extensions", "frameworks/cocos2d-html5/external"] listDir("frameworks/cocos2d-html5/cocos2d", exceptList, engineList)
#engine files are stored in engineList
另一个思路是将引擎文件通过uglifyjs等工具压缩为一个js文件,不过在cocos2d-html5 v3.1环境下部分模块是根据运行环境动态加载的,选取哪些脚本压缩比较头疼,试验后放弃此方法。
4. manifest文件更新与游戏更新:
如上面所提,通过jstest.manifest文件的#version xxx更改来通知浏览器进行更新文件。
浏览器会根据manifest自动下载更新,但是游戏启动前需要保证脚本、资源等更新到最新版本再进入游戏。
在js脚本中可以通过window.applicationCache对象来获取更新进度。
var cache = window.applicationCache; cache.oncached = function() { cc.game.run(); } cache.oncheking = function() { } cache.ondownloading = function() { } cache.onerror = function() { } cache.onnoupdate = function() { cc.game.run(); } cache.onobsolete = function() { } cache.onprogress = function() { } cache.onupdateready = function() { cache.swapCache(); cc.game.run(); }
当浏览器首次缓存应用时,更新状态依次为:ondownloading -> onprogress(*N) -> oncached;
再次加载,如果manifest文件无更改,状态依次为:onnoupdate;
再次加载,如果manifest文件有更改,状态依次为:onprogress(*N) -> onupdateready;更新完毕后需要调用applicationCache.swapCache()才会更新为最新资源,否则还是使用原来的缓存。
onprogress每更新完一个文件就会触发一次(包括.manifest文件本身),在Chrome下progress event有lengthComputable, total, loaded等属性,可以用total和loaded计算更新进度,但在firefox/safari下没有。
5. 浏览器查看应用缓存
我使用的是firefox浏览器,地址栏输入about:cache可以查看网页缓存和应用缓存
appcache
Number of entries: 274 Maximum storage size: 512000 KiB Storage in use: 1816 KiB Storage disk location: /Users/xxx/Library/Caches/Firefox/Profiles/9loj6ek4.default/OfflineCache List Cache Entries
点击List Cache Entries即可查看应用缓存