fes.js/guide/upgrade3.html

23 lines
35 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html lang="en-US" dir="ltr">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>从 2.0.x 迁移到 3.0.x | Fes.js</title>
<meta name="description" content="一个好用的前端应用解决方案">
<link rel="preload stylesheet" href="/fes.js/assets/style.9b2080ed.css" as="style">
<script type="module" src="/fes.js/assets/app.d933bee4.js"></script>
<link rel="preload" href="/fes.js/assets/inter-roman-latin.2ed14f66.woff2" as="font" type="font/woff2" crossorigin="">
<link rel="modulepreload" href="/fes.js/assets/chunks/framework.85b09291.js">
<link rel="modulepreload" href="/fes.js/assets/chunks/theme.d167e4a7.js">
<link rel="modulepreload" href="/fes.js/assets/guide_upgrade3.md.aa1339b5.lean.js">
<link rel="icon" href="/logo.png">
<script id="check-dark-light">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
</head>
<body>
<div id="app"><div class="Layout" data-v-d3edc1d3><!--[--><!--]--><!--[--><span tabindex="-1" data-v-59268664></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-59268664> Skip to content </a><!--]--><!----><header class="VPNav" data-v-d3edc1d3 data-v-31544dc1><div class="VPNavBar has-sidebar" data-v-31544dc1 data-v-518cc426><div class="container" data-v-518cc426><div class="title" data-v-518cc426><div class="VPNavBarTitle has-sidebar" data-v-518cc426 data-v-9f409f7c><a class="title" href="/fes.js/" data-v-9f409f7c><!--[--><!--]--><!--[--><img class="VPImage logo" src="/fes.js/logo.png" alt data-v-74f25ba3><!--]--><!--[-->Fes.js<!--]--><!--[--><!--]--></a></div></div><div class="content" data-v-518cc426><div class="curtain" data-v-518cc426></div><div class="content-body" data-v-518cc426><!--[--><!--]--><div class="VPNavBarSearch search" style="--vp-meta-key:&#39;Meta&#39;;" data-v-518cc426><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><svg class="DocSearch-Search-Icon" width="20" height="20" viewBox="0 0 20 20" aria-label="search icon"><path d="M14.386 14.386l4.0877 4.0877-4.0877-4.0877c-2.9418 2.9419-7.7115 2.9419-10.6533 0-2.9419-2.9418-2.9419-7.7115 0-10.6533 2.9418-2.9419 7.7115-2.9419 10.6533 0 2.9419 2.9418 2.9419 7.7115 0 10.6533z" stroke="currentColor" fill="none" fill-rule="evenodd" stroke-linecap="round" stroke-linejoin="round"></path></svg><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-518cc426 data-v-59f637f9><span id="main-nav-aria-label" class="visually-hidden" data-v-59f637f9>Main Navigation</span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink active" href="/fes.js/guide/" tabindex="0" data-v-59f637f9 data-v-eff41f9d data-v-83901ecb><!--[-->指南<!--]--><!----></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/fes.js/reference/config/" tabindex="0" data-v-59f637f9 data-v-eff41f9d data-v-83901ecb><!--[-->编译时配置<!--]--><!----></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/fes.js/reference/api/" tabindex="0" data-v-59f637f9 data-v-eff41f9d data-v-83901ecb><!--[-->API<!--]--><!----></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/fes.js/reference/plugin/" tabindex="0" data-v-59f637f9 data-v-eff41f9d data-v-83901ecb><!--[-->插件<!--]--><!----></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/fes.js/reference/cli/index.html" tabindex="0" data-v-59f637f9 data-v-eff41f9d data-v-83901ecb><!--[-->CLI<!--]--><!----></a><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup" data-v-59f637f9 data-v-66a2feed><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-66a2feed><span class="text" data-v-66a2feed><!----> v3.1.0 <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewbox="0 0 24 24" class="text-icon" data-v-66a2feed><path d="M12,16c-0.3,0-0.5-0.1-0.7-0.3l-6-6c-0.4-0.4-0.4-1,0-1.4s1-0.4,1.4,0l5.3,5.3l5.3-5.3c0.4-0.4,1-0.4,1.4,0s0.4,1,0,1.4l-6,6C12.5,15.9,12.3,16,12,16z"></path></svg></span></button><div class="menu" data-v-66a2feed><div class="VPMenu" data-v-66a2feed data-v-2548f0fa><div class="items" data-v-2548f0fa><!--[--><!--[--><div class="VPMenuLink" data-v-2548f0fa data-v-5cbd515c><a class="VPLink link" href="https://fesjs.mumblefe.cn/2.0/" target="_blank" rel="noreferrer" data-v-5cbd515c data-v-83901ecb><!--[-->v2.0<!--]--><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" height="24px" viewbox="0 0 24 24" width="24px" class="icon" data-v-83901ecb><path d="M0 0h24v24H0V0z" fill="none"></path><path d="M9 5v2h6.59L4 18.59 5.41 20 17 8.41V15h2V5H9z"></path></svg></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-2548f0fa data-v-5cbd515c><a class="VPLink link" href="https://fesjs.mumblefe.cn/1.0/" target="_blank" rel="noreferrer" data-v-5cbd515c data-v-83901ecb><!--[-->v1.0<!--]--><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" height="24px" viewbox="0 0 24 24" width="24px" class="icon" data-v-83901ecb><path d="M0 0h24v24H0V0z" fill="none"></path><path d="M9 5v2h6.59L4 18.59 5.41 20 17 8.41V15h2V5H9z"></path></svg></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup" data-v-59f637f9 data-v-66a2feed><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-66a2feed><span class="text" data-v-66a2feed><!----> 了解更多 <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewbox="0 0 24 24" class="text-icon" data-v-66a2feed><path d="M12,16c-0.3,0-0.5-0.1-0.7-0.3l-6-6c-0.4-0.4-0.4-1,0-1.4s1-0.4,1.4,0l5.3,5.3l5.3-5.3c0.4-0.4,1-0.4,1.4,0s0.4,1,0,1.4l-6,6C12.5,15.9,12.3,16,12,16z"></path></svg></span></button><div class="menu" data-v-66a2feed><div class="VPMenu" data-v-66a2feed data-v-2548f0fa><div class="items" data-v-2548f0fa><!--[--><!--[--><div class="VPMenuLink" data-v-2548f0fa data-v-5cbd515c><a class="VPLink link" href="https://github.com/WeBankFinTech/fes.js/blob/master/CHANGELOG.md" target="_blank" rel="noreferrer" data-v-5cbd515c data-v-83901ecb><!--[-->更新日志<!--]--><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" height="24px" viewbox="0 0 24 24" width="24px" class="icon" data-v-83901ecb><path d="M0 0h24v24H0V0z" fill="none"></path><path d="M9 5v2h6.59L4 18.59 5.41 20 17 8.41V15h2V5H9z"></path></svg></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-2548f0fa data-v-5cbd515c><a class="VPLink link" href="http://fes-design.mumblefe.cn/" target="_blank" rel="noreferrer" data-v-5cbd515c data-v-83901ecb><!--[-->fes-design<!--]--><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" height="24px" viewbox="0 0 24 24" width="24px" class="icon" data-v-83901ecb><path d="M0 0h24v24H0V0z" fill="none"></path><path d="M9 5v2h6.59L4 18.59 5.41 20 17 8.41V15h2V5H9z"></path></svg></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-518cc426 data-v-0f013d30><label title="toggle dark mode" data-v-0f013d30 data-v-a115155e><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" aria-checked="false" data-v-a115155e data-v-5559e67f><span class="check" data-v-5559e67f><span class="icon" data-v-5559e67f><!--[--><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewbox="0 0 24 24" class="sun" data-v-a115155e><path d="M12,18c-3.3,0-6-2.7-6-6s2.7-6,6-6s6,2.7,6,6S15.3,18,12,18zM12,8c-2.2,0-4,1.8-4,4c0,2.2,1.8,4,4,4c2.2,0,4-1.8,4-4C16,9.8,14.2,8,12,8z"></path><path d="M12,4c-0.6,0-1-0.4-1-1V1c0-0.6,0.4-1,1-1s1,0.4,1,1v2C13,3.6,12.6,4,12,4z"></path><path d="M12,24c-0.6,0-1-0.4-1-1v-2c0-0.6,0.4-1,1-1s1,0.4,1,1v2C13,23.6,12.6,24,12,24z"></path><path d="M5.6,6.6c-0.3,0-0.5-0.1-0.7-0.3L3.5,4.9c-0.4-0.4-0.4-1,0-1.4s1-0.4,1.4,0l1.4,1.4c0.4,0.4,0.4,1,0,1.4C6.2,6.5,5.9,6.6,5.6,6.6z"></path><path d="M19.8,20.8c-0.3,0-0.5-0.1-0.7-0.3l-1.4-1.4c-0.4-0.4-0.4-1,0-1.4s1-0.4,1.4,0l1.4,1.4c0.4,0.4,0.4,1,0,1.4C20.3,20.7,20,20.8,19.8,20.8z"></path><path d="M3,13H1c-0.6,0-1-0.4-1-1s0.4-1,1-1h2c0.6,0,1,0.4,1,1S3.6,13,3,13z"></path><path d="M23,13h-2c-0.6,0-1-0.4-1-1s0.4-1,1-1h2c0.6,0,1,0.4,1,1S23.6,13,23,13z"></path><path d="M4.2,20.8c-0.3,0-0.5-0.1-0.7-0.3c-0.4-0.4-0.4-1,0-1.4l1.4-1.4c0.4-0.4,1-0.4,1.4,0s0.4,1,0,1.4l-1.4,1.4C4.7,20.7,4.5,20.8,4.2,20.8z"></path><path d="M18.4,6.6c-0.3,0-0.5-0.1-0.7-0.3c-0.4-0.4-0.4-1,0-1.4l1.4-1.4c0.4-0.4,1-0.4,1.4,0s0.4,1,0,1.4l-1.4,1.4C18.9,6.5,18.6,6.6,18.4,6.6z"></path></svg><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewbox="0 0 24 24" class="moon" data-v-a115155e><path d="M12.1,22c-0.3,0-0.6,0-0.9,0c-5.5-0.5-9.5-5.4-9-10.9c0.4-4.8,4.2-8.6,9-9c0.4,0,0.8,0.2,1,0.5c0.2,0.3,0.2,0.8-0.1,1.1c-2,2.7-1.4,6.4,1.3,8.4c2.1,1.6,5,1.6,7.1,0c0.3-0.2,0.7-0.3,1.1-0.1c0.3,0.2,0.5,0.6,0.5,1c-0.2,2.7-1.5,5.1-3.6,6.8C16.6,21.2,14.4,22,12.1,22zM9.3,4.4c-2.9,1-5,3.6-5.2,6.8c-0.4,4.4,2.8,8.3,7.2,8.7c2.1,0.2,4.2-0.4,5.8-1.8c1.1-0.9,1.9-2.1,2.4-3.4c-2.5,0.9-5.3,0.5-7.5-1.1C9.2,11.4,8.1,7.7,9.3,4.4z"></path></svg><!--]--></span></span></button></label></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-518cc426 data-v-68be864b data-v-036d02a2><!--[--><a class="VPSocialLink" href="https://github.com/WeBankFinTech/fes.js" aria-label="github" target="_blank" rel="noopener" data-v-036d02a2 data-v-5ea6463d><svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>GitHub</title><path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12"/></svg></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-518cc426 data-v-22c4504f data-v-66a2feed><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-66a2feed><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewbox="0 0 24 24" class="icon" data-v-66a2feed><circle cx="12" cy="12" r="2"></circle><circle cx="19" cy="12" r="2"></circle><circle cx="5" cy="12" r="2"></circle></svg></button><div class="menu" data-v-66a2feed><div class="VPMenu" data-v-66a2feed data-v-2548f0fa><!----><!--[--><!--[--><!----><div class="group" data-v-22c4504f><div class="item appearance" data-v-22c4504f><p class="label" data-v-22c4504f>Appearance</p><div class="appearance-action" data-v-22c4504f><label title="toggle dark mode" data-v-22c4504f data-v-a115155e><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" aria-checked="false" data-v-a115155e data-v-5559e67f><span class="check" data-v-5559e67f><span class="icon" data-v-5559e67f><!--[--><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewbox="0 0 24 24" class="sun" data-v-a115155e><path d="M12,18c-3.3,0-6-2.7-6-6s2.7-6,6-6s6,2.7,6,6S15.3,18,12,18zM12,8c-2.2,0-4,1.8-4,4c0,2.2,1.8,4,4,4c2.2,0,4-1.8,4-4C16,9.8,14.2,8,12,8z"></path><path d="M12,4c-0.6,0-1-0.4-1-1V1c0-0.6,0.4-1,1-1s1,0.4,1,1v2C13,3.6,12.6,4,12,4z"></path><path d="M12,24c-0.6,0-1-0.4-1-1v-2c0-0.6,0.4-1,1-1s1,0.4,1,1v2C13,23.6,12.6,24,12,24z"></path><path d="M5.6,6.6c-0.3,0-0.5-0.1-0.7-0.3L3.5,4.9c-0.4-0.4-0.4-1,0-1.4s1-0.4,1.4,0l1.4,1.4c0.4,0.4,0.4,1,0,1.4C6.2,6.5,5.9,6.6,5.6,6.6z"></path><path d="M19.8,20.8c-0.3,0-0.5-0.1-0.7-0.3l-1.4-1.4c-0.4-0.4-0.4-1,0-1.4s1-0.4,1.4,0l1.4,1.4c0.4,0.4,0.4,1,0,1.4C20.3,20.7,20,20.8,19.8,20.8z"></path><path d="M3,13H1c-0.6,0-1-0.4-1-1s0.4-1,1-1h2c0.6,0,1,0.4,1,1S3.6,13,3,13z"></path><path d="M23,13h-2c-0.6,0-1-0.4-1-1s0.4-1,1-1h2c0.6,0,1,0.4,1,1S23.6,13,23,13z"></path><path d="M4.2,20.8c-0.3,0-0.5-0.1-0.7-0.3c-0.4-0.4-0.4-1,0-1.4l1.4-1.4c0.4-0.4,1-0.4,1.4,0s0.4,1,0,1.4l-1.4,1.4C4.7,20.7,4.5,20.8,4.2,20.8z"></path><path d="M18.4,6.6c-0.3,0-0.5-0.1-0.7-0.3c-0.4-0.4-0.4-1,0-1.4l1.4-1.4c0.4-0.4,1-0.4,1.4,0s0.4,1,0,1.4l-1.4,1.4C18.9,6.5,18.6,6.6,18.4,6.6z"></path></svg><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewbox="0 0 24 24" class="moon" data-v-a115155e><path d="M12.1,22c-0.3,0-0.6,0-0.9,0c-5.5-0.5-9.5-5.4-9-10.9c0.4-4.8,4.2-8.6,9-9c0.4,0,0.8,0.2,1,0.5c0.2,0.3,0.2,0.8-0.1,1.1c-2,2.7-1.4,6.4,1.3,8.4c2.1,1.6,5,1.6,7.1,0c0.3-0.2,0.7-0.3,1.1-0.1c0.3,0.2,0.5,0.6,0.5,1c-0.2,2.7-1.5,5.1-3.6,6.8C16.6,21.2,14.4,22,12.1,22zM9.3,4.4c-2.9,1-5,3.6-5.2,6.8c-0.4,4.4,2.8,8.3,7.2,8.7c2.1,0.2,4.2-0.4,5.8-1.8c1.1-0.9,1.9-2.1,2.4-3.4c-2.5,0.9-5.3,0.5-7.5-1.1C9.2,11.4,8.1,7.7,9.3,4.4z"></path></svg><!--]--></span></span></button></label></div></div></div><div class="group" data-v-22c4504f><div class="item social-links" data-v-22c4504f><div class="VPSocialLinks social-links-list" data-v-22c4504f data-v-036d02a2><!--[--><a class="VPSocialLink" href="https://github.com/WeBankFinTech/fes.js" aria-label="github" target="_blank" rel="noopener" data-v-036d02a2 data-v-5ea6463d><svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>GitHub</title><path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12"/></svg></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-518cc426 data-v-69d5f97f><span class="container" data-v-69d5f97f><span class="top" data-v-69d5f97f></span><span class="middle" data-v-69d5f97f></span><span class="bottom" data-v-69d5f97f></span></span></button></div></div></div></div><!----></header><div class="VPLocalNav" data-v-d3edc1d3 data-v-a608b4c2><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-a608b4c2><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewbox="0 0 24 24" class="menu-icon" data-v-a608b4c2><path d="M17,11H3c-0.6,0-1-0.4-1-1s0.4-1,1-1h14c0.6,0,1,0.4,1,1S17.6,11,17,11z"></path><path d="M21,7H3C2.4,7,2,6.6,2,6s0.4-1,1-1h18c0.6,0,1,0.4,1,1S21.6,7,21,7z"></path><path d="M21,15H3c-0.6,0-1-0.4-1-1s0.4-1,1-1h18c0.6,0,1,0.4,1,1S21.6,15,21,15z"></path><path d="M17,19H3c-0.6,0-1-0.4-1-1s0.4-1,1-1h14c0.6,0,1,0.4,1,1S17.6,19,17,19z"></path></svg><span class="menu-text" data-v-a608b4c2>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-a608b4c2 data-v-7fc5e44e><button data-v-7fc5e44e>Return to top</button><!----></div></div><aside class="VPSidebar" data-v-d3edc1d3 data-v-084bed16><div class="curtain" data-v-084bed16></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-084bed16><span class="visually-hidden" id="sidebar-aria-label" data-v-084bed16> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="group" data-v-084bed16><section class="VPSidebarItem level-0" data-v-084bed16 data-v-9b2ca4cb><div class="item" role="button" tabindex="0" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><h2 class="text" data-v-9b2ca4cb>开始</h2><!----></div><div class="items" data-v-9b2ca4cb><!--[--><div class="VPSidebarItem level-1 is-link" data-v-9b2ca4cb data-v-9b2ca4cb><div class="item" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><a class="VPLink link link" href="/fes.js/guide/index.html" data-v-9b2ca4cb data-v-83901ecb><!--[--><p class="text" data-v-9b2ca4cb>介绍</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9b2ca4cb data-v-9b2ca4cb><div class="item" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><a class="VPLink link link" href="/fes.js/guide/getting-started.html" data-v-9b2ca4cb data-v-83901ecb><!--[--><p class="text" data-v-9b2ca4cb>快速上手</p><!--]--><!----></a><!----></div><!----></div><!--]--></div></section></div><div class="group" data-v-084bed16><section class="VPSidebarItem level-0 has-active" data-v-084bed16 data-v-9b2ca4cb><div class="item" role="button" tabindex="0" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><h2 class="text" data-v-9b2ca4cb>基础</h2><!----></div><div class="items" data-v-9b2ca4cb><!--[--><div class="VPSidebarItem level-1 is-link" data-v-9b2ca4cb data-v-9b2ca4cb><div class="item" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><a class="VPLink link link" href="/fes.js/guide/directory-structure.html" data-v-9b2ca4cb data-v-83901ecb><!--[--><p class="text" data-v-9b2ca4cb>目录结构</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9b2ca4cb data-v-9b2ca4cb><div class="item" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><a class="VPLink link link" href="/fes.js/guide/builder.html" data-v-9b2ca4cb data-v-83901ecb><!--[--><p class="text" data-v-9b2ca4cb>Vite 和 Webpack 双构建</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9b2ca4cb data-v-9b2ca4cb><div class="item" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><a class="VPLink link link" href="/fes.js/guide/config.html" data-v-9b2ca4cb data-v-83901ecb><!--[--><p class="text" data-v-9b2ca4cb>编译时配置</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9b2ca4cb data-v-9b2ca4cb><div class="item" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><a class="VPLink link link" href="/fes.js/guide/runtime-config.html" data-v-9b2ca4cb data-v-83901ecb><!--[--><p class="text" data-v-9b2ca4cb>运行时配置</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9b2ca4cb data-v-9b2ca4cb><div class="item" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><a class="VPLink link link" href="/fes.js/guide/env.html" data-v-9b2ca4cb data-v-83901ecb><!--[--><p class="text" data-v-9b2ca4cb>环境变量</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9b2ca4cb data-v-9b2ca4cb><div class="item" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><a class="VPLink link link" href="/fes.js/guide/route.html" data-v-9b2ca4cb data-v-83901ecb><!--[--><p class="text" data-v-9b2ca4cb>路由</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9b2ca4cb data-v-9b2ca4cb><div class="item" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><a class="VPLink link link" href="/fes.js/guide/plugin.html" data-v-9b2ca4cb data-v-83901ecb><!--[--><p class="text" data-v-9b2ca4cb>插件</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9b2ca4cb data-v-9b2ca4cb><div class="item" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><a class="VPLink link link" href="/fes.js/guide/template.html" data-v-9b2ca4cb data-v-83901ecb><!--[--><p class="text" data-v-9b2ca4cb>HTML 模板</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9b2ca4cb data-v-9b2ca4cb><div class="item" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><a class="VPLink link link" href="/fes.js/guide/mock.html" data-v-9b2ca4cb data-v-83901ecb><!--[--><p class="text" data-v-9b2ca4cb>Mock 数据</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link is-active has-active" data-v-9b2ca4cb data-v-9b2ca4cb><div class="item" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><a class="VPLink link link" href="/fes.js/guide/upgrade3.html" data-v-9b2ca4cb data-v-83901ecb><!--[--><p class="text" data-v-9b2ca4cb>从 2.0.x 迁移到 3.0.x</p><!--]--><!----></a><!----></div><!----></div><!--]--></div></section></div><div class="group" data-v-084bed16><section class="VPSidebarItem level-0" data-v-084bed16 data-v-9b2ca4cb><div class="item" role="button" tabindex="0" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><h2 class="text" data-v-9b2ca4cb>样式和资源文件</h2><!----></div><div class="items" data-v-9b2ca4cb><!--[--><div class="VPSidebarItem level-1 is-link" data-v-9b2ca4cb data-v-9b2ca4cb><div class="item" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><a class="VPLink link link" href="/fes.js/guide/image.html" data-v-9b2ca4cb data-v-83901ecb><!--[--><p class="text" data-v-9b2ca4cb>使用图片</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9b2ca4cb data-v-9b2ca4cb><div class="item" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><a class="VPLink link link" href="/fes.js/guide/css.html" data-v-9b2ca4cb data-v-83901ecb><!--[--><p class="text" data-v-9b2ca4cb>使用 css</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9b2ca4cb data-v-9b2ca4cb><div class="item" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><a class="VPLink link link" href="/fes.js/guide/public.html" data-v-9b2ca4cb data-v-83901ecb><!--[--><p class="text" data-v-9b2ca4cb>静态资源</p><!--]--><!----></a><!----></div><!----></div><!--]--></div></section></div><div class="group" data-v-084bed16><section class="VPSidebarItem level-0" data-v-084bed16 data-v-9b2ca4cb><!----><div class="items" data-v-9b2ca4cb><!--[--><div class="VPSidebarItem level-1 is-link" data-v-9b2ca4cb data-v-9b2ca4cb><div class="item" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><a class="VPLink link link" href="/fes.js/guide/contributing.html" data-v-9b2ca4cb data-v-83901ecb><!--[--><p class="text" data-v-9b2ca4cb>贡献指南</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9b2ca4cb data-v-9b2ca4cb><div class="item" data-v-9b2ca4cb><div class="indicator" data-v-9b2ca4cb></div><a class="VPLink link link" href="/fes.js/guide/faq.html" data-v-9b2ca4cb data-v-83901ecb><!--[--><p class="text" data-v-9b2ca4cb>常见问题</p><!--]--><!----></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-d3edc1d3 data-v-7706de2c><div class="VPDoc has-sidebar has-aside" data-v-7706de2c data-v-6dc480e6><!--[--><!--]--><div class="container" data-v-6dc480e6><div class="aside" data-v-6dc480e6><div class="aside-curtain" data-v-6dc480e6></div><div class="aside-container" data-v-6dc480e6><div class="aside-content" data-v-6dc480e6><div class="VPDocAside" data-v-6dc480e6 data-v-0bcb2506><!--[--><!--]--><!--[--><!--]--><div class="VPDocAsideOutline" data-v-0bcb2506 data-v-9849bdbb><div class="content" data-v-9849bdbb><div class="outline-marker" data-v-9849bdbb></div><div class="outline-title" data-v-9849bdbb>本页目录</div><nav aria-labelledby="doc-outline-aria-label" data-v-9849bdbb><span class="visually-hidden" id="doc-outline-aria-label" data-v-9849bdbb> Table of Contents for current page </span><ul class="root" data-v-9849bdbb data-v-9b110da6><!--[--><!--]--></ul></nav></div></div><!--[--><!--]--><div class="spacer" data-v-0bcb2506></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-6dc480e6><div class="content-container" data-v-6dc480e6><!--[--><!--]--><!----><main class="main" data-v-6dc480e6><div style="position:relative;" class="vp-doc _fes_js_guide_upgrade3" data-v-6dc480e6><div><h1 id="从-2-0-x-迁移到-3-0-x" tabindex="-1">从 2.0.x 迁移到 3.0.x <a class="header-anchor" href="#从-2-0-x-迁移到-3-0-x" aria-label="Permalink to &quot;从 2.0.x 迁移到 3.0.x&quot;"></a></h1><h2 id="版本-3-0-x-的-break" tabindex="-1">版本 3.0.x 的 break <a class="header-anchor" href="#版本-3-0-x-的-break" aria-label="Permalink to &quot;版本 3.0.x 的 break&quot;"></a></h2><ol><li>编译时的 <a href="./../reference/config//#base">base</a> 配置,移到了 <a href="./../reference/config//#router">router.base</a> 下。</li><li><a href="https://github.com/webpack/webpack-dev-server" target="_blank" rel="noreferrer">webpack-dev-server</a><code>v3.x</code> 升级到了 <code>v4.x</code>,如果遇到配置不兼容,可以查看<a href="https://github.com/webpack/webpack-dev-server/blob/master/migration-v4.md" target="_blank" rel="noreferrer">webpack-dev-server 3.x 升级 4.x</a></li><li><a href="./../reference/plugin/plugins/layout.html#_4-x-升级到-5-x">layout 插件</a> 有一些属性变更</li><li><a href="./../reference/plugin/plugins/request.html#_2-x-升级到-3-x">request 插件</a> 有一些参数变更</li></ol><h2 id="继续使用-webpack" tabindex="-1">继续使用 Webpack <a class="header-anchor" href="#继续使用-webpack" aria-label="Permalink to &quot;继续使用 Webpack&quot;"></a></h2><ol><li>添加 Webpack 构建依赖包: <code>npm i @fesjs/builder-webpack -D</code></li><li>如果设置了 <code>publicPath: &#39;./&#39;</code>,请更改为 <code>publicPath: &#39;&#39;</code></li><li>如果有,将 <code>public/index.html</code> 文件挪到项目根目录,移除 <a href="https://github.com/jantimon/html-webpack-plugin" target="_blank" rel="noreferrer">html-webpack-plugin</a> 相关配置,具体模版变量使用请查看<a href="./../guide/template.html">HTML 模版</a></li></ol><h2 id="换成-vite" tabindex="-1">换成 Vite <a class="header-anchor" href="#换成-vite" aria-label="Permalink to &quot;换成 Vite&quot;"></a></h2><ol><li>安装依赖包 <code>npm i @fesjs/builder-vite</code></li><li>将 Webpack 相关的配置换成 Vite具体可查看<a href="./../reference/config/">配置</a></li><li>将 html 模版文件从 <code>public/index.html</code> 挪到项目根目录,如果有相应的 <a href="https://github.com/jantimon/html-webpack-plugin" target="_blank" rel="noreferrer">html-webpack-plugin</a> 配置,需要改成 <a href="https://github.com/vbenjs/vite-plugin-html" target="_blank" rel="noreferrer">vite-plugin-html</a> 的写法。</li><li><code>require</code> 等 Vite 不支持的代码,改写成 Vite 支持的方式。</li></ol><h2 id="插件" tabindex="-1">插件 <a class="header-anchor" href="#插件" aria-label="Permalink to &quot;插件&quot;"></a></h2><p>插件都需要升级到 <code>3.0.x</code> 版本,新版添加了兼容<code>builder</code>的逻辑,但是提供的接口和配置没有变化,只需要升级版本即可使用。</p><ul><li><a href="./../reference/plugin/plugins/layout.html">@fesjs/plugin-layout</a> 需要升级到<code>5.0.x</code>版本。</li><li><a href="./../reference/plugin/plugins/locale.html">@fesjs/plugin-locale</a> 需要升级到<code>4.0.x</code>版本。</li><li><a href="./../reference/plugin/plugins/qiankun.html">@fesjs/plugin-qiankun</a> 由于<code>qiankun</code>技术限制,子应用目前还只能使用 Webpack 构建。</li></ul></div></div></main><footer class="VPDocFooter" data-v-6dc480e6 data-v-30350303><!--[--><!--]--><!----><div class="prev-next" data-v-30350303><div class="pager" data-v-30350303><a class="pager-link prev" href="/fes.js/guide/mock.html" data-v-30350303><span class="desc" data-v-30350303>Previous page</span><span class="title" data-v-30350303>Mock 数据</span></a></div><div class="has-prev pager" data-v-30350303><a class="pager-link next" href="/fes.js/guide/image.html" data-v-30350303><span class="desc" data-v-30350303>Next page</span><span class="title" data-v-30350303>使用图片</span></a></div></div></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-d3edc1d3 data-v-3bd6857d><div class="container" data-v-3bd6857d><p class="message" data-v-3bd6857d>Released under the MIT License.</p><p class="copyright" data-v-3bd6857d>Copyright © 2020-present Webank</p></div></footer><!--[--><!--]--></div></div>
<script>__VP_HASH_MAP__ = JSON.parse("{\"guide_builder.md\":\"da64d858\",\"guide_getting-started.md\":\"3848ee27\",\"guide_runtime-config.md\":\"99433914\",\"guide_directory-structure.md\":\"b9d44484\",\"guide_faq.md\":\"bcfd6a77\",\"guide_template.md\":\"d4004323\",\"guide_image.md\":\"68538628\",\"guide_index.md\":\"72257f62\",\"guide_public.md\":\"2615d6f5\",\"guide_config.md\":\"25bc06f2\",\"guide_plugin.md\":\"bcd330ad\",\"guide_contributing.md\":\"1734fd0c\",\"reference_cli_index.md\":\"520e9d42\",\"guide_css.md\":\"e9f5916f\",\"guide_env.md\":\"a2bbb9bb\",\"reference_plugin_dev_index.md\":\"eb394b31\",\"reference_plugin_index.md\":\"ff230c53\",\"reference_plugin_plugins_editor.md\":\"e47cffc2\",\"reference_plugin_plugins_access.md\":\"4e4ed6f5\",\"reference_plugin_plugins_icon.md\":\"8e1a0033\",\"guide_upgrade3.md\":\"aa1339b5\",\"reference_plugin_plugins_enums.md\":\"920bbaba\",\"index.md\":\"ddff4668\",\"guide_route.md\":\"bc8f1b03\",\"reference_api.md\":\"fb7e1612\",\"reference_config_index.md\":\"d3e13751\",\"reference_plugin_plugins_jest.md\":\"4b1c2ebf\",\"reference_plugin_dev_api.md\":\"b4efeb0f\",\"reference_api_index.md\":\"9ffa99a5\",\"guide_mock.md\":\"1451d115\",\"reference_plugin_plugins_model.md\":\"0ebb79f4\",\"reference_plugin_plugins_login.md\":\"50fc66a2\",\"reference_plugin_plugins_request-4.md\":\"ab5eb474\",\"reference_plugin_plugins_windicss.md\":\"76a2f583\",\"reference_plugin_plugins_locale.md\":\"f2ad7111\",\"reference_plugin_plugins_qiankun.md\":\"a2eacef5\",\"reference_plugin_plugins_pinia.md\":\"f23c8887\",\"reference_plugin_plugins_swc.md\":\"b42a6e35\",\"reference_plugin_plugins_sass.md\":\"ad29d499\",\"reference_plugin_plugins_watermark.md\":\"ff5893bf\",\"reference_plugin_plugins_layout.md\":\"2efc7a16\",\"reference_plugin_plugins_vuex.md\":\"0b177022\",\"reference_plugin_plugins_request.md\":\"c8be9716\"}")
__VP_SITE_DATA__ = JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Fes.js\",\"description\":\"一个好用的前端应用解决方案\",\"base\":\"/fes.js/\",\"head\":[],\"appearance\":true,\"themeConfig\":{\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/WeBankFinTech/fes.js\"}],\"logo\":\"/logo.png\",\"nav\":[{\"text\":\"指南\",\"link\":\"/guide/\",\"activeMatch\":\"/guide/\"},{\"text\":\"编译时配置\",\"link\":\"/reference/config/\"},{\"text\":\"API\",\"link\":\"/reference/api/\"},{\"text\":\"插件\",\"link\":\"/reference/plugin/\",\"activeMatch\":\"/plugin/\"},{\"text\":\"CLI\",\"link\":\"/reference/cli/index.md\"},{\"text\":\"v3.1.0\",\"items\":[{\"text\":\"v2.0\",\"link\":\"https://fesjs.mumblefe.cn/2.0/\"},{\"text\":\"v1.0\",\"link\":\"https://fesjs.mumblefe.cn/1.0/\"}]},{\"text\":\"了解更多\",\"items\":[{\"text\":\"更新日志\",\"link\":\"https://github.com/WeBankFinTech/fes.js/blob/master/CHANGELOG.md\"},{\"text\":\"fes-design\",\"link\":\"http://fes-design.mumblefe.cn/\"}]}],\"sidebar\":{\"/guide/\":[{\"text\":\"开始\",\"items\":[{\"text\":\"介绍\",\"link\":\"/guide/index.md\"},{\"text\":\"快速上手\",\"link\":\"/guide/getting-started.md\"}]},{\"text\":\"基础\",\"items\":[{\"text\":\"目录结构\",\"link\":\"/guide/directory-structure.md\"},{\"text\":\"Vite 和 Webpack 双构建\",\"link\":\"/guide/builder.md\"},{\"text\":\"编译时配置\",\"link\":\"/guide/config.md\"},{\"text\":\"运行时配置\",\"link\":\"/guide/runtime-config.md\"},{\"text\":\"环境变量\",\"link\":\"/guide/env.md\"},{\"text\":\"路由\",\"link\":\"/guide/route.md\"},{\"text\":\"插件\",\"link\":\"/guide/plugin.md\"},{\"text\":\"HTML 模板\",\"link\":\"/guide/template.md\"},{\"text\":\"Mock 数据\",\"link\":\"/guide/mock.md\"},{\"text\":\"从 2.0.x 迁移到 3.0.x\",\"link\":\"/guide/upgrade3.md\"}]},{\"text\":\"样式和资源文件\",\"items\":[{\"text\":\"使用图片\",\"link\":\"/guide/image.md\"},{\"text\":\"使用 css\",\"link\":\"/guide/css.md\"},{\"text\":\"静态资源\",\"link\":\"/guide/public.md\"}]},{\"text\":\"贡献指南\",\"link\":\"/guide/contributing.md\"},{\"text\":\"常见问题\",\"link\":\"/guide/faq.md\"}],\"/reference/plugin/\":[{\"text\":\"介绍\",\"link\":\"/reference/plugin/index.md\"},{\"text\":\"Plugins\",\"items\":[{\"text\":\"@fesjs/plugin-access\",\"link\":\"/reference/plugin/plugins/access.md\"},{\"text\":\"@fesjs/plugin-enums\",\"link\":\"/reference/plugin/plugins/enums.md\"},{\"text\":\"@fesjs/plugin-icon\",\"link\":\"/reference/plugin/plugins/icon.md\"},{\"text\":\"@fesjs/plugin-jest\",\"link\":\"/reference/plugin/plugins/jest.md\"},{\"text\":\"@fesjs/plugin-layout\",\"link\":\"/reference/plugin/plugins/layout.md\"},{\"text\":\"@fesjs/plugin-locale\",\"link\":\"/reference/plugin/plugins/locale.md\"},{\"text\":\"@fesjs/plugin-model\",\"link\":\"/reference/plugin/plugins/model.md\"},{\"text\":\"@fesjs/plugin-request\",\"link\":\"/reference/plugin/plugins/request.md\"},{\"text\":\"@fesjs/plugin-vuex\",\"link\":\"/reference/plugin/plugins/vuex.md\"},{\"text\":\"@fesjs/plugin-qiankun\",\"link\":\"/reference/plugin/plugins/qiankun.md\"},{\"text\":\"@fesjs/plugin-windicss\",\"link\":\"/reference/plugin/plugins/windicss.md\"},{\"text\":\"@fesjs/plugin-sass\",\"link\":\"/reference/plugin/plugins/sass.md\"},{\"text\":\"@fesjs/plugin-editor\",\"link\":\"/reference/plugin/plugins/editor.md\"},{\"text\":\"@fesjs/plugin-pinia\",\"link\":\"/reference/plugin/plugins/pinia.md\"},{\"text\":\"@fesjs/plugin-watermark\",\"link\":\"/reference/plugin/plugins/watermark.md\"},{\"text\":\"@fesjs/plugin-login\",\"link\":\"/reference/plugin/plugins/login.md\"},{\"text\":\"@fesjs/plugin-swc\",\"link\":\"/reference/plugin/plugins/swc.md\"}]},{\"text\":\"插件开发\",\"items\":[{\"text\":\"插件介绍\",\"link\":\"/reference/plugin/dev/index.md\"},{\"text\":\"插件API\",\"link\":\"/reference/plugin/dev/api.md\"}]}]},\"outline\":{\"label\":\"本页目录\"},\"search\":{\"provider\":\"local\"},\"footer\":{\"message\":\"Released under the MIT License.\",\"copyright\":\"Copyright © 2020-present Webank\"}},\"locales\":{},\"scrollOffset\":90,\"cleanUrls\":false}")</script>
</body>
</html>