vue 打包多页面应用解决方案

传统的vue都是spa应用,也就是俗称的单页面应用。但是有些情况下我们可能需要将多个单页面应用整合在一个项目里,这个时候就需要将项目打包成多页面应用了。
具体操作往下看

首先创建一个符合需求的项目,文件目录结构如下


image.png

可以看到,他和传统的项目不同的是,根目录下不再有public文件夹,自然也就没有了index.html。并且src目录下的main.js入口文件也没有了。

取而代之的是pages目录下,多了几个子项目,每个子项目的目录结构都是一个完整的单页面应用的结构,他们有自己的index.html 并且也有自己的入口文件。

接下来需要在vue.config.js里做一些调整

正常情况下,通过webpack配置多页面应用的话我们需要指定多个entry 并且指定多个output。但是 vue.config.js提供了一个叫做pages的配置项给我们,可以做到很便捷的配置这些东西。

要弄明白为什么要配置多入口就得先知道webpack的工作原理,他到底帮我们做了什么。其实webpack简单点理解就是指定入口js,也就是告诉webpack从哪个js开始起手打包,然后指定出口js,也就是最终输出什么js。然后我们还需要借助HtmlWebpackPlugin这个插件帮我们生成模板html文件并且引入我们打包出来的js文件以及css文件。这样一个单页面应用就打包完成了。
而vue.config.js提供的pages配置项应该就是已经整合了entry output以及HtmlWebpackPlugin了。

首先我们一个传统的单页面应用,其实就是一个html文件,然后引入各种js。vue通过自己的路由来替换index.html文件里的模板。这就是一个单页面应用。理解了这个,就不难理解配置多页面应用的过程了。既然一个html文件就是一个单页面应用,那多页面应用无非就是多个html文件嘛。
每个html文件负责自己项目里的东西。我们要做的就是将入口和出口都指定多个就行了。这样打包出来的就是多个html文件,那我们在访问的时候就和在访问真实的服务器上的资源一样,根据具体的文件名访问到对应的项目了。

下面先来看看pages的具体配置都有哪些


image.png
image.png

再来看看我们的配置

  pages:{
    index:{
      entry:'src/pages/pages1/main.ts',
      template:'src/pages/pages1/public/pages1.html',
      title:'pages1'
    },
    pages2:{
      entry:'src/pages/pages2/main.ts',
      template:'src/pages/pages2/public/pages2.html',
      title:'pages1'
    },
    pages3:{
      entry:'src/pages/pages3/main.ts',
      template:'src/pages/pages3/public/pages3.html',
      title:'pages1'
    },
  },

这样配好之后我们运行项目就能根据pages对象里的key值访问到对应的子项目了
比如http://localhost:8080/pages1/ 访问到的就是pages1项目。

上图中配置了一个index,目的是为了访问http://localhost:8080的时候不会空白页,会默认就指向index的模板。当然也可以在devserve的before属性里配置生成一个导航页来跳转目标子项目,这些都是非常自由的。

下面来讲一下在配置的过程中遇到的问题。
问题一:
刚开始配置的时候没有删除掉根目录下public文件夹,然后运行项目一直报错
Multiple chunks emit assets to the same filename。后面搜了很久都找不到合适的答案,这个报错的大概意思就是多个块将资源发射到同一文件名。这里多个块肯定说的就是我们在pages里配置的这几个子项目了。


image.png

估计就是因为output的输出filename没有使用占位符,导致每个都输出成index.html了,但是让我不明白的是为什么在pages里配置的这些子项目明明都指定了自己的模板,还会和public里的index.html扯上关系。

最后解决方案就是要么删除public文件夹,要么在pages里给每个对象指定filename。
但是为什么会出现这个问题,我猜测是构建过程中默认会去找public文件夹下的index.html,即使你配置了一个名为index的入口也无济于事。

或许使用configureWebpack去更改webpack 的配置应该就不会出现这个问题了把,但是那会需要多写很多步骤。

如果想要了解webpack打包多页面的可以看看这篇文章,写的很详细
https://juejin.cn/post/6844903545922158599

下面再调整一下pages,如果有很多个子项目的时候每个都需要这么去写会很麻烦,这里可以通过glob这个库来读取src目录下的文件,然后动态的生成pages的配置项

const { defineConfig } = require('@vue/cli-service')
const glob = require('glob')
function getEntry(){
  let files = glob.sync('src/pages/**/public/*.html')
  const map = {}
  files.forEach(file=>{
    const key = file.split('public/')[1].split('.')[0]
    map[key] = {
      entry:`src/pages/${key}/main.ts`,
      template:file,
      title:key,
      filename:`${key}.html`
    }
  })
  console.log(map)

  return map
}
const pages = getEntry()

module.exports = defineConfig({
  transpileDependencies: true,
  pages
})

正则不太好,只能用点捞的方法去匹配内容了,但是大概步骤就是这样。
glob 是 webpack 安装时依赖的一个第三方模块,该模块允许你使用 * 等符号,
例如 lib/*.js 就是获取 lib 文件夹下的所有 js 后缀名的文件

*代表所有目录,代表所有名称

src/pages/*/public/.html的意思就是src下的pages下的所有目录下的public下的所有html文件的意思。

lQLPJxbRvpm7PvnNAeLNA-OwCE6VJlfUj-sDWLY07sD0AA_995_482.png
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,921评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,635评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,393评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,836评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,833评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,685评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,043评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,694评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,671评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,670评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,779评论 1 332
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,424评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,027评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,984评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,214评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,108评论 2 351
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,517评论 2 343

推荐阅读更多精彩内容