小程序学习记录十二：主包和分包概念

Love The Way You Lie 2021-09-07 14:14 857阅读 0赞

### 主包和分包概念 ###

*  一、分包
 *   *  1.什么是分包
     *  2.分包的好处
     *  3.分包后项目的构成
     *  4.分包加载规则
     *  5.分包的体积限制
     *  6.使用分包
     *  7.配置分包
     *  8.分包的打包原则
     *  9.包引用原则
 *  二、独立分包
 *   *  1.什么是独立分包
     *  2.独立分包和普通分包的区别
     *  3.独立分包的使用场景
     *  4.独立分包的配置方法
     *  5.独立分包的引用原则
 *  三、分包预下载
 *   *  1.什么是分包预下载
     *  2.配置分包的预下载
     *  3.分包预下载的限制

# 一、分包 #

## 1.什么是分包 ##

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

## 2.分包的好处 ##

优化小程序的下载时间，默认情况下，所有的页面是打包到一起的，用户需要下载整个小程序文件，才能启动，所以启动时间较长，分包可以先下载首页。  
不同的人可以进行不同的功能开发，更好的解耦工作。

## 3.分包后项目的构成 ##

小程序由一个主包或分包构成。  
主包：一般只包含项目的启动页面或TbbBar页面，以及所有分包都需要用到的一些公共资源，相当于下载了一个小程序，只有一个首页，和一些公共的代码。  
分包：只包含和当前分包有关的页面和私有资源，每个单独页面使用的资源

## 4.分包加载规则 ##

小程序启动时，默认会下载主包并启动主包内页面，  
tabBar页面许需要放到主包中

2.当用户进入分包的某个页面时，客户端会把对应分包下载下来，下载完成后再进行展示  
非tabBar页面可以安装功能的不同，划分为不同的包后，按需下载。

## 5.分包的体积限制 ##

1.整个小程序所有分包大小不超过16m，主包+分包  
2.当分包/主包大小不能超过2m

## 6.使用分包 ##

pages文件夹放主包所有页面  
在同级创建一个pageA来放第一个分包，可以创建多个分包。

## 7.配置分包 ##

//这里放主包所有页面
    "pages": [
        "pages/home/home",
        "pages/message/message",
        "pages/contact/contact"
      ],
    
    //这个节点用来声明分包的结构
     "subpackages": [
        { 
        //root表示第一个分包的目录
          "root": "pkgA",
          "name": "p1",
          "pages": [
          //当前分包下，所有页面的相对存放路径
          //写这里的路径，会自动在pkgA文件夹下生成路径下的文件夹
            "pages/cat/cat",
            "pages/dog/dog"
          ]
        },
        { 
        //第二个分包目录
          "root": "pkgB",
          //分包的别名
          "name": "p2",
          //当前分包下，所有页面的相对存放路径
          "pages": [
            "pages/apple/apple"
          ],
          //区分是否是独立分包
          "independent": true
        }
      ],

点击右侧详情，基本信息，可以看到每个包的体积。

## 8.分包的打包原则 ##

1.小程序会按subpackages的配置进行分包，subpackages之外的目录将被打包到主包中。  
2.主包也可以有自己的pages(即最外层的pages字段)。  
3.taBar页面必须在主包内，主包就是pages字段。  
4.分包之间不能相互嵌套，分包之间只能是平级的关系。

## 9.包引用原则 ##

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

# 二、独立分包 #

## 1.什么是独立分包 ##

独立分包本质上也是分包，只不过它比较特殊，可以独立于主包和分包而单独运行。  
小程序只能从主包启动小程序，不能从分包打开小程序  
有时候需要从分包也进入小程序，  
就需要独立分包了。

## 2.独立分包和普通分包的区别 ##

最主要的区别：是否依赖于主包才能运行  
1.独立报可以在不下载主包的情况下，独立运行  
2.普通分包必须依赖于主包才能运行。

## 3.独立分包的使用场景 ##

开发者可以按需，将某些具有一定功能独立性的页面配置到独立分包中。  
1.当小程序从普通的分包页面启动时，需要先下载主包。  
2.而独立分包不依赖主包的运行，可以很大程序上提升分包页面的启动速度。  
3.一个小程序可以有多个独立分包。

## 4.独立分包的配置方法 ##

和普通分包配置类型，在page文件夹同级创建独立分包文件夹。  
也是在app.json文件夹里subpackages节点写，主要区别是有无independent这个节点，true表示是独立分包，  
false或不写就是普通分包。

## 5.独立分包的引用原则 ##

独立分包和普通分包以及主包之间，是相互隔绝的，不能相互引用彼此的资源，  
1.主包无法引用独立分包内的私有资源  
2.独立分包之间，不能相互引用私有资源  
3.独立分包和普通分包之间，不能相互引用私有资源  
4.特别主要：独立分包中不能引用主包内的共有资源。  
总结：独立分包是独立的，谁也不能访问谁。

# 三、分包预下载 #

## 1.什么是分包预下载 ##

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

## 2.配置分包的预下载 ##

在app.json文件中

//分包预下载规则
      "preloadRule": { 
      //触发分包预下载的页面路径，当进入这个路径后，就会开始下载包。
        "pages/contact/contact": { 
     
         //packages表示进入页面后，预下载哪些分包
         //可以通过分包定义的root或name指定预下载哪些分包
          "packages": [
            "p1"
          ],
             //network表示指定的网络模式下进行预下载
             //可选值为all,不限网络或WiFi，仅在wifi模式下进行预下载
             //默认是wifi
          "network": "wifi"
        }
      },

## 3.分包预下载的限制 ##

同一个分包中的页面享有共同的预下载大小限额2M，即一共下载的包不能超过2m,包括主包，进入的页面和预下载的包。加起来不能超过2m。