一、概述
原文地址:https://pro.ant.design/docs/deploy-cn
二、詳細
2.1、構建
當項目開發完畢,只需要運行一行命令就可以打包你的應用:
npm run build
由於 Ant Design Pro 底層使用的 roadhog 工具,已經將復雜的流程封裝完畢,對於大部分場景,構建打包文件只需要一個命令 roadhog build
,構建打包成功之后,會在根目錄生成 dist
文件夾,里面就是構建打包好的文件,通常是 ***.js
、***.css
、index.html
等靜態文件。
不過你如果需要自定義構建,比如指定 dist
目錄等,則需要通過 .webpackrc
進行配置,詳情參看:roadhog 配置。
2.1.1、環境變量
當你需要區別開發和部署以及測試環境的時候,可以通過在 .webpackrc
中設置 env 環境變量來實現。
"env": { // 開發環境 "development": { "extraBabelPlugins": [ "dva-hmr", ] }, // build 時的生產環境 "production": { "extraBabelPlugins": [ "transform-runtime", "transform-decorators-legacy", ["import", { "libraryName": "antd", "style": true }] ] } },
2.1.2、分析構建文件體積
如果你的構建文件很大,你可以通過 analyze
命令構建並分析依賴模塊的體積分布,從而優化你的代碼。
npm run analyze
然后打開 dist/stats.html
查看體積分布數據。
2.2、發布
對於發布來講,只需要將最終生成的靜態文件,也就是通常情況下 dist
文件夾的靜態文件發布到你的 cdn 或者靜態服務器即可,需要注意的是其中的 index.html
通常會是你后台服務的入口頁面,在確定了 js 和 css 的靜態之后可能需要改變頁面的引入路徑。
2.2.1、代碼分割和動態加載
0.3.0 版本之后,我們支持了代碼分割和動態加載,只有進入對應路由后才會加載相應的代碼,避免首屏加載過多不必要的 JS 文件,提高大規模前端應用研發的擴展性。
├── 0.async.js ├── 1.async.js ├── 10.async.js ├── 11.async.js ├── 12.async.js ├── 13.async.js ├── 14.async.js ...
注意:如果開啟了 hash
,會變成 0.2df975b2.async.js
的形式,修改代碼后 hash 會變化,可以避免前端緩存問題。
這種方式對於部署有一定的要求,你可以將 dist 整體部署到你的后端應用的靜態資源目錄下(通常為 static 或者 public),這樣默認的靜態資源引用路徑直接指向應用的根目錄 //your.application.domain/***.js
和 //your.application.domain/***.css
。
如果你的靜態資源域名和應用域名不同(例如獨立的 cdn 地址),你需要在 .webpackrc
文件里用 publicPath 對生產環境的靜態路徑進行配置。可以參考 create-react-app 的部署文檔
{ "publicPath": "https://cdn.com/your_app" }
Ant Design Pro 1.0 版本后我們 .webpackrc
里使用了 "disableDynamicImport": true
默認關掉了動態加載(roadhog@2.x 支持),回退為單文件 index.js 和 index.css 的構建方式。如果需要動態加載刪掉這個配置即可。
2.2.2、前端路由與服務端的結合
Ant Design Pro 中,前端路由使用的是 React Router,所以你可以選擇兩種路由方式:browserHistory
和 hashHistory
。
hashHistory
使用如 https://cdn.com/#/users/123
這樣的 URL,取井號后面的字符作為路徑。browserHistory
則直接使用 https://cdn.com/users/123
這樣的 URL。使用 hashHistory
時瀏覽器訪問到的始終都是根目錄下 index.html
。使用 browserHistory
則需要服務器做好處理 URL 的准備,處理應用啟動最初的 /
這樣的請求應該沒問題,但當用戶來回跳轉並在 /users/123
刷新時,服務器就會收到來自 /users/123
的請求,這時你需要配置服務器能處理這個 URL 返回正確的 index.html
。如果你能控制服務端,我們推薦使用 browserHistory
。
express 的例子
app.use(express.static(path.join(__dirname, 'build'))); app.get('/*', function (req, res) { res.sendFile(path.join(__dirname, 'build', 'index.html')); });
egg 的例子
// controller exports.index = function* () { yield this.render('App.jsx', { context: { user: this.session.user, }, }); }; // router app.get('home', '/*', 'home.index');
2.2.3、在 Ant Design Pro 中使用前端路由
路由包含的信息在 router.js
中,不過關於 history
的配置是在 index.js
入口文件中,傳入配置信息給 dva 構造器即可。
由於使用了 react-router@4
,所以引入 browserHistory
與原本 dva
的方式相比有所改變。
import dva from 'dva'; // 引入 browserHistory import browserHistory from 'history/createBrowserHistory' import models from './models'; import './index.less'; // use browserHistory const app = dva({ history: browserHistory(), }); // default hashHistroy const app = dva();
關於路由更多可以參看 React Router 。 關於 react-router@4
更多可以參看 All About React Router 4 。