使用React、Electron、Dva、Webpack、Node.js、Websocket快速構建跨平臺應用

時間 2019-11-21

標籤使用 react electron dva webpack node.js node websocket 快速構建跨平臺應用欄目 React 简体版

原文原文鏈接

目前`Electron`在`github`上面的`star`量已經快要跟`React-native`同樣多了

這裏吐槽下，webpack感受每週都在偷偷更新，很糟心啊，還有Angular更新到了8,Vue立刻又要出正式新版本了，5G今年就要商用，華爲的系統也要出來了，RN尚未更新到正式的1版本，還有號稱讓前端開發者失業的技術flutter也在瘋狂更新,前端真的是學不完的css

回到正題，不可否認，如今的大前端，真的太牛了，PC端能夠跨三種平臺開發，移動端能夠一次編寫，生成各類小程序以及React-native應用，而後跑在ios和安卓以及網頁中 , 這裏不得不說-------京東的Taro框架這些人已經把Node.js和webpack用上了天html

對webpack不熟悉的，看我以前的文章，今天不把重點放在webpack前端

歡迎關注個人專欄《前端進階》都是百星高贊文章vue

先說說`Electron`官網介紹:

使用 `JavaScript, HTML 和 CSS`構建跨平臺的桌面應用 ,若是你能夠建一個網站，你就能夠建一個桌面應用程序。 `Electron` 是一個使用`JavaScript, HTML 和 CSS 等 Web` 技術建立原生程序的框架，它負責比較難搞的部分，你只需把精力放在你的應用的核心上便可。

什麼意思呢？
Electron = Node.js + 谷歌瀏覽器 + 日常的JS代碼生成的應用，最終打包成安裝包，就是一個完整的應用
Electron分兩個進程，主進程負責比較難搞的那部分，渲染進程（日常的JS代碼）部分，負責UI界面展現
兩個進程之間能夠經過remote模塊，以及IPCRender和IPCMain之間通訊，前者相似於掛載在全局的屬性上進行通訊（很像最先的命名空間模塊化方案），後者是基於發佈訂閱機制，自定義事件的監聽和觸發實現兩個進程的通訊。
Electron至關於給React生成的單頁面應用套了一層殼，若是涉及到文件操做這類的複雜功能，那麼就要依靠Electron的主進程，由於主進程能夠直接調用Node.js的API,還可使用C++插件，這裏Node.js的牛逼程度就凸顯出來了，既能夠寫後臺的CRUD,又能夠作中間件，如今又能夠寫前端。

談談技術選型

使用React去作底層的UI繪製，大項目首選React+TS
狀態管理的最佳實踐確定不是Redux，目前首選dva，或者redux-saga。
構建工具選擇webpack，若是不會webpack真的很吃虧，會嚴重限制你的前端發展，因此建議好好學習Node.js和webpack
選擇了普通的Restful架構，而不是GraphQL，可能我對GraphQL理解不深，沒有領悟到精髓
在通訊協議這塊，選擇了websoket和普通的http通訊方式
由於是demo，不少地方並無細化，後期會針對electron出一個網易雲音樂的開源項目，這是必定要作到的

先開始正式的環境搭建

config文件放置webpack配置文件
server文件夾放置Node.js的後端服務器代碼
src下放置源碼
main.js是Electron的入口文件
json文件是腳本入口文件，也是包管理的文件~

開發模式項目啓動思路：

先啓動webpack將代碼打包到內存中，實現熱更新
再啓動Electron讀取對應的url地址的文件內容，也實現熱更新

設置`webpack`入口

app: ['babel-polyfill', './src/index.js', './index.html'],
        vendor: ['react']
        }
    
複製代碼

忽略`Electron`中的代碼，不用`webpack`打包(由於`Electron`中有後臺模塊代碼，打包就會報錯)

externals: [
        (function () {
            var IGNORES = [
                'electron'
            ];
            return function (context, request, callback) {
                if (IGNORES.indexOf(request) >= 0) {
                    return callback(null, "require('" + request + "')");
                }
                return callback();
            };
        })()
    ]
    
    ```
    
    
#### 加入代碼分割
複製代碼

optimization: { runtimeChunk: true, splitChunks: { chunks: 'all' } }, ```node

