更新记录

0.12.23（2025-06-25） 下载此版本

优化

0.12.22（2025-06-25） 下载此版本

优化

0.12.21（2025-06-25） 下载此版本

新增”保存当前OEM“

平台兼容性

HBuilderX插件通用注意事项

HBuilderX-2.7.12以下版本安装插件市场内的插件后，卸载时需手动卸载，详细教程参考：如何手动卸载插件

银响力 OEM Plugin for HBuilderx 说明（Custom Run Env）

主要解决多厂商OEM打包配置时需手动调整代码，这时得每次都需要去校验配置的正确性，且手动改代码费力费时，这里通过插件统一规范OEM配置及资源，一键生成对应配置、替换对应资源，简化OEM打包配置过程。

一、快速使用

• 在开始之前需要再Hbuilderx中安装对应插件下载地址并在项目根目录下创建.run_env目录，安装完成以后再对应项目右键菜单会新增OEM菜单组，包含四个功能：生成配置文件、新建、编辑、启动监听。
• 生成配置文件：点击后生成对应OEM配置及manifest.json，生成目录根据项目创建的方式而定，@vue/cli创建的在src下，hbuilderx创建的在项目跟根目录下。
• 新建：点击弹出表单视图，根据表单提示填写配置后会在OEM管理目录.run_env下创建一个新的OEM目录，打开该OEM配置可见存在manifest.json和config.json及assets文件目录。
• 编辑：点击弹出表单视图，并解析当OEM配置信息，修改完成后点击确认后会重新写入OEM配置中，如果修改了OEM名称，那么会生成一个新的OEM，并删除旧的数据。
• 启动监听：主要作用是监听OEM配置的修改动态生成配置，在调试时比较有用。

注意：当前插件配置默认都以银响力app当前环境进行了配置，基本都无需调整配置

二、配置说明

插件配置Settings->插件配置->customrunenv-tool

注意：【预设配置】为当前插件版本暂时未使用，后期会逐步完善

三、如何添加一个OEM配置

1、在对应项目中右键打开菜单，在OEM中选择“新建”选项，会出现以下表单窗口。

其中已存在的值都为OEM默认值，如果没有提供对应配置，则不需要进行调整，在配置完成所有配置项时，点击确认就会在指定的加载目录创建一个与OEM应用名同名文件目录，默认加载目录为项目根目录的.run_env。

1、新建OEM配置说明

2、选择商品

选择需要的商品类型，该配置作用于店铺选择页面头部tabs，和创建店铺页面店铺类型卡片选择。如果在下面配置了LOGO并且选择了该类型，则两个页面对应的LOGO会替换，如果不配置，OEM零售店铺下会默认替换成App的logo，其他则不影响。

3、OEM manifest.json配置

（1）原生插件

在Manifest配置窗口点击“选择原生插件”按钮，选择当前oem需要的插件，如果是新建的OEM应用，云打包插件需要先去uniapp插件市场进行购买才能使用。选择的插件如果需要配置key，点击确定后，会出现对应的配置项。