如何在前端项目中实现热更新

        这个是组内一位同学在平时开发中,发现调试不便,为团队开发的热更新工具。很厉害,文章中的技术实现内容也是我了解了他的具体实现思路后,整理出来的。

  热更新是什么

  热更新就是当你在开发环境修改代码后,不用刷新整个页面即可看到修改后的效果。
  如果你的项目中使用了webpack的话,你会很幸运,借助webpack-dev-server插件可以实现项目的热更新。

  解决的问题

  对于大型的系统级别项目会有下面几个特点
  模块化(AMD)模式的广泛使用后,开发环境散文件特别多,很容易上百,一不小心还能上千
  初始化的内容特别多,各种底层库,ui库等等
  这两个特点直接导致每次调试后,刷新会很慢。如果初始化的js达到上千的数量级,每一次重新刷新都是5s,10s,甚至20s的等待。
  而热更新的目的就是为了在一定程度上减少这5s,10s,甚20s的浪费。

  遇到的问题

  我们使用的是百度自己的开发环境工具edp,首先他不支持热更新
  我们使用的AMD实践也是百度自己的esl,而且即使是requirejs也暂时没有找到对应的热更新策略,假如requirejs有对应的,我们也无法直接使用
  所以最终的结论是我们自己去实现一个基于我们自己业务的。这样我们考虑的面不用太广,并且解决方案的更有针对性,即面向我们现有的业务框架。最重要的是可以尝试修改底层框架做配合。
  等待路踩通了,我们再去考虑普适性。

  解决的思路

  从ehu/package.json 这个文件中,我们就可以看出一些具体的思路
  需要一个watch功能,即能够监听到文件的修改
  socket.io通知浏览器处理文件的改变
  修改esl这个文件,达到能够实时更新的效果
  当时最简单的考虑,就是文件改变了后,能够通知浏览器,浏览器去重新load这个文件并且执行一次。这个时候再重新去打开这个模块或者功能后,会发现新load的代码在执行后会覆盖上一次的。
  所以当时的我的第一直觉是,esl重复require时,如果后面一次会覆盖前面的,那么可以通过简单的覆盖思路去尝试,结果发现覆盖不了。经过验证,发现是esl内部维护了一个map,即require过的模块会存起来。我们如果希望更新这个模块,只能将map中的对应模块名删除。(后面会详细讲述esl的改造)
  对于工具的要求
  对应这个工具,我当时也提出了几个要求
  esl必然是需要修改的,但是如何对开发人员透明?首先是不能让大家都做这种修改。
  页面中也必须加入socket.io支持,那么我们如何在不影响其他人员开发的情况下加入?
  我们做的属于beta版本,如何选择性的使用?ehu工具和以前的开发模式随意切换?

  安装方便,能否只是作为一个工具,即插即用,不需要繁琐的配置?


  如何使用

  npm install -g ehu(mac下需要sudo,windows下需要管理员权限)
  在原来执行edp webserver start命令的路径 执行 ehu(不再需要执行 edp webserver start)
  原来端口号8848修改为8844(原8848依旧可以使用,但不支持热更新)
  首先使用的方式很简单,为此特意将工具打包到npm上,以后就算有升级,仅仅需要大家update即可。
  另外从使用角度,也尽量集成化(一句命令行即可),避免为了这个工具的使用而做太多额外的事情。
  依赖的框架
  "dependencies": {
  "async": "^1.5.0",
  "commander": "^2.9.0",
  "express": "^4.13.3",
  "express-http-proxy": "^0.6.0",
  "lodash": "^3.10.1",
  "socket.io": "^1.3.7",
  "watch": "^0.16.0"
  }
  几个必要的
  watch--监听文件变化
  socket.io--和浏览器的实时通讯
  express--搭建一个服务
  express-http-proxy--代理
  commander--便于自己写node命令
   工具类:
  async 和 lodash
  框架的思想
  先看看对于这个工具提出的几个要求
  esl必然是需要修改的,但是如何对开发人员透明?首先是不能让大家都做这种修改。
  页面中也必须加入socket.io支持,那么我们如何在不影响其他人员开发的情况下加入?
  我们做的属于beta版本,如何选择性的使用?ehu工具和以前的开发模式随意切换?
  安装方便,能否只是作为一个工具,即插即用,不需要繁琐的配置?
  对于1和2,我们其实是需要修改/添加一些代码的,但是代码都不希望提交到项目的开发环境,因为这些代码生成环境完全不需要。
  所以我们的解决方案是:拦截,改写(偷梁换柱)
  举个例子,当我们需要对esl做一些改造时,我们处理方式是当路由指向esl.js时,我们换成另外一个esl-ehu.js(esl-ehu.js是对esl.js改造后的)返回去,这样就对开发环境的代码透明了。
  socket.io的支持也是同理,我们可以在返回html时,改写html的代码,加入对于socket.io的引入。
  上面的思路其实来源于之前项目构建打包。
  对于3,我们希望在使用工具时,任然能很快切换到以前模式,这样做兼容的目的是希望工具更有竞争力,能吸引大家使用。
  我们的解决方案是:内部实现一个子线程,端口号依然是以前的,而且访问这个端口,就绕过了这个工具。
  对于子线程child_process,我们还遇到一个问题,就是子线程跑系统的时候,经常挂掉,今天刚刚找到一个解决方案,后面会单开一个文章讲这个坑。
  对于4,其实就是使用npm方式
  技术细节
   第一步:搭建一个新服务作为底层,去托管住我们现在edp服务,新服务上有一个路由配置,对于我们需要处理的,拦截。对于不用处理的直接代理给edp
  代码参考
  var mid = express();
  mid.all('*', httpProxy(config.defaultServer, {
  // 先走特殊规则,否则就代理到默认web server
  filter: function(req, res) {
  return !ruleRoute(req, res);
  },
  forwardPath: function(req, res) {
  return URL.parse(req.url).path;
  }
  }));
  // 由express-http-proxy托管路由
  app.use('/', mid);
  ruleRoute就是一些拦截处理
  在此之前,启动下子进程
  var child = require('child_process');
  var cli = child.exec(defaultServerCLI);
  cli.stdout.on('data', function (log) {
  !isServerStarted && (cb(null, log));
  isServerStarted && console.log(log);
  });
  此处有坑,后面单开文章描述
   第二步: 因为上面拦截后的返回的文件已经支持socket.io,esl等底层已经修改了,所以下面是需要去监听文件通知浏览器做对应处理。
  // 启动socket.io服务
  io = require('socket.io')(server);
  io.on('connection', function (socket) {
  socket.emit('hello');
  });
  // 监视文件改动
  initWatch();
   第三步: 做一些集成工作
  program
  .version('0.0.6')
  .usage('[options]')
  .option('-p, --port <n>', 'Set the port', setPort)
  .option('-n, --noServerCLI', '...', noServerCLI)
  .parse(process.argv);
  集成到node命令中
  第四步: 默认配置
  module.exports = {
  // 默认的服务器
  defaultServer: 'http://127.0.0.1:8848',
  // 默认的服务器启动命令
  defaultServerCLI: 'edp webserver start',
  // 从服务器根目录到需要监控的文件夹中间path
  baseDir: 'nirvana-workspace',
  // hot update 需要watch的文件夹(不包括baseDir)
  watchDirs: 'src',
  // 入口文件(不包括baseDir)
  indexHTML: 'main.html',
  // ehu启动端口号(不可与默认的服务器端口号冲突)
  port: 8844
  };
  源码中有很多逻辑是处理配置的
  浏览器依赖
  socket.io--浏览器端仅仅依赖socket这个去和服务端通信

  通信逻辑

  // 建立连接
  socket.on('hello', function () {
  log(getLogMsgPrefix(), 'HotUpdate已启动!');
  });
  // 检测到文件改动
  socket.on('hotUpdate', function (file) {
  // log(getLogMsgPrefix(), '检测到文件改动', file);
  // ....处理文件修改后对应热更新逻辑
  });
  对css/less更新的处理
  这个原理比较简单,页面监听到样式的修改,重新加载一次样式即可,简单的覆盖。
  但是存在一个潜在问题,因为样式是简单的覆盖,所以,如果修改是删除了样式,是无法生效的。
  举例:
  修改前:
  display: none;
  overflow: hidden;
  position: relative;
  background: #FFFFFF;
  border: 1px solid #E8E8E8;
  margin-top: 20px;
  修改后:
  display: none;
  overflow: hidden;
  position: relative;
  background: #FFFFFF;
  删除的border和margin-top其实是没有生效的
  这个也是后期需要解决的一个问题。
  对模板更新的处理
  目前项目中使用的是tpl的模板引擎。
  现在就遇到一个问题,在热更新时,模板引擎其实是重复加载模板的,那么就涉及到重复加载是否后面的会覆盖前面问题。
  查看加载模板的源码后,发现根据配置有三个选择,覆盖,忽略和报错, 我们业务中使用的配置是遇到重复后会报错处理,所以我们需要在不修改业务默认属性的情况下,添加一些逻辑。
  // [esl-hot-update] 重新加载需要覆盖
  window.EHU_HOT_UPDATE_OPTIONS
  && window.EHU_HOT_UPDATE_OPTIONS.etpl.isOverride
  && (namingConflict = 'override');
  switch (namingConflict) {
  /* jshint ignore:start */
  case 'override':
  engine.targets[name] = target;
  context.targets.push(name);
  case 'ignore':
  break;
  /* jshint ignore:end */
  default:
  throw new Error('Target exists: ' + name);
  }
  window.EHU_HOT_UPDATE_OPTIONS.etpl.isOverride这个是修改后自己实现的控制配置修改的逻辑。
  然后这个文件加入到服务端的路由中,请求时替换。
  对js更新的处理
  这里逻辑比较复杂,因为需要修改底层的AMD模块加载的逻辑。
  js没有模板那么简单,不是直接覆盖,因为在AMD模式中,每一个文件,都是被上一个文件调用执行的结果。
  所以我们处理的逻辑是不仅需要重新加载修改的文件,并且递归所有直接或者间接调用他的文件,全部重新加载。
  所以从上面的特点可以看出,这个工具目前阶段主要适用于业务模块的开发,因为业务的依赖不会特别深,对于dep中的核心文件修改,就不是很合适,一旦文件比较底层,热跟新是重新加载的模块也会非常多。
  另外也有很多其他的坑,还在不断优化中。
  总结
  这次实践其实就是业务中遇到的问题(系统太庞大,调试太麻烦),如何解决问题,如何把解决的思路变成一个解决方案,分享给团队。
  因为自己解决了,和形成一个解决方案还是有非常大的差别的,例如我们在形成方案的过程中,就尝试了很多新东西,踩了很多坑。
  目前还有个坑就是chrome浏览器,调试的Source资源时,如果一个资源重复加载,内存中会更新,但是对应的资源没有更新,导致断点时,映射不对(断点失效),目前暂时的解决方案是,每次请求时添加时间戳,让Source映射的资源强制更新。这个可以正常断点,但是断点没有记忆功能(坑啊,因为文件变了)。
  • 0
    点赞
  • 8
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值