uniapp 多环境打包

uni-app 项目中配置环境变量主要有如下三种方式:

第一种:vue-config.js

在 vue.config.js 中可以修改 webpack 配置,包括环境变量,具体参考 vue-config.js。

https://uniapp.dcloud.net.cn/collocation/vue-config.html

第二种:package.json

在自定义条件编译平台时,可以在 package.json 文件的 env 节点下配置环境变量,具体参考 package.json

package.json扩展配置用法:

bash 复制代码
{
    /**
     * package.json其它原有配置 
     * 拷贝代码后请去掉注释!
     */
    "uni-app": {// 扩展配置
        "scripts": {
            "custom-platform": { //自定义编译平台配置,可通过cli方式调用
                "title":"自定义扩展名称", // 在HBuilderX中会显示在 运行/发行 菜单中
                "browser":"",  //运行到的目标浏览器,仅当UNI_PLATFORM为h5时有效
                "env": {//环境变量
                    "UNI_PLATFORM": "",  //基准平台
                    "MY_TEST": "", // ... 其他自定义环境变量
                 },
                "define": { //自定义条件编译
                    "CUSTOM-CONST": true //自定义条件编译常量,建议为大写
                }
            }
        }    
    }
}

UNI_PLATFORM仅支持填写uni-app默认支持的基准平台,目前仅限如下枚举值:h5、mp-weixin、mp-alipay、mp-baidu、mp-toutiao、mp-qq

browser 仅在UNI_PLATFORM为h5时有效,目前仅限如下枚举值:chrome、firefox、ie、edge、safari、hbuilderx

package.json文件中不允许出现注释,否则扩展配置无效

vue-cli需更新到最新版,HBuilderX需升级到 2.1.6+ 版本

第三种:.env

HBuilderX 中的 uni-app vue3 和 uni-app x (4.25+) 项目及 CLI 创建的项目中可以在根目录中放置 .env 文件来指定环境变量

环境变量和模式:

bash 复制代码
Vite 在一个特殊的 import.meta.env 对象上暴露环境变量,这些变量在构建时会被静态地替换掉。这里有一些在所有情况下都可以使用的内建变量:
import.meta.env.MODE: {string} 应用运行的模式。
import.meta.env.BASE_URL: {string} 部署应用时的基本 URL。他由base 配置项决定。
import.meta.env.PROD: {boolean} 应用是否运行在生产环境(使用 NODE_ENV='production' 运行开发服务器或构建应用时使用 NODE_ENV='production' )。
import.meta.env.DEV: {boolean} 应用是否运行在开发环境 (永远与 import.meta.env.PROD相反)。
import.meta.env.SSR: {boolean} 应用是否运行在 server 上。

.env 文件

.env # 所有情况下都会加载

.env.local # 所有情况下都会加载,但会被 git 忽略

.env.[mode] # 只在指定模式下加载

.env.[mode].local # 只在指定模式下加载,但会被 git 忽略

bash 复制代码
环境加载优先级
一份用于指定模式的文件(例如 .env.production)会比通用文件的优先级更高(例如 .env)。
Vite 总是会加载 .env 和 .env.local 文件,除此之外还会加载模式特定的 .env.[mode] 文件。在模式特定文件中声明的变量优先级高于通用文件中的变量,但仅在 .env 或 .env.local 中定义的变量仍然可以在环境中使用。
另外,Vite 执行时已经存在的环境变量有最高的优先级,不会被 .env 类文件覆盖。例如当运行 VITE_SOME_KEY=123 vite build 的时候。
.env 类文件会在 Vite 启动一开始时被加载,而改动会在重启服务器后生效。
相关推荐
赵大仁3 小时前
uni-app 多平台分享实现指南
javascript·微信小程序·uni-app
Burt4 小时前
@antfu/eslint 支持 globals 全局变量
前端·uni-app·eslint
孤水寒月13 小时前
uniapp下的手势事件
前端·javascript·uni-app
柏萱科技17 小时前
快手短剧播放器uniapp如何引入与对接?
uni-app·短剧源码·快手短剧播放器
代码の搬运工1 天前
uniapp H5 对接 声网,截图
uni-app·声网·声网截图·声网视频截图
Burt1 天前
【unibest】可以去掉hbx模版了,base模板一统天下
前端·微信小程序·uni-app
初晨未凉2 天前
uniapp更新版本,apk包进度条,wgt包热更新
前端·javascript·uni-app
sleeppingfrog2 天前
uniapp中实现一个tree组件
uni-app
前端充电宝2 天前
uniapp - 基于uniapp+vue3实现自定义增强版table表格组件体验「兼容H5+小程序+App端」
前端·vue.js·小程序·uni-app