小程序分包加载

摘要:
开发者需要将小程序划分成不同的子包,在构建时打包成不同的分包,用户在使用时按需进行加载。当小程序从普通的分包页面中启动时,需要首先下载主包;而独立分包不依赖主包即可运行,可以很大程度上提升分包页面的启动速度,一个小程序中可以有多个独立分包。

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

在构建小程序分包项目时,构建会输出一个或多个分包。每个使用分包小程序必须包含

一个主包,所谓的主包,即放置默认启动页/TabBar 页面,以及一些所有分包需要用到

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

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

配置方法:

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

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

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

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

subPackages中,每个分包的配置有以下几项:

字段类型说明
rootString分包根目录
nameString分包别名,分包预下载时可以使用
pagesStringArray分包页面路径,相对与分包根目录
independentBoolean分包是否是独立分包

打包原则

声明subPackages后,将按subPackages配置路径进行打包,subPackages配置路径外的目

录将被打包到 app(主包) 中

app(主包)也可以有自己的 pages(即最外层的 pages 字段)

subPackage的根目录不能是另外一个subPackage内的子目录

tabBar页面必须在 app(主包)内

引用原则

packageA无法 requirepackageBJS 文件,但可以 requireapp、自己 package 内的 JS 文件

packageA无法 importpackageBtemplate,但可以 requireapp、自己 package 内的 template

packageA无法使用packageB的资源,但可以使用app、自己 package 内的资源

独立分包

独立分包是小程序的一种特殊类型的分包,可以独立于主包和其他分包独立运行。从独立

分包中页面进入小程序时,不需要下载主包,当小程序进入不同分包的时候,主包才会被下载。

可发者可以按需将某些具有一定功能独立性的页面配置到独立分包中。当小程序从普通的

分包页面中启动时,需要首先下载主包;而独立分包不依赖主包即可运行,可以很大程度上

提升分包页面的启动速度,一个小程序中可以有多个独立分包。

配置方法:

假设小程序的目录如下;

  ├── 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": "moduleA",
          "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

为了满足独立分包中的这一需求,基础库2.2.4 版本开始getApp 支持,

allowDefault 参数,在 App 未定义的时候返回一个默认实现。当主包

加载 App 被注册的时候,默认实现中被定义的属性会被合并覆盖到默认的App 中。

示例:

const app = getApp({allowDefault:true}) // {}

app.data = 456

app.global = {}

.app.js

App({

data:123

other:'hello'

})

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

2) 关于 App 的生命周期

当从独立分包中启动小程序时,主包的中的onLanch 和首次 onShow 会从

独立分包页面首次进入主包或普通分包页面时调用。

分包下载:

开发者可以通过配置,在进入小程序某个页面时,由框架自动预下载可需要的分包。

提升进入后续分包页面的速度,对于独立分包,可以预下载主包。

配置方法:

预下载分包行为在进入某个页面的时候触发,在通过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 是进入此页面的 预下载配置,每个配置都

有以下几项。

字段

类型

必填

默认值

说明

packages

StringArray

进入页面后预下载分包的rootname。__APP__表示主包。

network

String

wifi

在指定网络下预下载,可选值为:

all: 不限网络

wifi: wifi下预下载


限制

同一个分包中的页面享有共同的预下载大小限额2M,会在工具打包时校验。

如:页面A 和页面B 都在同一个分包中,A 中预下载大小为0.5 M的分包,

B 中最大多只能预下载大小1.5 的分包。

详细请参考https://developers.weixin.qq.com/miniprogram/dev/framework/subpackages.html

免责声明:文章转载自《小程序分包加载》仅用于学习参考。如对内容有疑问,请及时联系本站处理。

上篇swagger 基础入门crontab 定时备份 出现permission:denied下篇

宿迁高防,2C2G15M,22元/月;香港BGP,2C5G5M,25元/月 雨云优惠码:MjYwNzM=

相关文章

微信小程序仿系统预览大图功能

问题:微信小程序系统自带的 wx.previewImage 预览大图功能很好用,用起来很顺畅丝滑,但是有一个致命问题:预览大图的时候是在新页面中打开,当前页面的生命周期会销毁,如果当前页面中没有实时的东西还好,但如果有类似 <live_player> <live_push> <video> 等组件,或者有计时器之类的变量...

ArcGIS中地图导出格式比较(转)

转自:http://blog.sina.com.cn/s/blog_6438c8360101eqfx.html 有人问过这样的问题,用于出挂图的地图格式应该怎么选择?熟悉ArcGIS的用户都知道,ArcGIS支持打印导出的地图格式有很多,但它们之间也有所差异,在不同应用情况下要选择更加适合的格式,所以这里就做个详细的介绍。 1、如何导出地图 使用ArcMa...

请求响应,session,闪现

请求相关 # 请求相关信息 # request.method # request.args # request.form # request.values # request.cookies # request.headers # reques...

JUDE-UML工具软件介绍

  JUDE社区版(不考虑破-解)。 现在Jude改名为Astah了。JUDE已停止发展,Astah是它的替代品。Jude有3个版: Professional版, Community版(免费),Share版。 Astah也有以上的3个版本。Jude改名为Astah后很多功能被限制使用,如Astah-Community版的java代码导入导出功能被拿到了As...

基于python的种子搜索网站-开发过程

本讲会对种子搜索网站的开发过程进行详细的讲解。 源码地址:https://github.com/geeeeeeeek/bt 项目开发过程 项目简介 该项目是基于python的web类库django开发的一套web网站,做为本人的毕业设计。本人的研究方向是一项关于搜索的研究项目。在该项目中,笔者开发了一个简单版的搜索网站,实现了对数据库数据的检索和更新。 网...

安装win7的解决方法(“安装程序无法定位现有系统分区,也无法创建新的系统分区”)(转载记录一下备案)

  安装win7的解决方法(“安装程序无法定位现有系统分区,也无法创建新的系统分区”)   “安装程序无法定位现有系统分区,也无法创建新的系统分区”提示  我在使用win pe模式安装win7 ( 32 位)的时候出现“安装程序无法定位现有系统分区,也无法创建新的系统分区”提示。  解决步骤:  第一步:把win7镜像发在你电脑的非系统盘的其他硬盘上。  ...