@plugin-light/project-config-uni-vue

Uni App Vue 项目基础配置

Vue.config.js 配置，适用于 uni-app 项目。

1. 作者

novlan1

2. 如何使用

安装

pnpm add @plugin-light/project-config-uni-vue -D

在 vue.config.js 中添加如下设置：

const { getUniVueConfig } = require('@plugin-light/project-config-uni-vue');
const { merge } = require('webpack-merge');

module.exports = merge(getUniVueConfig(), {});

3. 类型说明

3.1. getUniVueConfig 参数

完整类型定义。

3.2. transpileDependencies

transpileDependencies 默认值如下：

['press-ui', 'press-plus', 'pmd-merchant-ui'];

3.3. adapterDirs

adapterDirs 默认值如下：

[
  'comm',
  'common',
  'component',
  'live-component',
  'logic',
  'local-logic',
  'local-component',
  'login',
  'pages',
  'static',
  'node-modules',
]

4. 常见问题

4.1. 打包产物分析怎么做

当 process.env.npm_config_report 不为 falsy 时，本工具会使用 webpack-bundle-analyzer 插件，开发者可用来进行打包分析。

当传入 saveBundleAnalyzeHtml 不为 falsy 时，会在 production 模式下，保存打包分析产物到 my-bundle-analyze.html 文件中，可以在流水线中进行归档。

4.2. 调试模式怎么打开

当 process.env.DEBUG_MODE 不为 falsy 时，本工具会设置 configureWebpack.optimization.minimize 为 false，开发者可以用来进行产物的代码分析。

4.3. sourceMap 怎么配置

options.needSourceMap 的默认值为：

checkH5() && process.env.NODE_ENV === 'production' && getGitCurBranch(__dirname) === 'release';

传入布尔值时，会取传入的值。

内部实现方式：

configureWebpack: {
  ...(needSourceMap ? {
    devtool: 'hidden-source-map',
  } : {}),
}

此外，研发平台子项目中填有 TAM_ID（上报ID） 的话，会在发布正式环境时，将 sourceMap 文件后上传到 TAM 平台对应的项目下。

可以在查看错误文件的时候，选择对应的 sourceMap，注意不用带域名，直接输入文件名，比如 main.1212.js.map。

4.4. 业务中获取分支名等变量

流水线会注入以下环境变量：

# 分支
VUE_APP_BRANCH

# 发布人
VUE_APP_AUTHOR

业务可以参考下面的方式获取：

const CUR_BRANCH = (process.env.VUE_APP_BRANCH || 'develop').replace(/\//, '.');

const shareUrl = `https://foo/bar.${CUR_BRANCH}/`

5. 更新日志

点此查看