开发指南

更新时间:2023-08-21 09:33:28下载pdf

本系列文档介绍了微应用项目结构、必要文件、参数介绍等。微应用核心文件目录结构包括 _localesmanifest.jsonmicro.config.jsmocksrc 等。在屏蔽常规前端项目目录后,项目核心文件的目录结构如下所示:

.
├── _locales // 多语言文案,用于微应用的描述信息,对应 manifest.json 文件里的 "lang.{key}"
├── manifest.json // 微应用的描述信息,该文件是微应用的核心配置文件
├── micro.config.js // 配置 webpack,webpack-dev-server 的配置,以及调试时需要的数据
├── mock // 接口 mock
├── src // 微应用内容开发目录
│   ├── App.css
│   ├── App.tsx // 项目首页组件
│   ├── index.css
│   ├── index.tsx // 项目入口文件
│   ├── api // 接口请求函数目录
│   ├── assets // 图片及字体等的资源目录
│   ├── components // 开发组件目录
│   ├── lang // 微应用运行时需要的多语言文案
│   ├── pages // 页面目录
│   ├── public-path.js // 全局变量注入
│   └── styles // 主题色配置文件,支持 深色与浅色 模式之间切换
│   ...
│   ..
│   .
  • _localssrc/lang 包含多语言文案,具体用途差异如下:

    • _locals 的多语言文案不会在运行微应用时被使用。这些多语言文案只用于为微应用的描述补充多语种信息。

    • src/lang 目录下的多语言文案将会在运行微应用时被用于展示。

  • src/App.tsx 默认页面:

    项目创建后,默认仅包含一个页面,即 src/App.tsx。建议尽量将微应用的功能聚合在一个页面上。目前,暂未开放多页面开发能力。