設置熱更新等

plugins: [
        new HtmlWebpackPlugin({
            template: './index.html'
        }),
        new webpack.HotModuleReplacementPlugin(),
        new webpack.NamedModulesPlugin(),
    ],
    mode: 'development',
    devServer: {
        contentBase: '../build',
        open: true,
        port: 5000,
        hot: true
    },
    ```
    
    
 #### 加入`babel`


複製代碼

{ loader: 'babel-loader', options: { //jsx語法 presets: ["@babel/preset-react", //tree shaking 按需加載babel-polifill presets從後到前執行 ["@babel/preset-env", { "modules": false, "useBuiltIns": "false", "corejs": 2, }], ],react

plugins: [
    //支持import 懶加載    plugin從前到後
    "@babel/plugin-syntax-dynamic-import",
    //andt-mobile按需加載  true是less，若是不用less style的值能夠寫'css' 
    ["import", { libraryName: "antd-mobile", style: true }],
    //識別class組件
    ["@babel/plugin-proposal-class-properties", { "loose": true }],
    //
],
cacheDirectory: true
複製代碼

}, } ```webpack

今天只講開發模式下的配置，由於實在太多，得分兩篇文章寫了~ 剩下的配置去`git`倉庫看

看看主進程的配置文件`main.js`

// Modules to control application life and create native browser window
const { app, BrowserWindow, ipcMain, Tray, Menu } = require('electron')
const path = require('path')
// Keep a global reference of the window object, if you don't, the window will // be closed automatically when the JavaScript object is garbage collected. let mainWindow app.disableHardwareAcceleration() // ipcMain.on('sync-message', (event, arg) => { // console.log("sync - message") // // event.returnValue('message', 'tanjinjie hello') // }) function createWindow() { // Create the browser window. tray = new Tray(path.join(__dirname, './src/assets/bg.jpg')); tray.setToolTip('wechart'); tray.on('click', () => { mainWindow.isVisible() ? mainWindow.hide() : mainWindow.show() }); const contextMenu = Menu.buildFromTemplate([ { label: '退出', click: () => mainWindow.quit() }, ]); tray.setContextMenu(contextMenu); mainWindow = new BrowserWindow({ width: 805, height: 500, webPreferences: { nodeIntegration: true }, // titleBarStyle: 'hidden' frame: false }) //自定義放大縮小托盤功能 ipcMain.on('changeWindow', (event, arg) => { if (arg === 'min') { console.log('min') mainWindow.minimize() } else if (arg === 'max') { console.log('max') if (mainWindow.isMaximized()) { mainWindow.unmaximize() } else { mainWindow.maximize() } } else if (arg === "hide") { console.log('hide') mainWindow.hide() } }) // and load the index.html of the app. // mainWindow.loadFile('index.html') mainWindow.loadURL('http://localhost:5000'); BrowserWindow.addDevToolsExtension( path.join(__dirname, './src/extensions/react-dev-tool'), ); // Open the DevTools. // mainWindow.webContents.openDevTools() // Emitted when the window is closed. mainWindow.on('closed', function () { // Dereference the window object, usually you would store windows // in an array if your app supports multi windows, this is the time // when you should delete the corresponding element. mainWindow = null BrowserWindow.removeDevToolsExtension( path.join(__dirname, './src/extensions/react-dev-tool'), ); }) } // This method will be called when Electron has finished // initialization and is ready to create browser windows. // Some APIs can only be used after this event occurs. app.on('ready', createWindow) // Quit when all windows are closed. app.on('window-all-closed', function () { // On macOS it is common for applications and their menu bar // to stay active until the user quits explicitly with Cmd + Q if (process.platform !== 'darwin') app.quit() }) app.on('activate', function () { // On macOS it's common to re-create a window in the app when the
  // dock icon is clicked and there are no other windows open.
  if (mainWindow === null) createWindow()
})


// In this file you can include the rest of your app's specific main process // code. You can also put them in separate files and require them here. 複製代碼

在開發模式下啓動項目：

使用"dev": "webpack-dev-server --config ./config/webpack.dev.js", 將代碼打包到內存中
使用 "start": "electron ." 開啓electron，讀取對應的內存地址中的資源，實現熱更新

項目起來後，在入口處`index.js`文件中，注入`dva`

