cocosCreator 3.3~6 安卓热更新官方详细示例

news2024/7/6 18:11:59

官方的热更新虽给出了示例和源码，但是一些细节的地方和步骤还是没说清楚，导致新手包括我死活是运行不起来，热更新失败！很打击人啊。这里有必要给出新手的热更新步骤，前提是你安装了Node.js和python环境，我装的都是最新的，node.js是 v16.16， python是3.10.5, 针对cocosCreator3.3到3.6都是兼容的。

热更新的步骤是1.先打包一个原始包安装到手机上，手机里的version.manifest的版本号是低一些的。2 再构建一个高版本的包，用 version_generator.js生成新构建的assets下目录的md5码和路径，并且版本号要升一位，然后把新构建的assets下目录文件拷到服务器上，打开服务器原来的手机就可以检测热更新了。

1. 服务器端代码，用Node.js写一个最简单方便的服务器，我个人不喜欢用python，Node.js简单易懂。服务器代码很简单，就一个webServer.js文件，服务器是用express一句话搭建的，如下：

var express = require("express");
var path = require("path");
var fs  = require("fs");

var app = express();

//设置跨域访问
app.all('*', function(req, res, next) {
	res.header("Access-Control-Allow-Origin", "*");
	res.header("Access-Control-Allow-Headers", "X-Requested-With");
	res.header("Access-Control-Allow-Methods","PUT,POST,GET,DELETE,OPTIONS");
	res.header("X-Powered-By",' 3.2.1');
	res.header("Content-Type", "application/json;charset=utf-8");
	next();
});

//设置静态访问目录
if(fs.existsSync("remote-assets")) {
    app.use(express.static(path.join(process.cwd(), "remote-assets")));
}
else {
    console.log("remote-assets is not exists!!!!");
}

var port = 5502;  //监听端口
//下面这段代码无用，可以无视
app.get("/server_info", function(request, response) {
    var data = {
        host:"127.0.0.1",
        port: 5502,
    };
    var str_data = JSON.stringify(data);
    response.send(str_data);
});

app.listen(port);

这里设置了资源静态访问目录，所以后面的packageUrl可以不用加remote_assets目录了。

2. 客户端代码，完全抄官方示例，为了显示热更新效果，加个图片如下：

3. 然后用官方示例工程根目录下的 version_generator.js生成差异文件列表和版本号文件，这里的version_generator.js需要修改一下，不可直接使用，因为这个文件是按官方自己的示例工程配置的，我们要改成自己的，如下

注意开头那个var manifest，如图所示，packageUrl包括下面的两个路径官方写的都是

'http://localhost/tutorial-hot-update/remote-assets/', 这是不对的，这是官方自己的服务器设置，而且那个localhost显然不合理，要使用明确的IP地址，这就是新手运行官方示例死活不成功的原因，第一步就错了当然热更新不了，改成我们自己的地址：http://192.168.10.5:5502/，因为我自己电脑的IP地址是192.168.10.5, 刚才服务器监听端口号是5502，又设置了网站根目录下的remote-assets目录为可以直接访问的静态文件目录，也就是说所有在remote-assets目录下的文件都可以直接用 http://192.168.10.5:5502/文件名 http://192.168.10.5:5502/

形式访问，所以不用再显示把remote-assets目录写出来了，服务器文件结构如下图：

后面把热更新的文件直接丢到remote-assets里就行了

现在，要生成个旧包，要两次构建，这也是官方文档没详细说的地方，第一次构建，生成包的资源安卓文件，然后version_generator生成旧包里的project.manifest(旧文件md5码和路径列表) 和version.manifest（旧文件的版本信息）

先安卓构建，这个没什么好说的，下好android sdk和ndk，安装好android studio 我用的是4.0版，当然最新的也可以，不会安卓打包的请查阅我之前写的文章。，配置如下图

这里基本不用改啥，照着我的构建配置设置就行了，然后点击构建，先别生成，这里的构建目的是为了生成安卓的资源目录结构，如下图：

我们的安卓资源文件全在那个assets目录里，马上热更新的内容就是这个目录里的所有文件。

有了旧包的安卓资源目录，现在可以用version_generator.js生成旧包的project.manifest和version.manifest文件了，针对我们现在的项目目录结构，在cmd控制台里敲入如下命令：

node version_generator.js -v 1.0.0 http://192.168.10.5:5502/ -s build/android\assets -d remote-assets/

这里主要有三个设置

-v:设置目前包的版本号，因为现在是要更新的旧包，所以版本号低一些，是1.0.0

http://192.168.10.5:5502/ 这个是远端的服务器的热更新地址，实测这里设了也没用，因为前面说了，实际上生成的是version_generator开头那段代码里设置的packageUrl等地址的内容，要改那里才有效，不知道是不是官方这个文件写的有问题还是我哪里没设对，恳请知道的大神告知一下。

-s build/android\assets 本地安卓资源所在的路径，一般就是这个地址

-d remote-assets/ 生成的两个文件，project.manifest和 version.manifest生成后所存放的目录，这里我们在工程的根目录下新建个remote-assets目录，马上生成后两文件就会存放在这里，如下图：

敲入命令，如下，生成成功：

这里remote-assets的两个文件要替换掉assets根目录下的project.manifest和version.manifest两个文件，因为原始的那两个文件配置不对，如下：

这两个文件要用刚生成的替换。

因为assets里替换了这两个文件，这两个文件也是游戏里的资源，所以要再重新构建一次，把这两个新配置文件打到包里，点击构建，构建完成后再点击生成，当然你可以用Android studio生成包，也可以直接用cocosCreator生成包体，生成后的包体在如下路径(cocosCreator生成路径，android studio生成的不在这个路径) 推荐大家用android studio生成包，流程上更正规，可以定制你的图标游戏名称，可以看到你折安卓工程代码，作一些接入SDK的工作，这里我们为了图省事方便还是用Creator生成包