react 應(yīng)用多入口配置及實(shí)踐總結(jié)
背景
還是之前的那個(gè)項(xiàng)目,做完國際化沒多久,還沒來得及劃水, 又有新的活了 -- 移動(dòng)端的兼容。 考慮到后期的復(fù)雜度, 需要做兩套資源。 具體的目標(biāo)是:同一個(gè)URL,PC打開就顯示PC的那一套, M端打開就顯示Mobile的頁面
。 create-react-app 腳手架本身不支持多入口, 需要改造,今天下午研究了一下,改造了一波, 基本達(dá)到了預(yù)期, 在這里簡(jiǎn)單把經(jīng)驗(yàn)總結(jié)分享下。
先睹為快
Mobile:
PC:
輸出之后的文件, 相比之前的index.html, 多了一個(gè)額外的mobile.html.
最終的源代碼目錄:
具體的改造步驟如下:
Steps
step1: Eject
在下之前圖方便, 直接用了create-react-app
, 現(xiàn)在需要更改配置, 需要彈出默認(rèn)配置:
在終端執(zhí)行:yarn eject
.
step2: 修改webpack config
原本的 webpack.config.dev.js:
entry: [ require.resolve('react-dev-utils/webpackHotDevClient'), require.resolve('./polyfills'), require.resolve('react-error-overlay'), paths.appIndexJs, ], output: { path: paths.appBuild, pathinfo: true, filename: 'static/js/bundle.js', chunkFilename: 'static/js/[name].chunk.js', publicPath: publicPath, devtoolModuleFilenameTemplate: info => path.resolve(info.absoluteResourcePath), },
需要修改為:
entry: { index: [ require.resolve('./polyfills'), require.resolve('react-dev-utils/webpackHotDevClient'), paths.appIndexJs, ], mobile: [ require.resolve('./polyfills'), require.resolve('react-dev-utils/webpackHotDevClient'), paths.appSrc + "/mobile/index.js", ] }, output: { pathinfo: true, filename: 'static/js/[name].bundle.js', chunkFilename: 'static/js/[name].chunk.js', publicPath: publicPath, devtoolModuleFilenameTemplate: info => path.resolve(info.absoluteResourcePath).replace(/\\/g, '/'), },
可能需要注意的幾點(diǎn):
- entry從原來的數(shù)組擴(kuò)展為對(duì)象,每個(gè)key代表一個(gè)入口。
- output中的filename要區(qū)分輸出名,可增加[name]變量,這樣會(huì)根據(jù)entry分別編譯出每個(gè)entry的js文件。
這樣你就可以在src
目錄下新起一個(gè)民目錄開發(fā)新的SPA:
step3: 生成多個(gè)html入口文件
Webpack配置多入口后,只是編譯出多個(gè)入口的Js,入口的HTML文件也需要配置, 可以用HtmlWebpackPlugin來生成。
webpack.config.dev.js
原配置:
// Generates an `index.html` file with the <script> injected. new HtmlWebpackPlugin({ inject: true, chunks: ["index"], template: paths.appHtml, }),
需要加多一個(gè)配置, 改成:
// Generates an `index.html` file with the <script> injected. new HtmlWebpackPlugin({ inject: true, chunks: ["index"], template: paths.appHtml, }), new HtmlWebpackPlugin({ inject: true, chunks: ["mobile"], template: paths.appHtml, filename: 'mobile.html', }),
- 每調(diào)一次HtmlWebpackPlugin生成一次HTML頁面,這里有兩個(gè),所以就會(huì)多增加一個(gè)mobile.html節(jié)點(diǎn)。
- chunks: 指明哪些webpack入口的js會(huì)被注入到這個(gè)HTML頁面。如果不配置,則將所有entry的JS文件都注入HTML。
- filename: 指明生成的HTML路徑,如果不配置就是dist/index.html。mobile配置了新的filename,避免與第一個(gè)入口相互覆蓋。
- template: 指定模版, 我這里因?yàn)橛玫倪@兩個(gè)模版都一樣, 所以就指定的同一個(gè)appHtml, 如有特殊需求, 就新建一個(gè)html 文件, 在template字段里引用即可。
Step4: 配置webpack Dev Server
上述配置做完后,理論就可以打包出多入口的版本;但使用npm start啟動(dòng)后,發(fā)現(xiàn)無論輸入/index.html還是/mobile.html,好像都是和原來/index.html顯示一樣的內(nèi)容。
甚至輸入顯然不存在的/xxxx.html,也顯示為/index.html的內(nèi)容。
這種現(xiàn)象,初步判斷是HTTP服務(wù)器把所有請(qǐng)求重定向到了/index.html。
對(duì)于單頁應(yīng)用,這種做法是沒有問題的(本來就一個(gè)頁面), 但我們新增的/mobile.html就可以訪問到了。
參考官方文檔 The historyApiFallback option,發(fā)現(xiàn)是webpack dev server的問題,還要額外做一些配置,需修改webpackDevServer.config.js:
原配置:
historyApiFallback: { // Paths with dots should still use the history fallback. // See https://github.com/facebookincubator/create-react-app/issues/387. disableDotRule: true, },
修改為:
historyApiFallback: { // Paths with dots should still use the history fallback. // See https://github.com/facebookincubator/create-react-app/issues/387. disableDotRule: true, // 指明哪些路徑映射到哪個(gè)html rewrites: [ { from: /^\/mobile.html/, to: '/dist/mobile.html' }, ] },
增加的rewrites節(jié)點(diǎn),特別對(duì)/admin.html這個(gè)URL重定向?yàn)?dist/mobile.html頁面(也就是HtmlWebpackPlugin輸出的HTML文件路徑),這樣/mobile.html就可以正常訪問了。
至此,dev環(huán)境的多入口問題就解決了。
step5: Prod 環(huán)境配置
prod環(huán)境,比dev環(huán)境更簡(jiǎn)單。由于不存在webpack Dev Server,直接在config/webpack.config.prod.js同理做2和3步驟即可。
這時(shí)候你就可以通過手動(dòng)修改URl 來訪問了:
路由相關(guān)
到這, 已經(jīng)可以手動(dòng)修改URL 來訪問pc 和 mobile的頁面了。 還有一個(gè)問題沒有解決:
URL最后肯定是不能給你手動(dòng)改來改去的, 需要根據(jù)設(shè)備的情況自己判斷, 這里有兩個(gè)思路:
1: 配置 Nginx 的路徑的時(shí)候, 加多一個(gè)alias 的映射。
2: 前端根據(jù)UA自行配置。
為了快速出效果, 簡(jiǎn)單搞了一下, 具體代碼如下:
這樣, 不用手動(dòng)修改URL 也能根據(jù)UA自動(dòng)顯示不同的頁面了, 具體的效果圖在文章開頭的先睹為快
中。
其他
上面的路由就為了簡(jiǎn)單的出個(gè)效果, 比較粗暴, 僅供參考。
結(jié)語
以上就是全部的細(xì)節(jié)了, 達(dá)到了預(yù)期的效果, 但是也有很大優(yōu)化空間。 等后面一波需求做完了, 再來做補(bǔ)充吧。希望對(duì)大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
React-router 4 按需加載的實(shí)現(xiàn)方式及原理詳解
本篇文章主要介紹了React-router 4 按需加載的實(shí)現(xiàn)方式及原理詳解,非常具有實(shí)用價(jià)值,需要的朋友可以參考下2017-05-05解決React報(bào)錯(cuò)The?tag?is?unrecognized?in?this?browser
這篇文章主要為大家介紹了解決React報(bào)錯(cuò)The?tag?is?unrecognized?in?this?browser示例詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-12-12使用react+redux實(shí)現(xiàn)計(jì)數(shù)器功能及遇到問題
使用redux管理數(shù)據(jù),由于Store獨(dú)立于組件,使得數(shù)據(jù)管理獨(dú)立于組件,解決了組件之間傳遞數(shù)據(jù)困難的問題,非常好用,今天重點(diǎn)給大家介紹使用react+redux實(shí)現(xiàn)計(jì)數(shù)器功能及遇到問題,感興趣的朋友參考下吧2021-06-06npx create-react-app xxx創(chuàng)建項(xiàng)目報(bào)錯(cuò)的解決辦法
這篇文章主要介紹了npx create-react-app xxx創(chuàng)建項(xiàng)目報(bào)錯(cuò)的解決辦法,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2020-02-02React項(xiàng)目動(dòng)態(tài)設(shè)置title標(biāo)題的方法示例
這篇文章主要介紹了React項(xiàng)目動(dòng)態(tài)設(shè)置title標(biāo)題的方法示例,小編覺得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過來看看吧2018-09-09教你react中如何理解usestate、useEffect副作用、useRef標(biāo)識(shí)和useContext
這篇文章主要介紹了react中如何理解usestate、useEffect副作用、useRef標(biāo)識(shí)和useContext,其實(shí)與vue中的ref和reactive一樣,通過useState獲取到的數(shù)據(jù)可以實(shí)現(xiàn)組件視圖實(shí)時(shí)交互,而普通定義的數(shù)據(jù)僅僅在業(yè)務(wù)中使用,需要的朋友可以參考下2022-11-11