import React from 'react'
import App from './App'
import dva from 'dva'
import Homes from './model/Homes'
import main from './model/main'
const app = dva()
app.router(({ history, app: store }) => (
  <App
    history={history}
    getState={store._store.getState}
    dispatch={store._store.dispatch}
  />
));
app.model(Homes)
app.model(main)
app.start('#root')

複製代碼

這裏不得不說`redux,redux-sage,dva`的區別直接看圖

首先是`Redux`

React 只負責頁面渲染, 而不負責頁面邏輯, 頁面邏輯能夠從中單獨抽取出來, 變成store,狀態及頁面邏輯從 <App/>裏面抽取出來, 成爲獨立的 store,
頁面邏輯就是 reducer，<TodoList/> 及<AddTodoBtn/>都是 Pure Component, 經過 connect 方法能夠很方便地給它倆加一層 wrapper 從而創建起與 store 的聯繫: 能夠經過 dispatch 向 store注入 action, 促使 store 的狀態進行變化, 同時又訂閱了store的狀態變化, 一旦狀態有變, 被 connect的組件也隨之刷新,使用 dispatch 往 store 發送 action 的這個過程是能夠被攔截的, 天然而然地就能夠在這裏增長各類 Middleware, 實現各類自定義功能, eg: logging這樣一來, 各個部分各司其職, 耦合度更低, 複用度更高, 擴展性更好

而後是注入`Redux-sage`

上面說了, 可使用 Middleware 攔截 action, 這樣一來異步的網絡操做也就很方便了, 作成一個 Middleware 就好了, 這裏使用 redux-saga 這個類庫, 舉個栗子:ios
點擊建立 Todo 的按鈕, 發起一個 type == addTodo 的 actiongit
saga 攔截這個 action, 發起 http 請求, 若是請求成功, 則繼續向reducer發一個 type == addTodoSucc 的action, 提示建立成功, 反之則發送type == addTodoFail 的 action 便可github

最後是: Dva

有了前面的三步鋪墊,Dva 的出現也就水到渠成了, 正如Dva官網所言,Dva是基於React + Redux + Saga的最佳實踐沉澱, 作了 3 件很重要的事情, 大大提高了編碼體驗:
把 store 及saga 統一爲一個model 的概念, 寫在一個 js 文件裏面
增長了一個 Subscriptions, 用於收集其餘來源的 action, eg: 鍵盤操做
model 寫法很簡約, 相似於DSL 或者RoR, coding 快得飛起✈️
約定優於配置, 老是好的😆

在入口`APP`組件中，注入`props`，實現狀態樹的管理

import React from 'react'
import { HashRouter, Route, Redirect, Switch } from 'dva/router';
import Home from './pages/home'
const Router = (props) => {
    return (
        <HashRouter>
            <Switch>
                <Route path="/home" component={Home}></Route>
                <Redirect to="/home"></Redirect>
            </Switch>
        </HashRouter>
    )
}
export default Router
複製代碼

在組件中`connect`鏈接狀態樹便可

import React from 'react'
import { ipcRenderer } from 'electron'
import { NavLink, Switch, Route, Redirect } from 'dva/router'
import Title from '../../components/title'
import Main from '../main'
import Friend from '../firend'
import More from '../more'
import { connect } from 'dva'
import './index.less'
class App extends React.Component {
    componentDidMount() {
        ipcRenderer.send('message', 'hello electron')
        ipcRenderer.on('message', (event, arg) => {
            console.log(arg, new Date(Date.now()))
        })
        const ws = new WebSocket('ws://localhost:8080');
        ws.onopen = function () {
            ws.send('123')
            console.log('open')
        }
        ws.onmessage = function () {
            console.log('onmessage')
        }
        ws.onerror = function () {
            console.log('onerror')
        }
        ws.onclose = function () {
            console.log('onclose')
        }
    }
    componentWillUnmount() {
        ipcRenderer.removeAllListeners()
    }
    render() {
        console.log(this.props)
        return (
            <div className="wrap">
                <div className="nav">
                    <NavLink to="/home/main">Home</NavLink>
                    <NavLink to="/home/firend">Friend</NavLink>
                    <NavLink to="/home/more">More</NavLink>
                </div>
                <div className="content">
                    <Title></Title>
                    <Switch>
                        <Route path="/home/main" component={Main}></Route>
                        <Route path="/home/firend" component={Friend}></Route>
                        <Route path="/home/more" component={More}></Route>
                        <Redirect to="/home/main"></Redirect>
                    </Switch>
                </div>
            </div>
        )
    }
}
export default connect(
    ({ main }) => ({
        test: main.main
    })
)(App)
// ipcRenderer.sendSync('sync-message','sync-message')
複製代碼

