ant design pro (八)構建和發布


一、概述

原文地址:https://pro.ant.design/docs/deploy-cn

二、詳細

2.1、構建

當項目開發完畢,只需要運行一行命令就可以打包你的應用:

npm run build

由於 Ant Design Pro 底層使用的 roadhog 工具,已經將復雜的流程封裝完畢,對於大部分場景,構建打包文件只需要一個命令 roadhog build,構建打包成功之后,會在根目錄生成 dist 文件夾,里面就是構建打包好的文件,通常是 ***.js***.cssindex.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 。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM