mirror of
https://github.com/PanJiaChen/vue-element-admin.git
synced 2025-08-12 14:24:34 +08:00
f45a57178a
* Add support to x vversion from npm * Add support to x vversion from npm * Add support to x vversion from npm * Add documentation for current repository
141 lines
5.3 KiB
Markdown
Executable File
141 lines
5.3 KiB
Markdown
Executable File
# 构建和发布
|
||
|
||
## 构建
|
||
|
||
当项目开发完毕，只需要运行一行命令就可以打包你的应用：
|
||
|
||
```bash
|
||
# 打包正式环境
|
||
npm run build:prod
|
||
|
||
# 打包预发布环境
|
||
npm run build:stage
|
||
```
|
||
|
||
构建打包成功之后，会在根目录生成 `dist` 文件夹，里面就是构建打包好的文件，通常是 `***.js` 、`***.css`、`index.html` 等静态文件。
|
||
|
||
如果需要自定义构建，比如指定 `dist` 目录等，则需要通过 [config](https://github.com/adempiere/adempiere-vue/blob/master/vue.config.js)的 `outputDir` 进行配置。
|
||
|
||
<br>
|
||
|
||
## 环境变量
|
||
|
||
所有测试环境或者正式环境变量的配置都在 [.env.development](https://github.com/adempiere/adempiere-vue/blob/master/.env.development)等 `.env.xxxx`文件中。
|
||
|
||
它们都会通过 `webpack.DefinePlugin` 插件注入到全局。
|
||
|
||
::: tip 注意！！！
|
||
环境变量必须以`VUE_APP_`为开头。如:`VUE_APP_API`、`VUE_APP_TITLE`
|
||
|
||
你在代码中可以通过如下方式获取:
|
||
|
||
```js
|
||
console.log(process.env.VUE_APP_xxxx)
|
||
```
|
||
|
||
:::
|
||
|
||
<br>
|
||
|
||
## 分析构建文件体积
|
||
|
||
如果你的构建文件很大，你可以通过 `webpack-bundle-analyzer` 命令构建并分析依赖模块的体积分布，从而优化你的代码。
|
||
|
||
```bash
|
||
npm run preview -- --report
|
||
```
|
||
|
||
运行之后你就可以在 [http://localhost:9526/report.html](http://localhost:9526/report.html) 页面看到具体的体积分布
|
||
|
||
|
||
|
||
具体的优化可以参考 [Webpack 大法之 Code Splitting](https://zhuanlan.zhihu.com/p/26710831)
|
||
|
||
::: tip
|
||
强烈建议开启 gzip ，使用之后普遍体积只有原先 1/3 左右。打出来的 app.js 过大，查看一下是不是 Uglify 配置不正确或者 sourceMap 没弄对。 优化相关请看该 [Webpack Freestyle 之 Long Term Cache](https://zhuanlan.zhihu.com/p/27710902)
|
||
:::
|
||
|
||
<br>
|
||
|
||
## 发布
|
||
|
||
对于发布来讲，只需要将最终生成的静态文件，也就是通常情况下 `dist` 文件夹的静态文件发布到你的 cdn 或者静态服务器即可，需要注意的是其中的 `index.html` 通常会是你后台服务的入口页面，在确定了 js 和 css 的静态之后可能需要改变页面的引入路径。
|
||
|
||
::: tip
|
||
部署时可能会发现资源路径不对 ,只需修改 `vue.config.js` 文件资源路径即可。
|
||
:::
|
||
|
||
```js
|
||
publicPath: './' //请根据自己路径来配置更改
|
||
```
|
||
|
||
## 前端路由与服务端的结合
|
||
|
||
adempiere-vue 中，前端路由使用的是 `vue-router`，所以你可以选择两种方式：`browserHistory` 和 `hashHistory`。
|
||
|
||
两者的区别简单来说是对路由方式的处理不一样，`hashHistory` 是以 `#` 后面的路径进行处理，通过 [HTML 5 History](https://developer.mozilla.org/en-US/docs/Web/API/History_API) 进行前端路由管理，而 `browserHistory` 则是类似我们通常的页面访问路径，并没有 `#`，但要通过服务端的配置，能够访问指定的 url 都定向到当前页面，从而能够进行前端的路由管理。
|
||
|
||
本项目默认使用的是 `hashHistory` ，所以如果你的 url 里有 `#`，想去掉的话，需要切换为 `browserHistory`。
|
||
修改 `src/router/index.js` 中的 mode 即可
|
||
|
||
```js
|
||
export default new Router({
|
||
// mode: 'history', //后端支持可开
|
||
})
|
||
```
|
||
|
||
如果你使用的是静态站点，那么使用 `browserHistory` 可能会无法访问你的应用，因为假设你访问 `http://localhost:9527/dashboard`，那么其实你的静态服务器并没有能够映射的文件，而使用 `hashHistory` 则不会有这个问题，因为它的页面路径是以 `#` 开始的，所有访问都在前端完成，如：`http://localhost:9527/#/dashboard/`。
|
||
|
||
不过如果你有对应的后台服务器，那么我们推荐采用 `browserHistory`，只需要在服务端做一个映射，比如：
|
||
|
||
Apache
|
||
|
||
```bash
|
||
<IfModule mod_rewrite.c>
|
||
RewriteEngine On
|
||
RewriteBase /
|
||
RewriteRule ^index\.html$ - [L]
|
||
RewriteCond %{REQUEST_FILENAME} !-f
|
||
RewriteCond %{REQUEST_FILENAME} !-d
|
||
RewriteRule . /index.html [L]
|
||
</IfModule>
|
||
```
|
||
|
||
nginx
|
||
|
||
```bash
|
||
location / {
|
||
try_files $uri $uri/ /index.html;
|
||
}
|
||
```
|
||
|
||
::: tip
|
||
更多配置请查看 [vue-router 文档](https://router.vuejs.org/zh-cn/essentials/history-mode.html)
|
||
:::
|
||
|
||
## Apache
|
||
|
||
1. 需要修改`router/index.js`中`new Router` 配置，加一个`base: '/vue/'`, 它指定应用的基路径，该应用是服务于`localhost/vue`路径下，所以必须加`base`配置，否则应用会展示 404 页面
|
||
2. 需要修改`config/index.js`中 build 下的`assetsPublicPath: '/vue/'`，如果用相对路径，chunk 文件会报错找不到。
|
||
3. 修改`httpd.conf`文件，开启 rewrite_module 功能。
|
||
|
||
- `LoadModule rewrite_module libexec/apache2/mod_rewrite.so`，去掉前面的#。
|
||
- 然后找到`AllowOverride None`的那行，把它改成`AllowOverride All`，来使`.htaccess`文件生效。
|
||
|
||
4. 在 apache 的`www/vue` 目录下新建`.htaccess`文件, 需要修改`RewriteRule` 为`/vue/index.html`, 否则刷新页面服务端会直接报 404 错误。
|
||
|
||
.htaccess 文件内容
|
||
|
||
```
|
||
<IfModule mod_rewrite.c>
|
||
RewriteEngine On
|
||
RewriteBase /
|
||
RewriteRule ^index\.html$ - [L]
|
||
RewriteCond %{REQUEST_FILENAME} !-f
|
||
RewriteCond %{REQUEST_FILENAME} !-d
|
||
RewriteRule . /vue/index.html [L]
|
||
</IfModule>
|
||
```
|
||
|
||
相关[issue](https://github.com/adempiere/adempiere-vue/issues/370)
|