vue快速搭建qiankun微前端框架完整步骤

qiankun是什么:

        基于 single-spa 进行二次开发,是一种类似于微服务的架构,是将一个大型应用拆分成若干个更小、更简单,可以独立开发、测试和部署的子应用,然后由一个基座应用根据路由进行应用切换,主要是为了解决大型工程在变更、维护、扩展等方面的困难而提出的!

qiankun的优势:

1、技术兼容性好,各个子应用可以基于不同的技术架构;

2、接入方式,让你接入微应用像使用 iframe 一样简单;

3、耦合性更低,各个团队可以独立开发,互不干扰;

4、可维护性和扩展性更好,便于局部升级和增量升级;

5、JS 沙箱,确保微应用之间 全局变量/事件 不冲突;

qiankun的劣势: 

1、无法支持多实例场景;

2、对vite很不友好,需要改动很多的代码;

3、子应用间的资源共享能力较差,使得项目总体积变大;

4、开发人员要处理分布式系统的复杂性;

5、总体的项目体积比较大,运行服务有时较慢;

我的qiankun目录结构:

 创建主应用:

mkdir qiankun(可自定义文件名)
//创建文件
cd qiankun
//进入文件
vue create qiankun-base(可自定义文件名)
//创建vue项目
cd qiankun-base
//进入创建好的项目
npm i qiankun -s
//进入项目下载qiankun
npm run serve
//起服务

一、 在vue create qiankun-base的时候要注意:

1、手动选择版本(最好选择手动)

2、检查项目所需的功能(最好不要选择linter/formatter这个是ESlint)

3、选择要启动项目的Vue.js版本

4、对路由器使用history模式

  

5、选择一个css预处理器(一定要选择scss要不然后期想使用很麻烦)

6、你喜欢把babel放在哪里

7、将其另存为将来项目的预设

 8、打开项目,进入项目,启动项目cd main(文件名),进入后要下载 npm i qiankun –s,然后再npm run serve(启动服务)!此步骤缺一不可!

二、需要改动的vue和js文件:

1、打开文件src下的main.js按照以下操作(要下载并挂载element ui后边菜单要用):

  

import Vue from 'vue'
import App from './App.vue'
import router from './router'
import ElementUI from 'element-ui';
import 'element-ui/lib/theme-chalk/index.css';

import {registerMicroApps, start} from 'qiankun';
// 引入qiankun里的两个方法
Vue.config.productionTip = false
Vue.use(ElementUI);
const apps = [
  {
    name: 'vueApp', // 应用的名字
    // 一定要跟你你创建的项目的名称一致
    entry: 'http://localhost:10000/', // 默认加载这个html,解析里面的js动态的执行(子应用必须支持跨域,内部使用的是 fetch)
    // 其实就是你其他子应用抛出的端口名
    container: '#vue', // 要渲染到的容器名id
    // 你在主应用中创建的dom元素名
    activeRule: '/vue' ,// 通过哪一个路由来激活
    // 这个是子应用的路径
    sandbox: {
    strictStyleIsolation: true // 开启样式隔离
   }
  },
  {
    name: 'reactApp',
    entry: 'http://localhost:20000/',
    container: '#react',
    activeRule: '/react',
    sandbox: {
    strictStyleIsolation: true // 开启样式隔离
   }
  },
  {
    name: 'tabltest',
    entry: 'http://localhost:5501/',
    container: '#vue2',
    activeRule: '/vue2',
    sandbox: {
      strictStyleIsolation: true // 开启样式隔离
     }
  }
];

registerMicroApps(apps); // 注册应用
start(); // 开启应用

new Vue({
  router,
  render: h => h(App)
}).$mount('#app')

 2、文件src下的App.vue按照操作:(注意)不要给外层div盒子加idclass或其他预选择器:

<template>
  <div style="display:flex;">
    <!-- <div class="left"> -->
      <el-menu :router="true" class="el-menu-vertical-demo" style="width: 15%;">
        <el-submenu index="1">
          <template slot="title">
            <i class="el-icon-location"></i>
            <span slot="title">乾坤架构</span>
          </template>
          <el-menu-item-group>
            <el-menu-item index="/vue">xx模块</el-menu-item>
            <el-menu-item index="/react">xx模块</el-menu-item>
            <el-menu-item index="/vue2">xx模块</el-menu-item>
            <el-menu-item index="/">xx模块</el-menu-item>
          </el-menu-item-group>
        </el-submenu>
      </el-menu>
    <!-- </div> -->
    <!-- <div class="right"> -->
      <router-view v-show="$route.name"></router-view>
      <div id="vue"></div>
      <div id="react"></div>
      <div id="vue2"></div>
    </div>
  <!-- </div> -->
