51工具盒子

依楼听风雨
笑看云卷云舒,淡观潮起潮落

uniapp分包

当众人都哭时,应该允许有的人不哭。当哭成为一种表演时,更应该允许有的人不哭。------莫言

我们在使用uniapp进行微信小程序开发时可能会遇到如下情况:

image-20211104160028042

这是因为微信小程序官方文档提到:

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

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

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

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

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

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

此时可以进行简单的静态资源处理,将static目录下的图片之类的压缩或者放到在线图床上

如果在这样处理后还是提示超过2M

那么我们就进行分包

按照uniapp官方文档提到的,我们首先先将目录分出来:

例如我之前的pages.json为:

|---------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 | hljs json { "pages": [ //pages数组中第一项表示应用启动页,参考:https://uniapp.dcloud.io/collocation/pages { "path": "pages/index/index", "style": { "navigationBarTitleText": "uni-app" } }, { "path": "pages/news/list", "style": { "navigationBarTitleText": "news-list", "enablePullDownRefresh": false } }, { "path": "page/user/list", "style": { "navigationBarTitleText": "user-list", "enablePullDownRefresh": false } } ], "globalStyle": { "navigationBarTextStyle": "black", "navigationBarTitleText": "uni-app", "navigationBarBackgroundColor": "#F8F8F8", "backgroundColor": "#F8F8F8" } } |

对应的目录为:

|------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 1 2 3 4 5 6 7 8 9 10 11 12 | hljs json ┌─pages │ ├─index │ │ └─index.nvue │ ├─news │ │ └─list.nvue │ └─user │ └─list.nvue ├─static ├─main.js ├─App.vue ├─manifest.json └─pages.json |

我们将其改为如下目录:

|------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 | hljs json ┌─pages │ ├─index │ └─index.nvue ├─pages-user │ ├─static │ └─list.nvue ├─pages-news │ ├─static │ └─list.nvue ├─static ├─main.js ├─App.vue ├─manifest.json └─pages.json |

这里pages-userpages-news就是我们的子包,我们将只有子包对应用到的静态文件放到子包的static

然后我们将pages.json改为:

|------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 | hljs json { "pages": [ //pages数组中第一项表示应用启动页,参考:https://uniapp.dcloud.io/collocation/pages { "path": "pages/index/index", "style": { "navigationBarTitleText": "uni-app" } } ], "subPackages": [{ "root": "pages-user", "pages": [{ "path": "list", "style": { "navigationBarTitleText": "user-list", "enablePullDownRefresh": false } }] }, { "root": "pages-news", "pages": [{ "path": "list", "style": { "navigationBarTitleText": "news-list", "enablePullDownRefresh": false } }] }], "globalStyle": { "navigationBarTextStyle": "black", "navigationBarTitleText": "uni-app", "navigationBarBackgroundColor": "#F8F8F8", "backgroundColor": "#F8F8F8" } } |

主要就是将子包中的页面,放到了subPackages下对应的子包配置中,以及配置了根路径root,再修改具体的路径

改完后,在页面中写的navigator跳转路径也要进行相应的修改

例如我这里:

|-------------|---------------------------------------------------------------------------------------------------------------------------------| | 1 2 | hljs vue <navigator url="/pages-user/list">user-list</navigator> <navigator url="/pages-news/list">news-list</navigator> |

要注意,子包下的静态资源,在小程序上是不可共享的

image-20211104162009686

赞(0)
未经允许不得转载:工具盒子 » uniapp分包