摘要：最近使用開發(fā)了一款應(yīng)用，這里主要記錄開發(fā)調(diào)試打包的過程及做法。調(diào)用中的命令構(gòu)建?？梢酝ㄟ^命令啟動。至此基礎(chǔ)配置就差不多是這樣打包發(fā)布就可以直接通過。發(fā)布時我們無需修改任何配置及代碼，與開發(fā)環(huán)境是一致。

最近使用springboot, vue, webpack開發(fā)了一款SPA應(yīng)用，這里主要記錄開發(fā)+調(diào)試+打包的過程及做法。
使用的技術(shù)
gradle
springboot
vue.js
webpack

下面是開發(fā)時的項目結(jié)構(gòu)目錄，主要分成后端項目與前端項目，后端主要用于編寫服務(wù)器邏輯，前端則是編寫頁面和存放靜態(tài)資源。

-- springboot-vue-webpack-examples
|
|-- server
|   |
|   |-- src            // 源碼
|   |-- build          // 構(gòu)建輸出目錄
|
|-- ui
|   |
|   |-- build-scripts  // vue 構(gòu)建腳本
|   |-- config         // vue 配置文件
|   |-- src            // 源碼
|   |-- static         // 靜態(tài)資源
|   |-- build          // 構(gòu)建輸出目錄

ui項目通過vue init webpack ui命令創(chuàng)建使用的是vue提供的模板，之所以使用該模板因為里面已經(jīng)配置好了調(diào)試與生產(chǎn)打包方式，我們不需要做什么更改就可以直接使用。

默認(rèn)在vue的模板中構(gòu)建腳本是放置在build目錄中，這里將構(gòu)建腳本移置build-scripts目錄中，主要是因為gradle的默認(rèn)構(gòu)建輸出目錄是build為了減少配置而修改了vue構(gòu)建腳本的目錄，我感覺這是最簡單方便的，因為比如我們在使用代碼版本控制器的時候build目錄會被忽略而不提交至服務(wù)器，我不想去修改太多的配置。將vue構(gòu)建腳本移動后需要修改幾個點，如下圖

ui項目的gradle腳本配置，最終我們打包發(fā)布都是直接通過gradle命令，所以需要將node構(gòu)建集成到gradle中。

project(":ui") {

    apply plugin: "com.moowork.node"

    task cnpmInstall(type: NpmTask) {
        group = "node"
        args = ["install", "--registry=http://registry.cnpmjs.org"]
    }

    task buildUI(type: NpmTask, dependsOn: cnpmInstall) {
        group = "node"
        args = ["run", "build"]
    }
    jar.dependsOn buildUI

    task runDev(type: NpmTask, dependsOn: cnpmInstall) {
        group = "node"
        args = ["run", "dev"]
    }
}

cnpmInstall 該命令主要用于依賴安裝，之所以需要這個命令主要是因為我們的網(wǎng)絡(luò)環(huán)境不太好，將鏡像設(shè)置為國內(nèi)的下載依賴比較穩(wěn)定。
buildUI 調(diào)用package.json中的命令構(gòu)建ui。
runDev 可以通過gradlew :ui:runDev命令啟動ui。

ui/config/index.js 配置修改

// see http://vuejs-templates.github.io/webpack for documentation.
var path = require("path")

var assetsRoot = path.resolve(__dirname, "../build/resources/main/ui")
module.exports = {
  build: {
    env: require("./prod.env"),
    index: path.resolve(assetsRoot, "index.html"),
    assetsRoot: assetsRoot,
    assetsSubDirectory: "static",
    assetsPublicPath: "/",
    productionSourceMap: true,
    // Gzip off by default as many popular static hosts such as
    // Surge or Netlify already gzip all static assets for you.
    // Before setting to `true`, make sure to:
    // npm install --save-dev compression-webpack-plugin
    productionGzip: false,
    productionGzipExtensions: ["js", "css"]
  },
  dev: {
    env: require("./dev.env"),
    port: 3000,
    assetsSubDirectory: "static",
    assetsPublicPath: "/",
    proxyTable: {
      "/api/**": "http://localhost:8080"
    },
    // CSS Sourcemaps off by default because relative paths are "buggy"
    // with this option, according to the CSS-Loader README
    // (https://github.com/webpack/css-loader#sourcemaps)
    // In our experience, they generally work as expected,
    // just be aware of this issue when enabling this option.
    cssSourceMap: false
  }
}

assetsRoot 將webpack構(gòu)建的資源輸出至build/resources/main/ui目錄，gradle打包會將ui加入至classpath中，spring查找靜態(tài)資源有ui目錄區(qū)分比較方便。
proxyTable 增加代理配置將/api/** URL下的所有請求轉(zhuǎn)發(fā)至服務(wù)后端即springboot啟動的服務(wù)，這樣做的目的是為了方便debug，在vue webpack中已經(jīng)配置好了hot-dev，在開發(fā)中我們修改了前端js或者vue不需要重新構(gòu)建或重啟應(yīng)用前端就能響應(yīng)。所以在開發(fā)中我們啟動服務(wù)后的訪問入口是
http://localhost:3000
其實3000是express dev-server的端口，這里也體現(xiàn)了上面為什么要配置proxyTable，當(dāng)我們從dev-server作為訪問入口時與后端服務(wù)并不是同一個，存在跨域問題，但是通過代理可以避免這個問題，同時這并不會對生產(chǎn)環(huán)境造成影響，當(dāng)我們發(fā)布項目之后可以直接通過springboot服務(wù)作為訪問入口，因為在生產(chǎn)環(huán)境中我們不需要hot-reload功能。

服務(wù)端WEB配置

@Configuration
@RestController
public class WebConfiguration extends WebMvcConfigurerAdapter {

    @Value("classpath:/ui/index.html")
    private Resource indexHtml;

    @Bean
    @Order(Ordered.HIGHEST_PRECEDENCE)
    public CharacterEncodingFilter characterEncodingFilter() {
        CharacterEncodingFilter filter = new CharacterEncodingFilter("UTF-8", true);
        return filter;
    }

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/**").addResourceLocations("classpath:/ui/");
    }

    @Bean
    public ServletRegistrationBean apiV1ServletBean(WebApplicationContext wac) {
        DispatcherServlet servlet = new DispatcherServlet(wac);
        ServletRegistrationBean bean = new ServletRegistrationBean(servlet, "/api/v1/*");
        bean.setName("api-v1");
        return bean;
    }

    @RequestMapping("/")
    public Object index() {
        return ResponseEntity.ok().body(indexHtml);
    }
}

addResourceHandlers 增加靜態(tài)資源訪問路徑。
apiV1ServletBean 之所以增加一個servlet配置，是為了與靜態(tài)資源區(qū)分，后端服務(wù)都是通過restful接口交互而靜態(tài)資源是通過/根目錄的方式訪問。
index 根目錄返回index.html。

至此基礎(chǔ)配置就差不多是這樣打包發(fā)布就可以直接通過gradlew build。發(fā)布時我們無需修改任何配置及代碼，與開發(fā)環(huán)境是一致。而在開發(fā)環(huán)境中我們也保留良好的開發(fā)，及調(diào)試環(huán)境。
注：運(yùn)行時不需要nodejs環(huán)境

示例代碼：springboot-vue-webpack-examples