# micro-front-template

**Repository Path**: aspireT/micro-front-template

## Basic Information

- **Project Name**: micro-front-template
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-12-08
- **Last Updated**: 2022-08-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 微前端架构模板

### 2022.2.9 更新说明

更新 `yarn.lock` 文件，修复部分依赖安装失败问题。

需要 `yarn` 的版本 `>= 1.13.0`。

### 2021.4.26 更新说明

> 将 Static 应用的网络请求更换成 mock 请求。

> 梳理微前端新系列文章大纲

### 2021.3.3 更新说明

> 因服务器到期，所有网络请求均已更换成 mock 请求。
> 
> 教程案例统一以最新的 `master` 分支为主，其余分支未更新。

## 介绍

> 微前端是一种类似于微服务的架构，它将微服务的理念应用于浏览器端，即将单页面前端应用由单一的单体应用转变为多个小型前端应用聚合为一的应用。各个前端应用还可以独立开发、独立部署。同时，它们也可以在共享组件的同时进行并行开发——这些组件可以通过 NPM 或者 Git Tag、Git Submodule 来管理。

本项目是基于 `qiankun` 搭建的微前端架构 `Demo`，你也可以当成 `qiankun-quick-start` 来使用。

本项目使用 `Vue` 作为主应用基座，嵌入了 `Vue、React、Angular、Jquery...` 等等多个技术栈的微应用，架构图和效果图如下：

![架构图](http://shadows-mall.oss-cn-shenzhen.aliyuncs.com/images/blogs/qiankun_practice/8.png)

![效果图](http://shadows-mall.oss-cn-shenzhen.aliyuncs.com/images/blogs/qiankun_practice/42.png)

## 如何运行

> 本项目使用的端口为 `9999、10100、10200、10300、10400`，运行前请确保这几个端口的空闲。
>
> 全量启动项目会比较慢（`Angular` 微应用第一次启动会很慢），需要耐心等待一会儿，适合只查看项目运行效果的童鞋。
> 
> 如果需要调试项目查看效果，建议手动启动主应用和所需的微应用。

本仓库基于 `qiankun` 实现微前端架构，运行命令（全量启动）如下：

```bash
yarn install
yarn examples:install
yarn examples:start
```

## 系列教程

本系列配套教程：

- [基于 qiankun 的微前端最佳实践（万字长文） - 从 0 到 1 篇](https://github.com/a1029563229/Blogs/tree/master/BestPractices/qiankun/Start.md)
- [基于 qiankun 的微前端最佳实践（图文并茂） - 应用部署篇](https://github.com/a1029563229/Blogs/tree/master/BestPractices/qiankun/Deploy.md)
- [基于 qiankun 的微前端最佳实践（图文并茂） - 应用间通信篇](https://github.com/a1029563229/Blogs/tree/master/BestPractices/qiankun/Communication.md)
- [万字长文+图文并茂+全面解析微前端框架 qiankun 源码 - qiankun 篇](https://github.com/a1029563229/Blogs/tree/master/Source-Code/qiankun/1.md)

本系列其他文章计划一到两个月内完成，点个 `Star` 不迷路。

计划如下：

 - 生命周期篇；
 - IE 兼容篇；
 - 性能优化、缓存方案篇；

## 分支说明

`master` 为稳定分支，其他分支根据 [qiankun 实战系列教程](https://github.com/a1029563229/blogs) 划分：

  - `master`：稳定分支，可以直接作为 `qiankun-quick-start` 使用；
  - `feature-inject-sub-apps`：主应用基座搭建、微应用接入方案；
  - `feature-deploy`：应用部署发布方案；
  - `feature-communication`：官方通信方案；
  - `feature-communication-shared`：`Shared` 通信方案；

大家可以根据自己的需求切换分支。

## 关于跨域

由于 `qiankun` 内部使用的是 `Fetch HTML` 的方式加载子应用，所以会遇到跨域问题。我们需要先解决跨域问题，使我们的主应用可以正常加载子应用相关资源。

在开发环境下，本项目配置了跨域解决方案，所以在直接运行项目并不会遇到跨域问题。

生产环境的跨域问题可以参考 `应用部署篇` 的方案。