uniapp小程序分包使用的是subPackages分包加載機制
subPackages是分包加載配置，此配置為小程序的分包加載機制。
因為小程序有體積和資源加載限制，各家小程序平台提供了分包方式，優化小程序的下載和啟動速度。
所謂的主包，即放置默認啟動頁面/TabBar 頁面，以及一些所有分包都需用到公共資源/JS 腳本；而分包則是根據pages.json的配置進行划分。
在小程序啟動時，默認會下載主包並啟動主包內頁面，當用戶進入分包內某個頁面時，會把對應分包自動下載下來，下載完成后再進行展示。
subPackages 里的pages的路徑是 root 下的相對路徑，不是全路徑。
各個小程序分包大小及其限制
| 小程序 | 分包大小限制 | 總體積限制 |
| 微信小程序 | 2M | 20M |
| 百度小程序 | 2M | 8M |
| 支付寶小程序 | 2M | 8M |
| QQ小程序 | 2M | 24M |
| 字節小程序 | 2M | 16M |
分包結構
┌─pages │─tab │ ├─index │ │ └─index.vue │ └─my │ └─my.vue ├─sub_my │ ├─img │ └─pages │ └─list │ └─list.vue ├─sub_intake │ ├─img │ └─pages │ └─detail │ └─detail.vue ├─static ├─main.js ├─App.vue ├─manifest.json └─pages.json └─vue.config.js
在 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": {
"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 個分包引用）
- 自定義組件：若某個自定義組件僅被一個分包引用時，且未放入到分包內，編譯時會輸出提示信息
分包內靜態文件示例
"subPackages": [{
"root": "pages/sub",
"pages": [{
"path": "index/index"
}]
}]
以上面的分包為例，放在每個分包root對應目錄下的靜態文件會被打包到此分包內。
自定義靜態資源目錄以及打包分包靜態資源合並
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'),
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