【从零开始搭建uniapp开发框架】（三）——uniapp设置分包机制

框架开源地址：https://gitee.com/yunhaotian/uniapp_mobileFrame

分包加载配置，此配置为小程序的分包加载机制。

因小程序有体积和资源加载限制，各家小程序平台提供了分包方式，优化小程序的下载和启动速度。

各个小程序分包大小及其限制

小程序	分包大小限制	总体积限制
微信小程序	2M	20M
百度小程序	2M	8M
支付宝小程序	2M	8M
QQ小程序	2M	24M
字节小程序	2M	16M

一、 在项目文件夹下新建static_sub文件夹用于存放分包静态资源文件

静态资源存放文件夹要与分包名称一致

在pages.json中填写分包配置和分包预加载配置

{
	"pages": [ //pages数组中第一项表示应用启动页，参考：https://uniapp.dcloud.io/collocation/pages
		{
			"path": "pages/index/index",
			"style": {}
		},
		{
            "path" : "pages/my/my",
            "style" : {}
        }
    ],
	// 分包配置
	"subPackages": [
		{
			// my分包
			"root": "sub_my",
			"name": "my",
			"pages": [{
				// 详情
				"path": "pages/list/list",
				"style": {}
			}]
		}
	],
　　// 分包预加载配置
	"preloadRule": { 
		// 进入我的后，预加载我的
		"pages/tab/my/my": {
			"network": "all",
			"packages": ["my"]
		}
　　　},
	//tabBar页面
	"tabBar": {
		"list": [{
				"pagePath": "pages/tab/index/index",
				"iconPath": "/static/tabImage/home.png",
				"selectedIconPath": "/static/tabImage/home1.png",
				"text": "首页"
			},
			{
				"pagePath": "pages/tab/my/my",
				"iconPath": "/static/tabImage/user.png",
				"selectedIconPath": "/static/tabImage/user1.png",
				"text": "我的"
			}
		],
		"color": "#999999",
		"selectedColor": "#593A25",
		"borderStyle": "white",
		"backgroundColor": "#fff"
	},
	"globalStyle": {
		"navigationStyle": "custom",
		"navigationBarTextStyle": "black",
		"navigationBarTitleText": "移动端框架",
		"navigationBarBackgroundColor": "#F8F8F8",
		"backgroundColor": "#F8F8F8"
	}
}

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

分包下支持独立的 img目录，用来对静态资源进行分包

uni-app内支持对微信小程序、QQ小程序、百度小程序、支付宝小程序、字节小程序(HBuilderX 3.0.3+)分包优化，即将静态资源或者js文件放入分包内不占用主包大小。

关于分包优化的说明

• 在对应平台的配置下添加"optimization":{"subPackages":true}开启分包优化
• 目前只支持mp-weixin、mp-qq、mp-baidu、mp-toutiao的分包优化
• 分包优化具体逻辑：
  • 静态文件：分包下支持 static 等静态资源拷贝，即分包目录内放置的静态资源不会被打包到主包中，也不可在主包中使用
  • js文件：当某个 js 仅被一个分包引用时，该 js 会被打包到该分包内，否则仍打到主包（即被主包引用，或被超过 1 个分包引用）
  • 自定义组件：若某个自定义组件仅被一个分包引用时，且未放入到分包内，编译时会输出提示信息

自定义静态资源目录以及打包分包静态资源合并

在项目文件夹新建vue.config.js文件

vue.config.js代码：static_sub静态文件分包目录和分包目录要一致

const path = require('path')
const CopyWebpackPlugin = require('copy-webpack-plugin')
 
module.exports = {
    configureWebpack: {
        plugins: [
            new CopyWebpackPlugin([{
                    from: path.join(__dirname, '/static_sub'),//static_sub与分包静态资源文件夹名称一致
                    to: path.join(__dirname + '/unpackage/', 'dist', process.env.NODE_ENV === 'production' ? 'build' : 'dev', process.env.UNI_PLATFORM, '/')
                }
            ])
        ]
    }
}

 

因为vue.config.js使用到了copy-webpack-plugin报错 ERROR Error: Cannot find module 'copy-webpack-plugin'

打开终端安装copy-webpack-plugin

npm install copy-webpack-plugin@5.1.1 -s