Linux 环境：

推荐node 版本为 v18.20.7
uapp 版本 >= 2.3.5，uapp -v 可以查看当前使用版本

Ubuntu 22.04 不要使用 apt install nodejs, 这个版本目前发现问题。建议使用 nvm 安装

安装后，必须确认modules 版本为108，如果109或其他的，sass 插件会有问题。查看版本方法：

node -p "process.versions.modules"

1、下载 hbx 插件包

目前仅支持 x64，不支持 arm

https://artisansoft.feishu.cn/docx/NZRHdetSzoi8VEx7KcYcuivpnqd#share-MCiDdm2tuotWyQx3lm4cPnsOnQd

传到 linux 服务器下，解压到 /usr/local/ 目录下，解压后的目录为 /usr/local/hbuilderx-linux

2、配置node 和 hbx 环境变量

# 初始化 uapp sdk
uapp sdk init

# 配置 hbx.dir
uapp config hbx.dir /usr/local/hbuilderx-linux

# 配置 node 
uapp config node `which node`

3、做好上面这些就可以成功编译了

uapp run build:mp-weixin --open

uapp run build:h5

常见问题

进入目录：/usr/local/hbuilderx-linux/plugins/uniapp-cli-vite/node_modules/mime/

mime.js 这个文件名有大写字母，全部改为小写字母。

如何升级 hbuilderx 版本

1. 电脑上升级安装最新版本的HBuilderX（Win，Mac 均可以）
2. 然后进入安装目录 HBuilderX/plugins ，plugins 下面，找到如下目录复制出来：

├── about
├── compile-dart-sass
├── compile-less
├── compile-node-sass
├── uniapp-cli
└── uniapp-cli-vite

3. 将最新版本上传到linux 里后，然后进去每个执行一下 npm install ，把里面的包都升级下。

有些包是包含系统 native 库的，不能copy就完事。所以不同系统，要单独更新下。如果更新完，欢迎在这个 issue 下分享一份 👍

禁止SDK 版本不一致的提示

修改 manifest.json ，在“app-plus”->"compatible" 节点下添加配置：

"app-plus": {

    "compatible": {

        "ignoreVersion": true //true表示忽略版本检查提示框，HBuilderX1.9.0及以上版本支持

    },  
//....  
}, 

jenkins 自动构建

参考 #9