vue2项目下配置qiankun

1、新建名叫project-v3-qiankun的文件夹,用来放整个项目

npm init
npm i npm-run-all@4.1.5  -D

2、新建三个vue项目
main-app => 主项目
b-child => 子项目B
c-build => 子项目C

npx vue create main-app
npx vue create b-build
npx vue create c-build

3、主项目安装和配置
安装

npm i qiankun@2.4.0
npm i vue-router@3.2.0 vuex@3.4.0

代码
qiankun.js

import {
  registerMicroApps,
  start
} from 'qiankun'

export const useQiankun = () => {
  const apps = [
    {
      name: 'b-child', // 必选,微应用的名称,微应用之间必须确保唯一
      entry: 'http://localhost:8022', // - 必选,微应用的入口
      container: '#appContainer', // -必选,微应用的容器节点的选择器或者 Element 实例
      activeRule: '/b-child', // - 必选,微应用的激活规则
      props: { // - 可选,主应用需要传递给微应用的数据。
        msg: '我是父应用传过来的值,传递给B应用'
      }
    },
    {
      name: 'c-child',
      entry: 'http://localhost:8033',
      container: '#appContainer',
      activeRule: '/c-child',
      props: {
        msg: '我是父应用传过来的值,传递给C应用'
      }
    }
  ]

  registerMicroApps(apps, {
    beforeLoad: [
      app => {
        console.log(`${app.name}的beforeLoad阶段`)
      }
    ],
    beforeMount: [
      app => {
        console.log(`${app.name}的beforeMount阶段`)
      }
    ],
    afterMount: [
      app => {
        console.log(`${app.name}的afterMount阶段`)
      }
    ],
    beforeUnmount: [
      app => {
        console.log(`${app.name}的beforeUnmount阶段`)
      }
    ],
    afterUnmount: [
      app => {
        console.log(`${app.name}的afterUnmount阶段`)
      }
    ]
  })

  start({ experimentalStyleIsolation: true, prefetch: 'all' })
}

App.vue

    <!-- id为appContainer就是放置子应用的容器 -->
    <div id="appContainer"></div>

main.js

import {
  useQiankun
} from './qiankun'
.........................
vueApp.$nextTick(() => {
  useQiankun()
})

4、子项目安装和配置(B和C除了名称都一样)
安装

npm i vue-router@3.2.0 vuex@3.4.0

代码
public-path.js

/* eslint-disable camelcase */

if (window.__POWERED_BY_QIANKUN__) {
  // eslint-disable-next-line no-undef
  __webpack_public_path__ = window.__INJECTED_PUBLIC_PATH_BY_QIANKUN__
}

修改main.js如下

import './public-path'
import Vue from 'vue'
import App from './App.vue'
import routes from './router'
import VueRouter from 'vue-router'
import store from './store'

Vue.config.productionTip = false

let router = null
let instance = null

function render ({ container, parentStore } = {}) {
  router = new VueRouter({
    base: window.__POWERED_BY_QIANKUN__ ? '/b-child' : process.env.BASE_URL,
    mode: 'history',
    routes
  })

  instance = new Vue({
    router,
    store,
    data () {
      return {
        parentStore
      }
    },
    render: h => h(App)
  }).$mount(container ? container.querySelector('#bChild') : '#bChild')
  // index.html 里面的 id 需要改成 appVueHash,否则子项目无法独立运行
}

if (!window.__POWERED_BY_QIANKUN__) {
  // 全局变量来判断环境
  render()
}

/**
 * bootstrap 只会在微应用初始化的时候调用一次,下次微应用重新进入时会直接调用 mount 钩子,不会再重复触发 bootstrap。
 * 通常我们可以在这里做一些全局变量的初始化,比如不会在 unmount 阶段被销毁的应用级别的缓存等。
 */
export async function bootstrap () {
  console.log('现在进入子应用b-child的bootstraped阶段')
}

/**
 * 应用每次进入都会调用 mount 方法,通常我们在这里触发应用的渲染方法
 */
export async function mount (props) {
  if (props.parentStore) {
    await props.parentStore.dispatch('getResource', { name: 'B应用的资源' })
  }

  console.log('现在进入子应用b-child的mount周期', props)

  render(props)
}

/**
 * 应用每次 切出/卸载 会调用的方法,通常在这里我们会卸载微应用的应用实例
 */
export async function unmount () {
  console.log('现在进入子应用b-child的unmount阶段')
  instance.$destroy()
  instance.$el.innerHTML = ''
  instance = null
  router = null
}

/**
 * 可选生命周期钩子,仅使用 loadMicroApp 方式加载微应用时生效
 */
export async function update (props) {
  console.log('update props', props)
}

vue.config.js

module.exports = {
    ....................
  devServer: {
    ....................
    headers: {
      'Access-Control-Allow-Origin': '*'
    }
  },
  ....................
  configureWebpack: {
      ....................
    output: {
      // 把子应用打包成 umd 库格式
      library: `${name}-[name]`,
      libraryTarget: 'umd',
      jsonpFunction: `webpackJsonp_${name}`
    }
  }
}

5、运行

npm run dev-all
### 如何配置 Nginx 部署 Vue2Qiankun前端目 #### 使用 Nginx 进行微前端应用部署 对于基于 Vue2 构建并集成 Qiankun 实现的微前端架构的应用程序,在将其部署到生产环境时,通常会利用 Nginx 来处理静态资源分发以及反向代理请求。为了使这些应用程序能够正常工作,特别是在采用 `history` 路由模式的情况下,需要正确设置 Nginx 的配置文件。 #### 修改 Nginx 配置支持 History Mode 当使用 Vue Router 的 history 模式时,所有的 URL 请求都应被重定向至 index.html 文件,除非它们指向实际存在的静态资源(如图片、CSS 或 JavaScript)。这可以通过调整 Nginx 中 location 块内的 try_files 指令来实现: ```nginx server { listen 80; server_name localhost; root /path/to/vue-app/dist; location / { try_files $uri $uri/ /index.html; } # 对于 microApp 开头的子应用路径特别处理 location ~ ^/microApp- { proxy_pass http://backend_server_address; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } } ``` 上述配置确保了即使用户直接访问某个特定页面地址也不会因为找不到对应文件而报错,而是返回单页应用入口 HTML 文档让其接管后续路由解析[^1]。 #### 整合 Qiankun 插件完成多框架协作 为了让多个独立开发的小型 SPA (Single Page Application) 可以无缝嵌入同一个主站之中形成统一界面体验,可以借助 qiankun 提供的能力来进行加载其他 vue 子模块作为远程组件的方式加入进来。安装依赖之后创建相应的注册表用于声明哪些位置会被替换成来自不同源的服务端渲染结果或者纯客户端脚本引入形式的内容[^2]。 通过以上方法即可实现在 nginx 上成功托管包含有 qiankun 支持特性的 vue2 应用实例,并且保持良好的用户体验不受影响。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值