失眠网 > 小程序使用分包整体大小可达到20M

小程序使用分包整体大小可达到20M

时间：2019-11-18 00:56:53

相关推荐

小程序使用分包整体大小可达到20M

前言：（*方法与解释均摘取官方）

小程序因为体型太小是不支持打包下来特别大的，最新官方支持的总包是20m，单个文件包是2m.

官方入口：https://developers./miniprogram/dev/framework/subpackages.html

分包加载

微信客户端 6.6.0，基础库1.7.3及以上版本开始支持。开发者工具请使用 1.01.1712150 及以上版本，可点此下载。

某些情况下，开发者需要将小程序划分成不同的子包，在构建时打包成不同的分包，用户在使用时按需进行加载。

在构建小程序分包项目时，构建会输出一个或多个分包。每个使用分包小程序必定含有一个主包。所谓的主包，即放置默认启动页面/TabBar 页面，以及一些所有分包都需用到公共资源/JS 脚本；而分包则是根据开发者的配置进行划分。

在小程序启动时，默认会下载主包并启动主包内页面，当用户进入分包内某个页面时，客户端会把对应分包下载下来，下载完成后再进行展示。

目前小程序分包大小有以下限制：

整个小程序所有分包大小不超过 20M单个分包/主包大小不能超过 2M

对小程序进行分包，可以优化小程序首次启动的下载时间，以及在多团队共同开发时可以更好的解耦协作。

使用分包

配置方法

假设支持分包的小程序目录结构如下：

├── app.js├── app.json├── app.wxss├── packageA│ └── pages│├── cat│└── dog├── packageB│ └── pages│├── apple│└── banana├── pages│ ├── index│ └── logs└── utils

开发者通过在 app.jsonsubpackages字段声明项目分包结构：

写成 subPackages 也支持。

{"pages":["pages/index","pages/logs"],"subpackages": [{"root": "packageA","pages": ["pages/cat","pages/dog"]}, {"root": "packageB","name": "pack2","pages": ["pages/apple","pages/banana"]}]}

subpackages中，每个分包的配置有以下几项：

打包原则

声明subpackages后，将按subpackages配置路径进行打包，subpackages配置路径外的目录将被打包到 app（主包）中app（主包）也可以有自己的 pages（即最外层的 pages 字段）subpackage的根目录不能是另外一个subpackage内的子目录tabBar页面必须在 app（主包）内

引用原则

packageA无法 requirepackageBJS 文件，但可以 requireapp、自己 package 内的 JS 文件packageA无法 importpackageB的 template，但可以 requireapp、自己 package 内的 templatepackageA无法使用packageB的资源，但可以使用app、自己 package 内的资源

低版本兼容

由微信后台编译来处理旧版本客户端的兼容，后台会编译两份代码包，一份是分包后代码，另外一份是整包的兼容代码。新客户端用分包，老客户端还是用的整包，完整包会把各个subpackage里面的路径放到 pages 中。

示例项目

下载小程序示例（分包加载版）源码

独立分包

微信客户端 6.7.2，基础库2.3.0及以上版本开始支持。开发者工具请使用 1.02.1808300 及以上版本，可点此下载。

独立分包是小程序中一种特殊类型的分包，可以独立于主包和其他分包运行。从独立分包中页面进入小程序时，不需要下载主包。当用户进入普通分包或主包内页面时，主包才会被下载。

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

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

小游戏在基础库v2.12.2开始支持独立分包，详见小游戏独立分包指南。

配置方法

假设小程序目录结构如下：

├── app.js├── app.json├── app.wxss├── moduleA│ └── pages│ ├── rabbit│ └── squirrel├── moduleB│ └── pages│ ├── pear│ └── pineapple├── pages│ ├── index│ └── logs└── utils

开发者通过在app.json的subpackages字段中对应的分包配置项中定义independent字段声明对应分包为独立分包。

{"pages": ["pages/index","pages/logs"],"subpackages": [{"root": "moduleA","pages": ["pages/rabbit","pages/squirrel"]}, {"root": "moduleB","pages": ["pages/pear","pages/pineapple"],"independent": true}]}

限制

独立分包属于分包的一种。普通分包的所有限制都对独立分包有效。独立分包中插件、自定义组件的处理方式同普通分包。

此外，使用独立分包时要注意：

独立分包中不能依赖主包和其他分包中的内容，包括js文件、template、wxss、自定义组件、插件等。主包中的app.wxss对独立分包无效，应避免在独立分包页面中使用app.wxss中的样式；App只能在主包内定义，独立分包中不能定义App，会造成无法预期的行为；独立分包中暂时不支持使用插件。

注意事项

（1）关于getApp()

与普通分包不同，独立分包运行时，App并不一定被注册，因此getApp()也不一定可以获得App对象：

当用户从独立分包页面启动小程序时，主包不存在，App也不存在，此时调用getApp()获取到的是undefined。当用户进入普通分包或主包内页面时，主包才会被下载，App才会被注册。当用户是从普通分包或主包内页面跳转到独立分包页面时，主包已经存在，此时调用getApp()可以获取到真正的App。

由于这一限制，开发者无法通过App对象实现独立分包和小程序其他部分的全局变量共享。

为了在独立分包中满足这一需求，基础库2.2.4版本开始getApp支持 [allowDefault]参数，在App未定义时返回一个默认实现。当主包加载，App被注册时，默认实现中定义的属性会被覆盖合并到真正的App中。

示例代码：

独立分包中

const app = getApp({allowDefault: true}) // {}app.data = 456app.global = {}

app.js 中

App({data: 123,other: 'hello'})console.log(getApp()) // {global: {}, data: 456, other: 'hello'}

（2）关于App生命周期

当从独立分包启动小程序时，主包中App的onLaunch和首次onShow会在从独立分包页面首次进入主包或其他普通分包页面时调用。

由于独立分包中无法定义App，小程序生命周期的监听可以使用wx.onAppShow，wx.onAppHide完成。App上的其他事件可以使用wx.onError，wx.onPageNotFound监听。

低版本兼容

在低于6.7.2版本的微信中运行时，独立分包视为普通分包处理，不具备独立运行的特性。

注意：在兼容模式下，主包中的app.wxss可能会对独立分包中的页面产生影响，因此应避免在独立分包页面中使用app.wxss中的样式。

分包预下载

基础库 2.3.0 开始支持，低版本需做兼容处理。开发者工具请使用 1.02.1808300 及以上版本，可点此下载。

开发者可以通过配置，在进入小程序某个页面时，由框架自动预下载可能需要的分包，提升进入后续分包页面时的启动速度。对于独立分包，也可以预下载主包。

分包预下载目前只支持通过配置方式使用，暂不支持通过调用API完成。

vConsole 里有preloadSubpackages开头的日志信息，可以用来验证预下载的情况。

配置方法

预下载分包行为在进入某个页面时触发，通过在app.json增加preloadRule配置来控制。

{"pages": ["pages/index"],"subpackages": [{"root": "important","pages": ["index"],},{"root": "sub1","pages": ["index"],},{"name": "hello","root": "path/to","pages": ["index"]},{"root": "sub3","pages": ["index"]},{"root": "indep","pages": ["index"],"independent": true}],"preloadRule": {"pages/index": {"network": "all","packages": ["important"]},"sub1/index": {"packages": ["hello", "sub3"]},"sub3/index": {"packages": ["path/to"]},"indep/index": {"packages": ["__APP__"]}}}

preloadRule中，key是页面路径，value是进入此页面的预下载配置，每个配置有以下几项：