使用npm包，全局共享数据，分包

电玩女神 2024-03-24 16:52 54阅读 0赞

### 使用 npm 包 ###

#### 1、Vant Weapp ####

##### 1.1、什么是 Vant Weapp #####

Vant Weapp 是有赞前端团队开源的一套小程序 UI 组件库，助力开发者快速搭建小程序应用。它所使用的是MIT 开源许可协议，对商业使用比较友好。

官方文档地址 [https://youzan.github.io/vant-weapp][https_youzan.github.io_vant-weapp]

##### 1.2、安装 Vant 组件库 #####

在小程序项目中，安装 Vant 组件库主要分为如下 3 步：

*  通过 npm 安装（建议指定版本为@1.3.3）
 *  构建 npm 包
 *  修改 app.json

详细的操作步骤，参考 Vant 官方提供的快速上手教程：[https://youzan.github.io/vant-weapp/\#/quickstart\#an-zhuang][https_youzan.github.io_vant-weapp_quickstart_an-zhuang]

*  初始化，生成package.json文件  
    ![在这里插入图片描述][f9f13a36f50143cf98aebb205513579e.png]![在这里插入图片描述][a9cb345e24964c5fabc32974e77cba71.png]
 *  npm 安装vant，安装了1.3.3版本  
    ![在这里插入图片描述][ec508de818064331a3da82642c1ed3f2.png]
 *  将 app.json 中的 “style”: “v2” 去除，  
    ![在这里插入图片描述][8052fd79ebf14096b182f94d71340cab.png]
 *  打开微信开发者工具，点击 工具 -> 构建 npm，并勾选 使用 npm 模块 选项，构建完成后，即可引入组件（新版不需要勾选）  
    ![在这里插入图片描述][fc5547d72cea44daaaf8a436288ed7e7.png]

##### 1.3、使用 Vant 组件 #####

安装完 Vant 组件库之后，可以在 app.json 的 usingComponents 节点中引入需要的组件，即可在 wxml 中直接使用组件。

示例代码如下：  
![在这里插入图片描述][f630c66ec4a34813a429a650eb4b236a.png]

*  引入组件

"usingComponents": {
        
        "van-button": "@vant/weapp/button/index"
      }

*  使用

<van-button type="primary">主要按钮</van-button>

![在这里插入图片描述][23daa50da9f44ea59350c5009f9b76df.png]

##### 1.4、定制全局主题样式 #####

Vant Weapp 使用 CSS 变量来实现定制主题。

关于 CSS 变量的基本用法，请参考 MDN 文档：[https://developer.mozilla.org/zh-CN/docs/Web/CSS/Using\_CSS\_custom\_properties][https_developer.mozilla.org_zh-CN_docs_Web_CSS_Using_CSS_custom_properties]

##### 1.5、定制全局主题样式 #####

所有可用的颜色变量，请参考 Vant 官方提供的配置文件：[https://github.com/youzan/vant-weapp/blob/dev/packages/common/style/var.less][https_github.com_youzan_vant-weapp_blob_dev_packages_common_style_var.less]

在 app.wxss 中，写入 CSS 变量，即可对全局生效：

<van-button type="danger">危险按钮</van-button>

page{
        
        --button-danger-background-color: #c00000;
        --button-danger-border-color: #D60000;
    }

![在这里插入图片描述][cc58747ae559491e833986bf3f1569fc.png]

#### 2、API Promise化 ####

##### 2.1、基于回调函数的异步 API 的缺点 #####

默认情况下，小程序官方提供的异步 API 都是基于回调函数实现的，例如，网络请求的 API 需要按照如下的方式调用：  
![在这里插入图片描述][c4d8ec44901b4405b11455e79dfc44f8.png]

缺点：容易造成回调地狱的问题，代码的可读性、维护性差！

##### 2.2、 什么是 API Promise 化 #####

API Promise化，指的是通过额外的配置，将官方提供的、基于回调函数的异步 API，升级改造为基于Promise 的异步 API，从而提高代码的可读性、维护性，避免回调地狱的问题。

##### 2.3、 实现 API Promise 化 #####

在小程序中，实现 API Promise 化主要依赖于 miniprogram-api-promise 这个第三方的 npm 包。它的安装和使用步骤如下：

*  安装1.0.4版本

npm install --save miniprogram-api-promise@1.0.4

*  再次构建  
    ![在这里插入图片描述][311954d7c46047e289ac562a957ed3a9.png]![在这里插入图片描述][05ee49e379ec42119a5b1e20fbc03868.png]
 *  app.js中引入

import {
        promisifyAll} from 'miniprogram-api-promise';
    
    const wxp = wx.p = {
        }
    promisifyAll(wx,wxp)

##### 2.4、调用 Promise 化之后的异步 API #####

<van-button type="primary" bindtap="getInfo">主要按钮</van-button>

async getInfo(){
        
        const {
        data: res} = await wx.p.request({
        
          url: 'https://www.escook.cn/api/get',
          method: 'GET',
          data: {
        
            name: 'zs',
            age: 24
          },
        })
    
        console.log(res);
      },

![在这里插入图片描述][a6a2e12c841c46c0bdfa93f14a0e0d4e.png]

### 全局数据共享 ###

#### 1、什么是全局数据共享 ####

全局数据共享（又叫做：状态管理）是为了解决组件之间数据共享的问题。

开发中常用的全局数据共享方案有：Vuex、Redux、MobX 等。

#### 2、小程序中的全局数据共享方案 ####

在小程序中，可使用 mobx-miniprogram 配合 mobx-miniprogram-bindings 实现全局数据共享。其中：

*  mobx-miniprogram ：用来创建 Store 实例对象。
 *  mobx-miniprogram-bindings ：用来把 Store 中的共享数据或方法，绑定到组件或页面中使用。

#### 3、MobX ####

##### 3.1、 安装 MobX 相关的包 #####

*  在项目中运行如下的命令，安装 MobX 相关的包：

npm install --save mobx-miniprogram@4.13.2 mobx-miniprogram-bindings@1.2.1

*  再次构建npm  
    ![在这里插入图片描述][1b149fec27ce40b5ba84b4435fd692f0.png]![在这里插入图片描述][427702c6c5484b149c68db296417961e.png]

##### 3.2、创建 MobX 的 Store 实例 #####

创建store.js

import {
         observable,action } from 'mobx-miniprogram';
    
    export const store = observable({
        
        //数据字段
        num1: 1,
        num2: 2,
        //计算属性
        get sum(){
        
            return this.num1 + this.num2;
        },
        //action，修改store中的属性
        updNum1: action(function(step){
        
            this.num1 += step
        }),
        updNum2: action(function(step){
        
            this.num2 += step
        })
    
    })

##### 3.3、将 Store 中的成员绑定到页面中 #####

import {
         createStoreBindings} from 'mobx-miniprogram-bindings';
    import {
        store} from '../../store/store';
    
    Page({
        
    	  /**
     * 生命周期函数--监听页面加载
       */
      onLoad: function (options) {
        
        this.storeBinding = createStoreBindings(this,{
        
            store,
            fields: ['num1','num2','sum'],
            actions: ['updNum1']
        })
      },
      /**
     * 生命周期函数--监听页面卸载
       */
      onUnload: function () {
        
        this.storeBinding.destroyStoreBindings();
      },
    })

##### 3.4、在页面上使用 Store 中的成员 #####

*  wxml代码

btnFun1(e){
        
        this.updNum1(e.target.dataset.step);
      },

![在这里插入图片描述][2ccbc468c6e14920b44c89b2f7977a34.png]

##### 3.5、将 Store 中的成员绑定到组件中 #####

import {
         storeBindingsBehavior} from "mobx-miniprogram-bindings"
    import {
         store } from "../../store/store"
    
    
    Component({
        
        // 实现绑定
        behaviors: [storeBindingsBehavior],
        storeBindings: {
        
            store,
            // 字段
            fields:{
        
                num1: 'num1',
                num2: 'num2',
                sum: 'sum'
            },
            // 方法
            actions:{
        
                updNum2: 'updNum2'
            }
        },
       }
    })

##### 3.6、在组件中使用 Store 中的成员 #####

/**
         * 组件的方法列表
         */
        methods: {
        
            btnFun2(e){
        
                this.updNum2(e.target.dataset.step);
            }
        }

*  效果  
    ![在这里插入图片描述][6017eb5ea0a84811b89e72cfc054fd78.png]

### 分包 ###

#### 1、基础概念 ####

##### 1.1、什么是分包 #####

分包指的是把一个完整的小程序项目，按照需求划分为不同的子包，在构建时打包成不同的分包，用户在使用时按需进行加载。

##### 1.2、分包的好处 #####

对小程序进行分包的好处主要有以下两点：

*  可以优化小程序首次启动的下载时间。
 *  在多团队共同开发时可以更好的解耦协作。

##### 1.3、 分包前项目的构成 #####

分包前，小程序项目中所有的页面和资源都被打包到了一起，导致整个项目体积过大，影响小程序首次启动的下载时间。  
![在这里插入图片描述][b0e97317d9b7473289922905bec32f2f.png]

##### 1.4、分包后项目的构成 #####

分包后，小程序项目由 1 个主包 + 多个分包组成：

*  主包：一般只包含项目的启动页面或 TabBar 页面、以及所有分包都需要用到的一些公共资源。
 *  分包：只包含和当前分包有关的页面和私有资源。  
    ![在这里插入图片描述][8aa56e80d0b4433c848162f0dac1e12b.png]

##### 1.5、分包的加载规则 #####

*  在小程序启动时，默认会下载主包并启动主包内页面
    
     *  tabBar 页面需要放到主包中。
 *  当用户进入分包内某个页面时，客户端会把对应分包下载下来，下载完成后再进行展示
    
     *  非 tabBar 页面可以按照功能的不同，划分为不同的分包之后，进行按需下载。

##### 1.6、 分包的体积限制 #####

目前，小程序分包的大小有以下两个限制：

*  整个小程序所有分包大小不超过 16M（主包 + 所有分包）。
 *  单个分包/主包大小不能超过 2M。

#### 2、使用分包 ####

##### 2.1、配置方法 #####

"subPackages": [
          {
        
              "root": "packA",
              "name": "PA",
              "pages": [
                  "pages/cat/cat",
                  "pages/add/add"
              ]
          },{
        
              "root": "packB",
              "name": "PB",
              "pages": [
                  "pages/go/go"
              ]
          }
      ],

![在这里插入图片描述][b49d5b68f8a342b3ad6dcc8dc8e1eb66.png]![在这里插入图片描述][a70b30e9e9134d8394f1fa675713ecf1.png]

##### 2.2、打包原则 #####

*  小程序会按 subpackages 的配置进行分包，subpackages 之外的目录将被打包到主包中。
 *  主包也可以有自己的 pages（即最外层的 pages 字段）。
 *  tabBar 页面必须在主包内。
 *  分包之间不能互相嵌套。

##### 2.3、引用原则 #####

*  主包无法引用分包内的私有资源。
 *  分包之间不能相互引用私有资源。
 *  分包可以引用主包内的公共资源。

![在这里插入图片描述][87d0911c787b4a63961482b5437787f8.png]

#### 3、独立分包 ####

##### 3.1、 什么是独立分包 #####

独立分包本质上也是分包，只不过它比较特殊，可以独立于主包和其他分包而单独运行。  
![在这里插入图片描述][7e6d7c77bf2b49ec9eddcd46e8db622c.png]

##### 3.2、独立分包和普通分包的区别 #####

最主要的区别：是否依赖于主包才能运行

*  普通分包必须依赖于主包才能运行。
 *  独立分包可以在不下载主包的情况下，独立运行。

##### 3.3、独立分包的应用场景 #####

开发者可以按需，将某些具有一定功能独立性的页面配置到独立分包中。原因如下：

*  当小程序从普通的分包页面启动时，需要首先下载主包
 *  而独立分包不依赖主包即可运行，可以很大程度上提升分包页面的启动速度

注意：一个小程序中可以有多个独立分包。

##### 3.4、独立分包的配置方法 #####

{
        
            "root": "packC",
            "name": "PC",
            "pages": [
                "pages/cook/cook"
            ],
            //设置为true
            "independent": true
        }

##### 3.5、引用原则 #####

独立分包和普通分包以及主包之间，是相互隔绝的，不能相互引用彼此的资源！

例如：

*  主包无法引用独立分包内的私有资源
 *  独立分包之间，不能相互引用私有资源
 *  独立分包和普通分包之间，不能相互引用私有资源
 *  特别注意：独立分包中不能引用主包内的公共资源

#### 4、分包预下载 ####

##### 4.1、什么是分包预下载 #####

分包预下载指的是：在进入小程序的某个页面时，由框架自动预下载可能需要的分包，从而提升进入后续分包页面时的启动速度。

##### 4.2、 配置分包的预下载 #####

预下载分包的行为，会在进入指定的页面时触发。在 app.json 中，使用 preloadRule 节点定义分包的预下载规则，示例代码如下：

"preloadRule": {
        
      		//触发分包预下载的页面路径
          "pages/contact/contact": {
        
          //network:在指定的网络进行下载，可选值为：all,WiFi
            "network": "wifi",
            //预下载的分包
            "packages": ["packA"]
          }
      },

*  点击联系我们页面，网络为WiFi时，下载  
    ![在这里插入图片描述][e21ca481f1b7470892bb5101fa44752a.png]

![在这里插入图片描述][612278329f174ed08dc115ad9b5a9e41.png]

##### 4.3、分包预下载的限制 #####

同一个分包中的页面享有共同的预下载大小限额 2M，例如：

*  不允许，分包 A+B+C 体积大于 2M

![在这里插入图片描述][89f7b5c3763c4925a50018be8f8ea58f.png]

*  允许，分包 A+B+C 体积小于 2M  
    ![在这里插入图片描述][a94c0fd552da4c1783b753b0ca92f7ee.png]  
    结束！！！！！！！

--------------------

我无法摆脱死亡，难道也无法摆脱对死亡的恐惧吗？---罗翔老师

[https_youzan.github.io_vant-weapp]: https://youzan.github.io/vant-weapp
[https_youzan.github.io_vant-weapp_quickstart_an-zhuang]: https://youzan.github.io/vant-weapp/#/quickstart#an-zhuang
[f9f13a36f50143cf98aebb205513579e.png]: https://img-blog.csdnimg.cn/f9f13a36f50143cf98aebb205513579e.png
[a9cb345e24964c5fabc32974e77cba71.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/886812f5ef644b46b82aaa9669b1d174.png
[ec508de818064331a3da82642c1ed3f2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/20378ecd743d442aba1de13000bef17f.png
[8052fd79ebf14096b182f94d71340cab.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/c7e4a2ebda694daf806942154ebc9915.png
[fc5547d72cea44daaaf8a436288ed7e7.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/b82e3f751c2e4ef284c3a8e5c7795aab.png
[f630c66ec4a34813a429a650eb4b236a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/ed49f1110ee04abfb2507b6bb65f79d1.png
[23daa50da9f44ea59350c5009f9b76df.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/dda60822e954494db97d0dba7c206899.png
[https_developer.mozilla.org_zh-CN_docs_Web_CSS_Using_CSS_custom_properties]: https://developer.mozilla.org/zh-CN/docs/Web/CSS/Using_CSS_custom_properties
[https_github.com_youzan_vant-weapp_blob_dev_packages_common_style_var.less]: https://github.com/youzan/vant-weapp/blob/dev/packages/common/style/var.less
[cc58747ae559491e833986bf3f1569fc.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/b8be6534a63043f88d705dad84433092.png
[c4d8ec44901b4405b11455e79dfc44f8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/13077e891ed4459dbc172dfba3a016d9.png
[311954d7c46047e289ac562a957ed3a9.png]: https://img-blog.csdnimg.cn/311954d7c46047e289ac562a957ed3a9.png
[05ee49e379ec42119a5b1e20fbc03868.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/866d96d1d91348f4841402ea15934e3a.png
[a6a2e12c841c46c0bdfa93f14a0e0d4e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/39da8b157a92458fadfee03c0ac153b5.png
[1b149fec27ce40b5ba84b4435fd692f0.png]: https://img-blog.csdnimg.cn/1b149fec27ce40b5ba84b4435fd692f0.png
[427702c6c5484b149c68db296417961e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/03a94d7a2f914b2bbd3e3e1c997cf91e.png
[2ccbc468c6e14920b44c89b2f7977a34.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/7b5987f6e19d4efe9b5d4e02414ebc4c.png
[6017eb5ea0a84811b89e72cfc054fd78.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/79cea07915ff42b191d7ed7bdb1ef386.png
[b0e97317d9b7473289922905bec32f2f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/42ddd4667d154a9598cddee82315ade7.png
[8aa56e80d0b4433c848162f0dac1e12b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/d77703cd7670475999e812441816f18d.png
[b49d5b68f8a342b3ad6dcc8dc8e1eb66.png]: https://img-blog.csdnimg.cn/b49d5b68f8a342b3ad6dcc8dc8e1eb66.png
[a70b30e9e9134d8394f1fa675713ecf1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/fe51acb05c5647b793abb6eef8ec248d.png
[87d0911c787b4a63961482b5437787f8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/6c8b2f554476451da33f82bc7510135f.png
[7e6d7c77bf2b49ec9eddcd46e8db622c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/24879cd375b6485b995949b5b934ab3a.png
[e21ca481f1b7470892bb5101fa44752a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/752338ab1987435e93cf359fabe9a46c.png
[612278329f174ed08dc115ad9b5a9e41.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/231d667dad3842a682f6a52e3c9c93a3.png
[89f7b5c3763c4925a50018be8f8ea58f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/5d53026fd9274575a540c5da6fb5e6a4.png
[a94c0fd552da4c1783b753b0ca92f7ee.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/912da56fd0ed4f629dcd11a9b93066fd.png