diff --git a/docs/collocation/package.md b/docs/collocation/package.md index 2de7001770aff348ed30ab11d9a491773c67c76e..ae7aecb4aa1a883d67ef7ce6f9c2c6512381c5c0 100644 --- a/docs/collocation/package.md +++ b/docs/collocation/package.md @@ -1,4 +1,6 @@ -### 概述 +# package.json + +## uni-app 属性 - 在开发web时,有时需要一套代码编译发布到不同的站点,比如主站和微信h5站。(注意不是一套代码内部自适应不同浏览器,是真的分离部署了不同的网站) - 在开发小程序时,经常有扩展小程序平台,比如基于阿里小程序的钉钉小程序、淘宝小程序。 @@ -6,12 +8,14 @@ uni-app 通过在`package.json`文件中增加`uni-app`扩展节点,可实现自定义条件编译平台。 扩展新的平台后,有3点影响: + 1. 可以在代码里编写自定义的条件编译,为这个新平台编写专用代码 2. 运行时可以执行面向新平台的编译运行 3. 发行时可以执行面向新平台的编译发行 注意只能扩展web和小程序平台,不能扩展app打包。并且扩展小程序平台时只能基于指定的基准平台扩展子平台,不能扩展基准平台。基准平台详见下文。 +### 用法 package.json扩展配置用法: @@ -37,8 +41,6 @@ package.json扩展配置用法: } } } - - ``` Tips: @@ -48,7 +50,7 @@ Tips: - `package.json`文件中不允许出现注释,否则扩展配置无效 - `vue-cli`需更新到最新版,HBuilderX需升级到 2.1.6+ 版本 -#### 示例:钉钉小程序 +### 示例:钉钉小程序 如下是一个自定义钉钉小程序(MP-DINGTALK)的package.json示例配置(拷贝代码记得去掉注释): @@ -86,21 +88,22 @@ Tips: **运行及发布项目** `vue-cli`开发者可通过如下命令,启动钉钉小程序平台的编译: -``` + +```bash npm run dev:custom mp-dingtalk npm run build:custom mp-dingtalk ``` `HBuilderX`会根据`package.json`的扩展配置,在`运行`、`发行`菜单下,生成自定义菜单(钉钉小程序),开发者点击对应菜单编译运行即可,如下图: -![](https://img.cdn.aliyun.dcloud.net.cn/guide/uniapp/package-dingding.png) +![package dingding](https://img.cdn.aliyun.dcloud.net.cn/guide/uniapp/package-dingding.png) Tips:钉钉小程序编译目录依然是`mp-alipay`,需通过支付宝开发者工具,选择“钉钉小程序”,然后打开该目录进行预览及发布。 -#### 示例:微信服务号 +### 示例:微信服务号 如下是一个自定义微信服务号平台(H5-WEIXIN)的示例配置: - + ```json "uni-app": { "scripts": { @@ -120,7 +123,7 @@ Tips:钉钉小程序编译目录依然是`mp-alipay`,需通过支付宝开 开发者可在代码块中使用`H5-WEIXIN`变量,如下: -``` +```js // #ifdef H5 H5平台通用代码(含微信服务号) // #endif @@ -130,11 +133,12 @@ H5平台通用代码(含微信服务号) ``` `vue-cli`开发者可通过如下命令,启动微信服务号平台(H5-WEIXIN)平台的编译: -``` + +```bash npm run dev:custom h5-weixin npm run build:custom h5-weixin ``` `HBuilderX`会根据`package.json`的扩展配置,在`运行`、`发行`菜单下,生成自定义菜单(微信服务号),开发者点击对应菜单编译运行即可,如下图: -![](https://img.cdn.aliyun.dcloud.net.cn/guide/uniapp/package-h5-weixin.png) +![](https://img.cdn.aliyun.dcloud.net.cn/guide/uniapp/package-h5-weixin.png) \ No newline at end of file