文档开发者中心
我的

快游戏中使用分包加载没有进度回调解决方案

现象描述

打包开发的快游戏,使用华为分包加载能力,分包加载成功,监听加载分包的回调,但是一直没有回调信息,原因出在哪里?下面我们来一步步探索。

分包代码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代码已经下载成功了,但是日志里一直未监听到下载进度的回调。只有如下日志:

1.png

一直没有走到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); } }

上架后打印的日志出现了进度条回调信息,日志如下:

2.png

解决方案

分包进度条onprogress出现的条件是,按照华为分包要求正常分包并上架华为应用市场。由华为服务器进行拆包后,才会存在下载行为,触发分包下载进度条监听回调。本地快应用加载器因为没有拆包过程,所以不会有下载分包js代码行为,自然也无下载进度回调。

总结

分包问题,我们可以从分包代码qg.loadSubPackage,分包本身资源文件,以及加载分包代码和其引用代码来以及是否上架来分析。结合相应报错日志,从而一步步找出是哪一处报错。

欲了解更多详情,请参见:

分包加载指南:

https://developer.huawei.com/consumer/cn/doc/development/quickApp-Guides/quickgame-develop-base#h1-1580782942353

点赞
收藏
回复
1
分享
举报
浏览446 编辑于2021-06-26 03:32未知归属地
全部评论
最多点赞
最新发布
最早发布
昨天还看到有人问这个问题了,我去回复他下
1楼回复于2021-06-30 03:54 未知归属地
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

目录 收起
现象描述
问题分析
解决方案
总结
了解社区公约,与您携手共创和谐专业的开发者社区。