美文网首页react
react 应用多入口配置及实践总结

react 应用多入口配置及实践总结

作者: 88b61f4ab233 | 来源:发表于2019-01-07 21:11 被阅读12次

    背景

    还是之前的那个项目,做完国际化没多久,还没来得及划水, 又有新的活了 -- 移动端的兼容。 考虑到后期的复杂度, 需要做两套资源。 具体的目标是:同一个URL,PC打开就显示PC的那一套, M端打开就显示Mobile的页面。 create-react-app 脚手架本身不支持多入口, 需要改造,今天下午研究了一下,改造了一波, 基本达到了预期, 在这里简单把经验总结分享下。

    先睹为快

    Mobile:

    PC:

    输出之后的文件, 相比之前的index.html, 多了一个额外的mobile.html.

    最终的源代码目录:

    具体的改造步骤如下:

    Steps

    step1: Eject

    在下之前图方便, 直接用了create-react-app, 现在需要更改配置, 需要弹出默认配置:

    在终端执行:yarn eject.

    step2: 修改webpack config

    原本的 webpack.config.dev.js:

    entry: [
     require.resolve('react-dev-utils/webpackHotDevClient'),
     require.resolve('./polyfills'),
     require.resolve('react-error-overlay'),
     paths.appIndexJs,
    ],
    output: {
     path: paths.appBuild,
     pathinfo: true,
     filename: 'static/js/bundle.js',
     chunkFilename: 'static/js/[name].chunk.js',
     publicPath: publicPath,
     devtoolModuleFilenameTemplate: info =>
      path.resolve(info.absoluteResourcePath),
    },
    

    需要修改为:

    entry: {
      index: [
       require.resolve('./polyfills'),
       require.resolve('react-dev-utils/webpackHotDevClient'),
       paths.appIndexJs,
      ],
      mobile: [
       require.resolve('./polyfills'),
       require.resolve('react-dev-utils/webpackHotDevClient'),
       paths.appSrc + "/mobile/index.js",
      ]
     },
     output: {
      pathinfo: true,
      filename: 'static/js/[name].bundle.js',
      chunkFilename: 'static/js/[name].chunk.js',
      publicPath: publicPath,
      devtoolModuleFilenameTemplate: info =>
       path.resolve(info.absoluteResourcePath).replace(/\\/g, '/'),
     },
    

    可能需要注意的几点:

    • entry从原来的数组扩展为对象,每个key代表一个入口。
    • output中的filename要区分输出名,可增加[name]变量,这样会根据entry分别编译出每个entry的js文件。

    这样你就可以在src 目录下新起一个民目录开发新的SPA:

    step3: 生成多个html入口文件

    Webpack配置多入口后,只是编译出多个入口的Js,入口的HTML文件也需要配置, 可以用HtmlWebpackPlugin来生成。

    webpack.config.dev.js 原配置:

    // Generates an `index.html` file with the <script> injected.
    new HtmlWebpackPlugin({
     inject: true,
     chunks: ["index"],
     template: paths.appHtml,
    }),
    

    需要加多一个配置, 改成:

    // Generates an `index.html` file with the <script> injected.
    new HtmlWebpackPlugin({
     inject: true,
     chunks: ["index"],
     template: paths.appHtml,
    }),
    new HtmlWebpackPlugin({
     inject: true,
     chunks: ["mobile"],
     template: paths.appHtml,
     filename: 'mobile.html',
    }),
    
    • 每调一次HtmlWebpackPlugin生成一次HTML页面,这里有两个,所以就会多增加一个mobile.html节点。
    • chunks: 指明哪些webpack入口的js会被注入到这个HTML页面。如果不配置,则将所有entry的JS文件都注入HTML。
    • filename: 指明生成的HTML路径,如果不配置就是dist/index.html。mobile配置了新的filename,避免与第一个入口相互覆盖。
    • template: 指定模版, 我这里因为用的这两个模版都一样, 所以就指定的同一个appHtml, 如有特殊需求, 就新建一个html 文件, 在template字段里引用即可。

    Step4: 配置webpack Dev Server

    上述配置做完后,理论就可以打包出多入口的版本;但使用npm start启动后,发现无论输入/index.html还是/mobile.html,好像都是和原来/index.html显示一样的内容。

    甚至输入显然不存在的/xxxx.html,也显示为/index.html的内容。

    这种现象,初步判断是HTTP服务器把所有请求重定向到了/index.html。

    对于单页应用,这种做法是没有问题的(本来就一个页面), 但我们新增的/mobile.html就可以访问到了。

    参考官方文档 The historyApiFallback option,发现是webpack dev server的问题,还要额外做一些配置,需修改webpackDevServer.config.js:

    原配置:

    historyApiFallback: {
     // Paths with dots should still use the history fallback.
     // See https://github.com/facebookincubator/create-react-app/issues/387.
     disableDotRule: true,
    },
    

    修改为:

    historyApiFallback: {
     // Paths with dots should still use the history fallback.
     // See https://github.com/facebookincubator/create-react-app/issues/387.
     disableDotRule: true,
     // 指明哪些路径映射到哪个html
     rewrites: [
      { from: /^\/mobile.html/, to: '/dist/mobile.html' },
     ]
    },
    

    增加的rewrites节点,特别对/admin.html这个URL重定向为/dist/mobile.html页面(也就是HtmlWebpackPlugin输出的HTML文件路径),这样/mobile.html就可以正常访问了。

    至此,dev环境的多入口问题就解决了。

    *step5: Prod 环境配置

    prod环境,比dev环境更简单。由于不存在webpack Dev Server,直接在config/webpack.config.prod.js同理做2和3步骤即可。

    这时候你就可以通过手动修改URl 来访问了:


    路由相关

    到这, 已经可以手动修改URL 来访问pc 和 mobile的页面了。 还有一个问题没有解决:

    URL最后肯定是不能给你手动改来改去的, 需要根据设备的情况自己判断, 这里有两个思路:

    1: 配置 Nginx 的路径的时候, 加多一个alias 的映射。
    2: 前端根据UA自行配置。

    为了快速出效果, 简单搞了一下, 具体代码如下:


    这样, 不用手动修改URL 也能根据UA自动显示不同的页面了, 具体的效果图在文章开头的先睹为快中。

    其他

    上面的路由就为了简单的出个效果, 比较粗暴, 仅供参考。

    最后

    为了帮助大家让学习变得轻松、高效,给大家免费分享一大批资料,帮助大家在成为全栈工程师,乃至架构师的路上披荆斩棘。在这里给大家推荐一个前端全栈学习交流圈:866109386.欢迎大家进群交流讨论,学习交流,共同进步。

    当真正开始学习的时候难免不知道从哪入手,导致效率低下影响继续学习的信心。

    但最重要的是不知道哪些技术需要重点掌握,学习时频繁踩坑,最终浪费大量时间,所以有有效资源还是很有必要的。

    最后祝福所有遇到瓶疾且不知道怎么办的前端程序员们,祝福大家在往后的工作与面试中一切顺利。

    相关文章

      网友评论

        本文标题:react 应用多入口配置及实践总结

        本文链接:https://www.haomeiwen.com/subject/dvvprqtx.html