</template>

<style >
html,body{
  width: 100%;
  height: 100%;
  margin: 0;
  padding: 0;
}
.el-menu-vertical-demo:not(.el-menu--collapse) {
  width: 200px;
  min-height: 400px;
}
</style>

主应用需要操作的就结束了! 

创建vue子应用:

cd..
//外层主应用的外层
vue create qiankun-vue
//创建子应用
cd qiankun-vue
//进入子应用
npm run serve
//启动服务

注意:子应用不需要下载qiankun

一、对vue子应用做的操作:

1、请学习主应用的下载操作;

2、打开并进入下载的子应用中src下的main.js;

import Vue from 'vue'
import App from './App.vue'
import router from './router'
Vue.config.productionTip = false
let instance = null;
function render(props) {
  // props 组件通信
  instance = new Vue({
    router,
    render: h => h(App)
  }).$mount('#app') // 这里是挂载到自己的HTML中,基座会拿到这个挂载后的HTML,将其插入进去
}

if (!window.__POWERED_BY_QIANKUN__) { // 如果是独立运行,则手动调用渲染
  render();
}
if(window.__POWERED_BY_QIANKUN__){ // 如果是qiankun使用到了,则会动态注入路径
  __webpack_public_path__ = window.__INJECTED_PUBLIC_PATH_BY_QIANKUN__;
}

// 根据 qiankun 的协议需要导出 bootstrap/mount/unmount
export async function bootstrap(props) {

};
export async function mount(props) {
  render(props);
};
export async function unmount(props) {
  instance.$destroy();
};

3、进入的子应用中vue.config.js(如果没有vue.config.js的话创建一个这样的js文件);

module.exports = {
  devServer: {
    port: 10000,
    headers:{
      'Access-Control-Allow-Origin': '*' // 允许跨域
    }
  },
  configureWebpack: {
    output: {
      library: 'vueApp',
      libraryTarget: 'umd'
    }
  }
};

4、打开并进入下载的子应用中src下的router文件下的index.js(不改变在主应用切换子应用的路由是无法切换);

const router = new VueRouter({
  mode: 'history',
  // qiankun这里也需要改变子应用的路径变化不对
  base: '/vue',
  routes
})

 以上就是vue子应用要改变的文件及其代码!

创建react子应用:

cd..
//回退到qiankun文件夹中(如果在就不必做此操作)
npx create-react-app qiankun-react
//创建react项目
cd qiankun-react
//进入react项目中
npm start
//起服务

注意:子应用不需要下载qiankun

一、对react子应用做的操作:

1、在终端输入命令npx create-react-app reactapp;

npx create-react-app qiankun-react

2、找到src下的index.js配置箭头所指及以下方法;

import React from 'react';
import ReactDOM from 'react-dom';
import './index.css';
import App from './App';

function render(){
  ReactDOM.render(
    <React.StrictMode>
      <App />
    </React.StrictMode>,
    document.getElementById('root')
  );
}
if(!window.__POWERED_BY_QIANKUN__){
  render();
}
export async function bootstrap(){

}
export async function mount() {
  render()
}
export async function unmount(){
  ReactDOM.unmountComponentAtNode( document.getElementById('root'));
}

3、找到config-overrides.js文件里配置若没有创建一个文件config-overrides.js;

module.exports = {
    webpack:(config)=>{
        config.output.library = 'reactApp';
        config.output.libraryTarget = 'umd';
        config.output.publicPath = 'http://localhost:20000/';
        return config;
    },
    devServer:(configFunction)=>{
        return function (proxy,allowedHost){
            const config = configFunction(proxy,allowedHost);
            config.headers = {
                "Access-Control-Allow-Origin":'*'
            }
            return config
        }
    }
}

4、找到src下的serviceWorker.js文件给里面添加方法,函数,拦截(如果子应用在主应用中报错再将此代码与你的这个文件代码替换);

