mt.loadSubpackage(Object options)

触发分包的下载和加载。

支持情况

项	说明
兼容性	部分兼容

参数

Object options

属性	类型	默认值	必填	说明
name	string	—	是	分包的名称，对应 game.json 中 subpackages 配置的 name
waiterMode	boolean	false	否	是否以同步等待模式加载分包；true 时加载在调用线程中同步完成（美团小游戏特有参数）
success	function	—	否	加载成功回调
fail	function	—	否	加载失败回调
complete	function	—	否	完成回调（成功或失败均触发）

返回值

LoadSubpackageTask — 分包加载任务实例。

注意事项

• waiterMode: true 时，分包加载在当前调用中同步完成，返回的 task.await() 会立即执行完毕。微信无此参数。

示例代码

// 普通异步加载
const task = mt.loadSubpackage({
  name: 'sub1',
  success() { console.log('分包加载成功') },
  fail(err) { console.error(err.errMsg) }
})
task.onProgressUpdate((res) => {
  console.log('加载进度:', res.progress)
})

// waiterMode 同步加载
const task2 = mt.loadSubpackage({ name: 'sub2', waiterMode: true })
task2.await() // 同步等待加载完成
console.log('分包已就绪')

与微信差异

• 新增 waiterMode 参数（boolean），设为 true 时在调用线程中同步完成分包加载；微信无此参数。