快游戏中使用分包加载没有进度回调解决方案
现象描述
打包开发的快游戏,使用华为分包加载能力,分包加载成功,监听加载分包的回调,但是一直没有回调信息,原因出在哪里?下面我们来一步步探索。
分包代码loadSubpackages和分包进度条代码onprogress如下:
console.log("开始加载分包代码"); var sysInfo = qg.getSystemInfoSync(); var obj = {}; if (typeof qg.loadSubpackage == "function") { var subTask2 = qg.loadSubpackage({ // manifest.json中配置的子包包名 subpackage: "stage2", // 子包加载成功回调 success: function () { console.log("加载分包2成功!"); }, fail: function () { console.log("加载分包2失败"), callback2(false); } }) subTask2.onprogress = function callback(res) { console.log("进入onprogress,function",progback); if (typeof progback == "function") { console.log("onprogress2" + JSON.stringify(res)); progback(res, 2); } } setTimeout(() => { var subTask1 = qg.loadSubpackage({ // manifest.json中配置的子包包名 subpackage: "stage1", // 子包加载成功回调 success: function (res) { console.log("加载分包1成功!"); }, fail: function (res) { console.log("加载分包1失败"), callback2(false); } }) subTask1.onprogress = function callback(res) { if (typeof progback == "function") { console.log("onprogress1" + JSON.stringify(res)); progback(res, 1); } } }, 200);问题分析
我们都知道,游戏正常运行,说明分包下载的js代码已经下载成功了,但是日志里一直未监听到下载进度的回调。只有如下日志:

一直没有走到onprogress回调,详细看日志只有fail to registerLoadSubpackageTask, the js callback has already consumed这段日志。
下面我们根据引擎相关代码判断。引擎在加载进度条回调的代码中有如下逻辑:如果分包是空的或者callback里没有分包了则会打印fail to registerLoadSubpackageTask错误日志。
继续看引擎代码,执行分包代码如果出现this is normal rpk, just return success,引擎就直接return出去,不会触发下面的进度条回调了。
据此我们分析,进度条代码,引擎是存在且是ok的,那触发的条件是什么?那么我开发一个快游戏,确实进行了分包,分包后为什么直接当作一个正常的rpk 去return掉了,而不是触发进度条回调呢?
我们先来看下这2个概念。什么是分包,什么是远程包,什么是小包?
下面以rpk为例做讲解:
分包:rpk项目结构中subpackages里的内容。
小包或远程包:rpk中某些“非js代码文件”的资源包放在自己的远程服务器上,达到减少rpk体积。
这样理解,就会有一个很明显的区分:资源文件和js代码文件。
包体是否带有 js 文件是个关键,js 因为是动态语言,所以非常容易被串改(有可能导致你审核和实际运行上是不一样的游戏),所以有分包、小包(或者说远程包)的概念。因此,出于安全考虑,华为快游戏、快应用的分包subpackage内容都是存储在华为服务器上,以防止被恶意修改。而资源文件是需要开发者放到自己的服务器上。
华为快应用、快游戏的分包是依赖华为服务器,笼统来说拥有分包功能的rpk,上架华为应用市场后会被服务器拆成一个主包和多个分包。上架后玩家打开的是一个主包,在进入某些关卡时,如果触发分包A,才会下载分包A中代码,触发进度条回调。
未上架的rpk包,在快应用加载器中本地测试时,由于没有经过华为服务器,rpk没有拆包这个过程,分包代码直接是处于rpk内,所以直接走this is normal rpk, just return success不会触发分包。
以下是rpk中关于分包的代码:
subTask2.onprogress = function callback(res) { console.log("进入onprogress,function",progback); if (typeof progback == "function") { console.log("onprogress2" + JSON.stringify(res)); progback(res, 2); } }上架后打印的日志出现了进度条回调信息,日志如下:

解决方案
分包进度条onprogress出现的条件是,按照华为分包要求正常分包并上架华为应用市场。由华为服务器进行拆包后,才会存在下载行为,触发分包下载进度条监听回调。本地快应用加载器因为没有拆包过程,所以不会有下载分包js代码行为,自然也无下载进度回调。
总结
分包问题,我们可以从分包代码qg.loadSubPackage,分包本身资源文件,以及加载分包代码和其引用代码来以及是否上架来分析。结合相应报错日志,从而一步步找出是哪一处报错。
欲了解更多详情,请参见:
分包加载指南:
https://developer.huawei.com/consumer/cn/doc/development/quickApp-Guides/quickgame-develop-base#h1-1580782942353
- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要发帖子






































苏公安网备 32011402010933号