uni-app和小程序如何分包详细步骤

565 阅读3分钟

依旧是个平平无奇学习总结记录贴

分包概念

是改变项目的路由以及优化项目各个模块的启动时间的一种优化技术。

每个使用分包项目必定含有一个主包。所谓的主包,即放置默认启动页面/TabBar 页面,以及一些所有分包都需用到公共资源/JS 脚本;而分包则是根据开发者的配置进行划分。

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

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

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

分包基本逻辑

  • 静态文件:分包下支持 static 等静态资源拷贝,即分包目录内放置的静态资源不会被打包到主包中,也不可在主包中使用
  • js文件:当某个 js 仅被一个分包引用时,该 js 会被打包到该分包内,否则仍打到主包(即被主包引用,或被超过 1 个分包引用)
  • 自定义组件:若某个自定义组件仅被一个分包引用时,且未放入到分包内,编译时会输出提示信息

官方教程

uni-app分包小程序步骤详解

由于最新项目使用的是uni-app 这里就给介绍uni-app的分包步骤拉~

这是我分包小程序之后的目录结构

  • components: 存放公共组件
  • static:存放的是公共静态资源,图片类(最好放在服务器上,防止主包过大)
  • pages:主包,原则上pages内一般只存放tabbar页面路由,以及各个子包所共有的页面页面,如果有登录页且不登录无法进入主页面,该登录页面路由也应放置在pages路由内
  • page_***:都是分包 (主包可以引用分包内文件,分包仅可引用自身目录内的文件,分包与分包间文件无法互相引用)

1、配置manifest.json

在对应平台的配置下添加"optimization":{"subPackages":true}开启分包优化

2、配置pages.json

在pages.json中新建数组"subPackages",数组中包含两个参数:

  1. root:为子包的根目录
  2. pages:子包由哪些页面组成,参数同pages

注:页面使用时路由为:/page_agreement/loginAgreement

3、分包预载配置(preloadRule)

做这一步主要为了优化速度,不想优化速度的可以跳过这个配置

配置preloadRule后,在进入小程序某个页面时,由框架自动预下载可能需要的分包,提升进入后续分包页面时的启动速度

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

字段类型必填默认值说明
packagesStringArray进入页面后预下载分包的 root 或 name。APP 表示主包。
networkStringwifi在指定网络下预下载,可选值为:all(不限网络)、wifi(仅wifi下预下载)

app的分包,同样支持preloadRule,但网络规则无效。

4、针对vendor.js过大的情况可以使用运行时压缩代码

  • HBuilderX创建的项目勾选运行-->运行到小程序模拟器-->运行时是否压缩代码
  • cli创建的项目可以在pacakge.json中添加参数--minimize,示例: "dev:mp-weixin": "cross-env NODE_ENV=development UNI_PLATFORM=mp-weixin vue-cli-service uni-build --watch --minimize"