Html5应用程序缓存ApplicationCache

浏览数：40 / 时间：2015年06月11日

应用缓存机制可以参考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()才会更新为最新资源，否则还是使用原来的缓存。

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

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