随着小游戏开发的日益精进，游戏本身的包体也越来越大，官方开始制定的4M包体，已经开始不能满足要求，微信官方也早早为开发者做了准备，给出了小游戏分包方案，本身分包功能官方文档已经写的很详细，只要照着做，基本都能实现，只是我在Laya2.0的版本实践中，还是遇到了一些坑和一些注意事项。

分包环境

微信 6.6.7 客户端，2.1.0 及以上基础库开始支持，请更新至最新客户端版本，开发者工具请使用 1.02.1806120 及以上版本，可点此下载

分包限制

• 整个小游戏所有分包大小不超过 8M
• 单个分包/主包大小不能超过 4M

使用方法

首先我们需要在game.js中配置分包的路径

{
  "deviceOrientation": "portrait",
  "showStatusBar": false,
  "networkTimeout": {
    "request": 10000,
    "connectSocket": 10000,
    "uploadFile": 10000,
    "downloadFile": 10000
  },
  "subpackages": [
    {
      "name": "res",
      "root": "subpackage/"
    }, {
      "name": "subinit",
      "root": "subinit.js"
    }
  ]
}

比如我上面配置的路径有两个一个subpackage文件夹 一个是subinit.js，为了方便后期的更新，建议不要过早的把一些功能代码，放到分包下面，这样会造成拓展维护更新带来的很多麻烦。

代码里面我们设置一下分包的路径和名字

ResManager.ins.subPackage = [
                               {"name": "res", "root": "subpackage/"},
                               {"name": "subinit", "root": "subinit.js"}
                           ];
                           this.loadSubpackages();

loadSubpackages 方法如下

private loadSubpackages() {
        let packages = ResManager.ins.subPackage, count: number = 0;
        if (!packages.length) {
            console.log(JSON.stringify("分包已经加载成功"));
            this.bar.changeHandler.clear();
            this.event(LoadingView.LOAD_COMPLETE);
            return;
        }
        let url = packages.shift()["name"];
        let loadTask = window.platform.ins.loadSubpackage({
            name: url, // name 可以填 name 或者 root
            success: function (res) {
                // 分包加载成功后通过 success 回调
                // console.log("loadSubpackage:" + JSON.stringify("success"));
                LoadingView.loadSub();
            },
            fail: function (res) {
                // 分包加载失败通过 fail 回调
            },
            complete: function (res) {
            }
        });
        loadTask.onProgressUpdate((res) => {
            console.log('下载进度', res.progress);
            // console.log('已经下载的数据长度', res.totalBytesWritten);
            // console.log('预期需要下载的数据总长度', res.totalBytesExpectedToWrite)
        })
    }

老版本兼容

因为分包功能不是所有的微信版本都具有的，所有有需要的，需要做版本兼容

由微信后台编译来处理旧版本客户端的兼容，后台会编译两份代码包，一份是分包后代码，另外一份是整包的兼容代码。对于老客户端，会去下载整包代码启动。

开发者在基础库 2.1.0 以下的版本不需要调用 wx.loadSubpackage 触发加载，2.1.0 以下版本不存在 wx.loadSubpackage 方法。

老版本下，需要开发者调用 require 触发分包入口文件的加载，例如：

require('stage1/game.js')

微信 6.6.7 以下客户端开发版/体验版因历史兼容问题无法打开分包小游戏，正式发布版不受影响。如果不打算兼容老版本，开发者可以通过 mp 小程序后台配置端屏蔽 2.1.0 以下基础版的用户。

后记

本身分包没有什么难度，我自己仅仅把一些素材放到了分包下面，但是有些素材我在分包下面后续无法取出，可能是因为后缀名问题（本人猜测），例如我用的laya的粒子配置文件后缀名为.part无法在分包里正常加载和获取。

另外需要注意的是，一旦一个文件夹设置为分包，他的子文件夹或者子文件，不能再次被设置为子包，否则也无法加载成功。