// This optional code is used to register a service worker.
// register() is not called by default.

// This lets the app load faster on subsequent visits in production, and gives
// it offline capabilities. However, it also means that developers (and users)
// will only see deployed updates on subsequent visits to a page, after all the
// existing tabs open on the page have been closed, since previously cached
// resources are updated in the background.

// To learn more about the benefits of this model and instructions on how to
// opt-in, read https://bit.ly/CRA-PWA

const isLocalhost = Boolean(
  window.location.hostname === 'localhost' ||
    // [::1] is the IPv6 localhost address.
    window.location.hostname === '[::1]' ||
    // 127.0.0.0/8 are considered localhost for IPv4.
    window.location.hostname.match(
      /^127(?:\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)){3}$/
    )
);

export function register(config) {
  if (process.env.NODE_ENV === 'production' && 'serviceWorker' in navigator) {
    // The URL constructor is available in all browsers that support SW.
    const publicUrl = new URL(process.env.PUBLIC_URL, window.location.href);
    if (publicUrl.origin !== window.location.origin) {
      // Our service worker won't work if PUBLIC_URL is on a different origin
      // from what our page is served on. This might happen if a CDN is used to
      // serve assets; see https://github.com/facebook/create-react-app/issues/2374
      return;
    }

    window.addEventListener('load', () => {
      const swUrl = `${process.env.PUBLIC_URL}/service-worker.js`;

      if (isLocalhost) {
        // This is running on localhost. Let's check if a service worker still exists or not.
        checkValidServiceWorker(swUrl, config);

        // Add some additional logging to localhost, pointing developers to the
        // service worker/PWA documentation.
        navigator.serviceWorker.ready.then(() => {
          console.log(
            'This web app is being served cache-first by a service ' +
              'worker. To learn more, visit https://bit.ly/CRA-PWA'
          );
        });
      } else {
        // Is not localhost. Just register service worker
        registerValidSW(swUrl, config);
      }
    });
  }
}

function registerValidSW(swUrl, config) {
  navigator.serviceWorker
    .register(swUrl)
    .then(registration => {
      registration.onupdatefound = () => {
        const installingWorker = registration.installing;
        if (installingWorker == null) {
          return;
        }
        installingWorker.onstatechange = () => {
          if (installingWorker.state === 'installed') {
            if (navigator.serviceWorker.controller) {
              // At this point, the updated precached content has been fetched,
              // but the previous service worker will still serve the older
              // content until all client tabs are closed.
              console.log(
                'New content is available and will be used when all ' +
                  'tabs for this page are closed. See https://bit.ly/CRA-PWA.'
              );

              // Execute callback
              if (config && config.onUpdate) {
                config.onUpdate(registration);
              }
            } else {
              // At this point, everything has been precached.
              // It's the perfect time to display a
              // "Content is cached for offline use." message.
              console.log('Content is cached for offline use.');

              // Execute callback
              if (config && config.onSuccess) {
                config.onSuccess(registration);
              }
            }
          }
        };
      };
    })
    .catch(error => {
      console.error('Error during service worker registration:', error);
    });
}

function checkValidServiceWorker(swUrl, config) {
  // Check if the service worker can be found. If it can't reload the page.
  fetch(swUrl, {
    headers: { 'Service-Worker': 'script' },
  })
    .then(response => {
      // Ensure service worker exists, and that we really are getting a JS file.
      const contentType = response.headers.get('content-type');
      if (
        response.status === 404 ||
        (contentType != null && contentType.indexOf('javascript') === -1)
      ) {
        // No service worker found. Probably a different app. Reload the page.
        navigator.serviceWorker.ready.then(registration => {
          registration.unregister().then(() => {
            window.location.reload();
          });
        });
      } else {
        // Service worker found. Proceed as normal.
        registerValidSW(swUrl, config);
      }
    })
    .catch(() => {
      console.log(
        'No internet connection found. App is running in offline mode.'
      );
    });
}

export function unregister() {
  if ('serviceWorker' in navigator) {
    navigator.serviceWorker.ready
      .then(registration => {
        registration.unregister();
      })
      .catch(error => {
        console.error(error.message);
      });
  }
}

 以上就是react子应用需要操作的东西!

猜你喜欢

转载自blog.csdn.net/qq_66180056/article/details/129751305