微信小程序分包加载

时间: 2018-10-22阅读: 1337标签: 小程序

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

 

在构建小程序分包项目时,构建会输出一个或多个分包。每个使用分包小程序必须包含一个主包,所谓的主包,即放置默认启动页/TabBar 页面,以及一些所有分包需要用到整个小程序所有分包大小不超过 8M单个分包/主包大小不能超2M。

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


配置方法:

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

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

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

{
  "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 无法 require packageB JS 文件,但可以 require app、自己 package 内的 JS 文件

  packageA 无法 import packageB 的 template,但可以 require app、自己 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

进入页面后预下载分包的 root 或 name。__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


小程序 wepy框架 + iview-weapp的用法

最近在弄wepy的时候在想有没有什么ui比较合适一点的wepy的,也是在网上看了好久发现iview还不错。引用简单,上手超快,组件绚丽!当然,这里还介绍下微信官方建议的框架也是和不错的,有需要的可以看看

小程序自定义tabbar占位问题

针对于小程序中自定义tabbar问题,有多种自定义方式。其中之一就是需要将原先系统自带的tabbar隐藏,调用,就是在小程序底部原先放置tabbar的内容会出现空白,仍然会出现占位问题。

微信小程序开发早知道

小程序没有跳转公众号、跳转公众号图文素材的能力。除非用户通过扫描二维码进入小程序的情景,可以显示关注公众号组件。公众号菜单、公众号图文素材可以打开小程序,网页无法直接打开小程序。

小程序多端框架全面测评

最近前端届多端框架频出,相信很多有代码多端运行需求的开发者都会产生一些疑惑:这些框架都有什么优缺点?到底应该用哪个?作为 Taro 开发团队一员,笔者想在本文尽量站在一个客观公正的角度去评价各个框架的选型和优劣。

优雅解决微信小程序授权登录需要button触发

聊一聊最近的一个项目,这个项目是一个收书、售书的小程序,有商城、专栏、信息发布论坛等功能。虽然不是面向所有用户,但要求无论用户是否授权都皆可使用,但同时也要求部分功能对不授权的用户限制开放。

支付宝小程序个人开发者,但暂未开放支付接口

支付宝小程序今日正式面向个人开发者开放公测。这是继微信之后,业内第2家面向个人开发者开放的小程序平台。有开发能力的个人用户可访问支付宝小程序平台,扫码验证个人身份以后即可开始支付宝小程序账号申请并进行代码开发。

小程序wxs中的时间格式化以及格式化时间和date时间互转

WXS(WeiXin Script)是小程序的一套脚本语言,wxs 与 javascript 是不同的语言,有自己的语法,并不和 javascript 一致。其中包括了很多日常使用的javascript函数,在wxs中都是不能同样使用的。

微信小程序中清除定时器

在微信小程序的开发过程中,经常会遇到使用倒计时的情况,但是小程序的页面跳转经常会遇到跳转的下一个页面后,前一个页面的倒计时还在运行。这时候需要我们在关闭或者离开当前页面的时候清除掉当前的倒计时,但是传统的方式在小程序中无法使用,在小程序中我采用的是赋值然后清除的方法。

在微信小程序中保存网络图片

在小程序的文档中我们得知,wx.saveImageToPhotosAlbum 是用来保存图片到相册的。 但是仔细一看会发现这个接口的filePath参数只接受临时文件路径或永久文件路径,不支持网络图片路径,意味着我们不能直接调用这个接口。

个人怎么做微信小程序

据说移动互联网的轻量级应用是微信applet。简而言之,applet是基于微信平台的应用程序。目前,小方案的主题非常重要。它通知主要媒体和新闻,以及小程序如何打开。它也在增加,甚至个人也可以开发它

内容以共享、参考为目的,请勿用于商业用途。其版权归原作者所有,如有侵权,请与小编联系,情况属实将予以删除!

广告赞助文章投稿关于web前端网站点搜索站长推荐网站地图站长QQ:522607023

小程序专栏: 土味情话心理测试脑筋急转弯幽默笑话段子句子语录成语大全