发布1.0.29，添加热更新说明文档

docs/HotUpdate.md

@@ -0,0 +1,161 @@
+## 热更新
+
+* 完全使用creator官方的热更新方案
+
+* 重新封装，使用更简单
+
+* <u>**支持动态变更资源路径**</u>
+
+* cdn上资源结构
+
+  ![image_hotupdate1](https://gitee.com/gongxinhai/public-image/raw/master/image_hotupdate1.jpeg#pic_left)
+
+### 规则
+
+* 和版本号绑定，版本更新后之前的热更新资源失效，（版本号指的是初始化函数中传入的版本号 推荐使用游戏版本号）
+
+* 在构建完成之后的main.js中添加以下内容，可以使用构建模版，或者用脚本修改
+
+  ```javascript
+  (function () {
+      if (typeof window.jsb === 'object') {
+          let saveVersion = localStorage.getItem('hotupdate::version');
+          let searchPaths = localStorage.getItem('hotupdate::searchpaths');
+          //TODO::版本号 这里需要根据自己的项目修改
+          let version = "0.0.2";
+          if (!saveVersion || saveVersion != version ) {
+              localStorage.setItem('hotupdate::searchpaths', null);
+              searchPaths = null;
+          }
+          if (searchPaths) {
+              let paths = JSON.parse(searchPaths);
+              jsb.fileUtils.setSearchPaths(paths);
+  
+              let fileList = [];
+              let storagePath = paths[0] || '';
+              let tempPath = storagePath + '_temp/';
+              let baseOffset = tempPath.length;
+  
+              if (jsb.fileUtils.isDirectoryExist(tempPath) && !jsb.fileUtils.isFileExist(tempPath + 'project.manifest.temp')) {
+                  jsb.fileUtils.listFilesRecursively(tempPath, fileList);
+                  fileList.forEach(srcPath => {
+                      let relativePath = srcPath.substr(baseOffset);
+                      let dstPath = storagePath + relativePath;
+  
+                      if (srcPath[srcPath.length] == '/') {
+                          jsb.fileUtils.createDirectory(dstPath);
+                      } else {
+                          if (jsb.fileUtils.isFileExist(dstPath)) {
+                              jsb.fileUtils.removeFile(dstPath);
+                          }
+                          jsb.fileUtils.renameFile(srcPath, dstPath);
+                      }
+                  })
+                  jsb.fileUtils.removeDirectory(tempPath);
+              }
+          }
+      }
+  })();
+  ```
+
+### 使用
+
+一些枚举类型
+
+```typescript
+export enum HotUpdateCode {
+    /** 成功 */
+    Succeed = 0,
+    /** 平台不支持 不需要热更新 */
+    PlatformNotSupported = -1000,
+    /** 未初始化 */
+    NotInitialized = -1001,
+    /** 是最新版本 */
+    LatestVersion = -1002,
+    /** 更新中 */
+    Updating = -1003,
+    /** 加载本地manifest失败 */
+    LoadManifestFailed = -1004,
+    /** 下载manifest文件失败 */
+    ParseManifestFailed = -1005,
+
+    /** 下载version.manifest失败 */
+    LoadVersionFailed = -1006,
+    /** 解析version.manifest失败 */
+    ParseVersionFailed = -1007,
+
+
+    /** 更新失败 需要重试 */
+    UpdateFailed = -1008,
+    /** 更新错误 */
+    UpdateError = -1009,
+    /** 解压错误 */
+    DecompressError = -1010,
+}
+```
+
+* 初始化 【必须】
+
+  ```typescript
+  /**
+   * 初始化热更新管理器
+   * @param manifestUrl 传入本地manifest文件地址 creator资源Asset下的属性nativeUrl
+   * @param version 游戏版本号 eg: 1.0.0
+   */
+  kunpocc.HotUpdateManager.getInstance().init(manifestUrl: string, version: string)
+  ```
+
+* 检查更新
+
+  ```typescript
+  interface ICheckResult {
+      /** 0:成功 其他:失败 */
+      code: number;
+      /** 失败信息 */
+      message: string;;
+      /** 需要更新的资源大小 (KB) */
+      size?: number;
+  }
+  
+  kunpo.HotUpdateManager.getInstance().checkUpdate().then((res: ICheckResult) => {
+      console.log(`发现更新  资源大小:${res.size}kb`);
+      // 直接更新
+      // this.startUpdate(true);
+  }).catch((err: any) => {
+      log("检查热更新出错了", JSON.stringify(err));
+  	  if (res.code == HotUpdateCode.LatestVersion) {
+          console.log(`已经是最新版本了`);
+      } else {
+          console.log(`出错了 code:${res.code} message:${res.message}`);
+        	// 根据 HotUpdateCode 中的错误码, 做后续处理，或提示，或跳过本次更新等
+      }
+  });
+  ```
+
+* 直接尝试更新
+
+  ```typescript
+  kunpo.HotUpdateManager.getInstance().startUpdate({
+      skipCheck: skipCheck, // 是否跳过检查更新，如果没有提前使用
+      progress: (kb: number, total: number) => {
+          kunpo.log("热更新进度", kb, total);
+      },
+      complete: (code: HotUpdateCode, message: string) => {
+          kunpo.log("热更新成功或者失败了", code, message);
+          if (code == HotUpdateCode.LatestVersion) {
+  		        console.log(`已经是最新版了`);
+          } else if (code == HotUpdateCode.UpdateFailed) {
+            	console.log(`更新失败了 code:${code} message:${message}`);
+            	// 可以在这里重试失败的资源
+            	// kunpo.HotUpdateManager.getInstance().retryUpdate();
+          } else if (code == HotUpdateCode.LoadVersionFailed || code == HotUpdateCode.ParseVersionFailed) {
+            	console.log(`更新失败了 可以选择跳过热更新 code:${code} message:${message}`);
+          } else {
+            	console.log(`其他的失败 code:${code} message:${message}`);
+          }
+      }
+  });
+  ```
+
+  
+