捋一捋上面的組件作了什麼

上來在組件掛載的生命週期函數中,啓動了websocket鏈接，而且掛載了響應的事件監聽，對主線程發送了消息，而且觸發了主線程的message事件。
在組件即將卸載的時候，移除了全部的跨進程通訊的事件監聽
使用了dva進行路由跳轉
鏈接了狀態樹，讀取了狀態樹main模塊的main狀態數據

進入上一個組件的子組件

import React from 'react'
import { connect } from 'dva'
class App extends React.Component {
    handleAdd = () => {
        this.props.dispatch({
            type: 'home/add',
            val: 5,
            res: 1
        })
    }
    handleDel = () => {
    }
    render() {
        const { homes } = this.props
        console.log(this.props)
        return (
            <div>
                <button onClick={this.handleAdd}>add</button>
                <button onClick={this.handleDel}>{homes}</button>
            </div>
        )
    }
}
export default connect(
    ({ home, main }) => ({
        homes: home.num,
        mains: main.main
    })
)(App)
複製代碼

一樣看看，這個組件作了什麼

鏈接狀態樹，讀取了 home,main模塊的狀態數據，而且轉換成了props
綁定了事件，若是點擊按鈕，dispatch給對應的effects，更新狀態樹的數據，進而更新頁面

最後咱們看下如何經過渲染進程控制主進程的窗口顯示

import React from 'react'
import { ipcRenderer } from 'electron'
import './index.less'
export default class App extends React.Component {
    handle = (type) => {
        return () => {
            if (type === 'min') {
                console.log('min')
                ipcRenderer.send('changeWindow', 'min')
            } else if (type === 'max') {
                console.log('max')
                ipcRenderer.send('changeWindow', 'max')
            } else {
                console.log('hide')
                ipcRenderer.send('changeWindow', 'hide')
            }
        }
    }
    render() {
        return (
            <div className="title-container">
                <div className="title" style={{ "WebkitAppRegion": "drag" }}>能夠拖拽的區域</div>
                <button onClick={this.handle('min')}>最小化</button>
                <button onClick={this.handle('max')}>最大化</button>
                <button onClick={this.handle('hide')}>托盤</button>
            </div>
        )
    }
}


複製代碼

經過IPCRender與主進程通訊，控制窗口的顯示和隱藏

咱們一塊兒去`dva`中管理的`model`看看

home模塊

export default {
    namespace: 'home',
    state: {
        homes: [1, 2, 3],
        num: 0
    },
    reducers: {
        adds(state, { newNum }) {
            return {
                ...state,
                num: newNum
            }
        }
    },
    effects: {
        * add({ res, val }, { put, select, call }) {
            const { home } = yield select()
            console.log(home.num)
            yield console.log(res, val)
            const newNum = home.num + 1
            yield put({ type: 'adds', newNum })
        }
    },
}
複製代碼

`dva`真的能夠給咱們省掉不少不少代碼，並且更好維護，也更容易閱讀

它的大概流程

若是不會的話建議去官網看例子，通常來講不會像RXJS學習路線那麼陡峭

`Node.js`中代碼

const express = require('express')
const { Server } = require("ws");
const app = express()
const wsServer = new Server({ port: 8080 })
wsServer.on('connection', (ws) => {
    ws.onopen = function () {
        console.log('open')
    }
    ws.onmessage = function (data) {
        console.log(data)
        ws.send('234')
        console.log('onmessage' + data)
    }
    ws.onerror = function () {
        console.log('onerror')
    }
    ws.onclose = function () {
        console.log('onclose')
    }
});

app.listen(8000, (err) => {
    if (!err) { console.log('監聽OK') } else {
        console.log('監聽失敗')
    }
})

複製代碼