通过在package.json文件中增加uni-app扩展节点，可实现自定义条件编译平台（如钉钉小程序、微信服务号等平台）。

package.json扩展配置用法（拷贝代码记得去掉注释！）：

  1. {
  2.     /**
  3.      package.json其它原有配置 
  4.      */
  5.     "uni-app": {// 扩展配置
  6.         "scripts": {
  7.             "custom-platform": { //自定义编译平台配置，可通过cli方式调用
  8.                 "title":"自定义扩展名称", // 在HBuilderX中会显示在 运行/发行 菜单中
  9.                 "BROWSER":"",  //运行到的目标浏览器，仅当UNI_PLATFORM为h5时有效
  10.                 "env": {//环境变量
  11.                     "UNI_PLATFORM": ""  //基准平台 
  12.                  },
  13.                 "define": { //自定义条件编译
  14.                     "CUSTOM-CONST": true //自定义条件编译常量，建议为大写
  15.                 }
  16.             }
  17.         }    
  18.     }
  19. }

Tips：

  • UNI_PLATFORM仅支持填写uni-app默认支持的基准平台，目前仅限如下枚举值：app-plus、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需升级到Alpha 2.1.6+ 版本

示例：钉钉小程序

如下是一个自定义钉钉小程序（MP-DINGTALK）的package.json示例配置（拷贝代码记得去掉注释）：

  1. "uni-app": {
  2.     "scripts": {
  3.         "mp-dingtalk": { 
  4.             "title":"钉钉小程序", 
  5.             "env": { 
  6.                 "UNI_PLATFORM": "mp-alipay" 
  7.             },
  8.             "define": { 
  9.                 "MP-DINGTALK": true 
  10.             }
  11.         }
  12.     }
  13. }

在代码中使用自定义平台

开发者可在代码中使用MP-DINGTALK进行条件编译，如下：

  1. // #ifdef MP-DINGTALK
  2. 钉钉平台特有代码
  3. // #endif

运行及发布项目

vue-cli开发者可通过如下命令，启动钉钉小程序平台的编译：

  1. npm run dev:custom mp-dingtalk 
  2. npm run build:custom mp-dingtalk

HBuilderX会根据package.json的扩展配置，在运行、发行菜单下，生成自定义菜单（钉钉小程序），开发者点击对应菜单编译运行即可，如下图：

package.json - 图1

Tips：钉钉小程序编译目录依然是mp-alipay，需通过支付宝开发者工具，选择“钉钉小程序”，然后打开该目录进行预览及发布。

示例：微信服务号

如下是一个自定义微信服务号平台（H5-WEIXIN）的示例配置：

  1. "uni-app": {
  2.     "scripts": {
  3.         "h5-weixin": { 
  4.             "title":"微信服务号",
  5.             "BROWSER":"Chrome",  
  6.             "env": {
  7.                 "UNI_PLATFORM": "h5"  
  8.              },
  9.             "define": { 
  10.                 "H5-WEIXIN": true 
  11.             }
  12.         }
  13.     }    
  14. }

开发者可在代码块中使用H5-WEIXIN变量，如下：

  1. // #ifdef H5-WEIXIN
  2. 微信服务号特有代码
  3. // #endif

vue-cli开发者可通过如下命令，启动微信服务号平台（H5-WEIXIN）平台的编译：

  1. npm run dev:custom h5-weixin 
  2. npm run build:custom h5-weixin

HBuilderX会根据package.json的扩展配置，在运行、发行菜单下，生成自定义菜单（微信服务号），开发者点击对应菜单编译运行即可，如下图：

package.json - 图2

发现错误？想参与编辑？在 GitHub 上编辑此页面！