cocos2d-x 3.10 热更新 使用AssetsManagerEx

热更新的思路：

玩家一启动游戏时，将客户端资源的版本与服务器进行比对，如果客户端版本低于服务端版本，则下载最新的资源，并将客户端的资源版本更新至服务端的版本。由于我们没有对打包出来的APK中的资源有写的权限，所以我们需要将下载下来的资源放在一个可以读写的路径中，并添加这个路径至搜索路径，且优先级要高于默认的搜索路径。

在3.10 官方例子中，cocos使用了AssetsManagerEx 来代替原先的AssetsManager来实现热更新。 使用AssetsManagerEx只需配置一个Manifest文件即可。

Manifest文件中主要包含：下载资源包路径、远程Manifest配置文件路径、远程版本号路径，当前版本号。
以下是Manifest文件的格式

{
"packageUrl" : "http://180.150.177.134/download/Parkour/","remoteManifestUrl" : "http://180.150.177.134/download/Parkour/Manifest/project.manifest","remoteVersionUrl" : "http://180.150.177.134/download/Parkour/version.manifest","version" : "1.0.0","engineVersion" : "3.0 beta","assets" : {
    "Images/background.png" : {
        "md5" : "..."
    }
},"searchPaths" : [
]

}

下载完成后，资源会放在对应的路径下

好了，废话了一大堆，接下来让我们来看代码的实现。

我们只需要一个Update来就可以实现了

Update.h如下

#ifndef __Update_H__
#define __Update_H__

#include "cocos2d.h"
#include "cocos-ext.h"

class Update : public cocos2d::Scene
{
public:
    static Update* create(int testIndex); //根据下标设置不同的配置文件与存储路径

    Update(int testIndex);

    void startDownloadCallback(cocos2d::Ref* sender); // 按下开始下载时的操作

    virtual bool init() override;

private:
    int _testIndex;
    cocos2d::Layer* _loadLayer;
    cocos2d::Menu* _downloadMenu;

    cocos2d::extension::AssetsManagerEx* _am;
    cocos2d::Label* _progress;
    cocos2d::extension::EventListenerAssetsManagerEx* _amListener;

    void onLoadEnd(); // 下载结束后
};

#endif

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21
• 22
• 23
• 24
• 25
• 26
• 27
• 28
• 29
• 30
• 31

Update.cpp如下

#include "Update.h"

USING_NS_CC;
USING_NS_CC_EXT;

const char* sceneManifests[] = { "AMTestScene1/project.manifest","AMTestScene2/project.manifest",0);">"AMTestScene3/project.manifest" };
const char* storagePaths[] = { "CppTests/AssetsManagerExTest/scene1/",0);">"CppTests/AssetsManagerExTest/scene2/",0);">"CppTests/AssetsManagerExTest/scene3" };
const char* backgroundPaths[] = { "Images/assetMgrBackground1.jpg",0);">"Images/assetMgrBackground2.png",0);">"Images/assetMgrBackground3.png" };

Update* Update::create(int testIndex){
    auto scene = new (std::nothrow) Update(testIndex);
    if (scene && scene->init())
    {
        scene->autorelease();
    }
    else
    {
        delete scene;
        scene = nullptr;
    }

    return scene;
}

Update::Update(int testIndex)
: _testIndex(testIndex),_loadLayer(nullptr),_downloadMenu(nullptr),_progress(nullptr)
{

}

bool Update::init()
{
    if (!Scene::init())
    {
        return false;
    }
    Size visibleSize = Director::getInstance()->getVisibleSize();

    // 创建按钮组件
    auto downloadLabel = Label::createWithTTF("Start Download",0);">"fonts/arial.ttf",16);
    auto downloadItem = MenuItemLabel::create(downloadLabel,CC_CALLBACK_1(Update::startDownloadCallback,this));
    downloadItem->setPosition(Vec2(visibleSize.width / 2,102);">100));
    _downloadMenu = Menu::create(downloadItem,nullptr);
    _downloadMenu->setPosition(Vec2::ZERO);
    this->addChild(_downloadMenu,102);">1);

    _loadLayer = Layer::create();
    addChild(_loadLayer);

    auto sprite = Sprite::create("Images/Icon.png");
    _loadLayer->addChild(sprite);
    sprite->setPosition(visibleSize.width / 2);

    TTFConfig config("fonts/tahoma.ttf",102);">30);
    _progress = Label::createWithTTF(config,0);">"0%",TextHAlignment::CENTER);
    _progress->setPosition(Vec2(visibleSize.width / 2) + 50));
    _loadLayer->addChild(_progress);

    // 根据资源配置文件与存储路径，创建AssetsManagerEx
    std::string manifestPath = sceneManifests[_testIndex],storagePath = FileUtils::getInstance()->getWritablePath() + storagePaths[_testIndex];
    CCLOG("Storage path for this test : %s",storagePath.c_str());
    _am = AssetsManagerEx::create(manifestPath,storagePath);
    _am->retain();

    true;
}

void Update::onLoadEnd()
{
    removeChild(_loadLayer,true);
    _loadLayer = nullptr;

}

// 开始下载资源
void Update::startDownloadCallback(Ref* sender)
{
    removeChild(_downloadMenu);
    _downloadMenu = nullptr;

    if (!_am->getLocalManifest()->isLoaded()) { CCLOG("Fail to update assets,step skipped."); onLoadEnd(); } else { int testIndex = _testIndex; _amListener = cocos2d::extension::EventListenerAssetsManagerEx::create(_am,[testIndex,136);">this](EventAssetsManagerEx* event){ static int failCount = 0; switch (event->getEventCode()) { case EventAssetsManagerEx::EventCode::ERROR_NO_LOCAL_MANIFEST: { CCLOG("No local manifest file found,skip assets update."); this->onLoadEnd(); } break; case EventAssetsManagerEx::EventCode::UPDATE_PROGRESSION: { std::string assetId = event->getAssetId(); float percent = event->getPercent(); std::string str; if (assetId == AssetsManagerEx::VERSION_ID) { str = StringUtils::format("Version file: %.2f",percent) + "%"; } else if (assetId == AssetsManagerEx::MANIFEST_ID) { str = StringUtils::format("Manifest file: %.2f",136);">else { str = StringUtils::format("%.2f",0);">"%"; CCLOG("%.2f Percent",percent); } if (this->_progress != nullptr) this->_progress->setString(str); } break; case EventAssetsManagerEx::EventCode::ERROR_DOWNLOAD_MANIFEST: case EventAssetsManagerEx::EventCode::ERROR_PARSE_MANIFEST: { CCLOG("Fail to download manifest file,update skipped."); break; case EventAssetsManagerEx::EventCode::ALREADY_UP_TO_DATE: case EventAssetsManagerEx::EventCode::UPDATE_FINISHED: { CCLOG("Update finished. %s",event->getMessage().c_str()); break; case EventAssetsManagerEx::EventCode::UPDATE_FAILED: { CCLOG("Update failed. %s",event->getMessage().c_str()); failCount++; if (failCount < 5) { _am->downloadFailedAssets(); } else { CCLOG("Reach maximum fail count,exit update process"); failCount = this->onLoadEnd(); } } break; case EventAssetsManagerEx::EventCode::ERROR_UPDATING: { CCLOG("Asset %s : %s",event->getAssetId().c_str(),event->getMessage().c_str()); } break; case EventAssetsManagerEx::EventCode::ERROR_DECOMPRESS: { CCLOG("%s",136);">break; default: break; } }); Director::getInstance()->getEventDispatcher()->addEventListenerWithFixedPriority(_amListener,102);">1);

        _am->update();
    }

}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21
• 22
• 23
• 24
• 25
• 26
• 27
• 28
• 29
• 30
• 31
• 32
• 33
• 34
• 35
• 36
• 37
• 38
• 39
• 40
• 41
• 42
• 43
• 44
• 45
• 46
• 47
• 48
• 49
• 50
• 51
• 52
• 53
• 54
• 55
• 56
• 57
• 58
• 59
• 60
• 61
• 62
• 63
• 64
• 65
• 66
• 67
• 68
• 69
• 70
• 71
• 72
• 73
• 74
• 75
• 76
• 77
• 78
• 79
• 80
• 81
• 82
• 83
• 84
• 85
• 86
• 87
• 88
• 89
• 90
• 91
• 92
• 93
• 94
• 95
• 96
• 97
• 98
• 99
• 100
• 101
• 102
• 103
• 104
• 105
• 106
• 107
• 108
• 109
• 110
• 111
• 112
• 113
• 114
• 115
• 116
• 117
• 118
• 119
• 120
• 121
• 122
• 123
• 124
• 125
• 126
• 127
• 128
• 129
• 130
• 131
• 132
• 133
• 134
• 135
• 136
• 137
• 138
• 139
• 140
• 141
• 142
• 143
• 144
• 145
• 146
• 147
• 148
• 149
• 150
• 151
• 152
• 153
• 154
• 155
• 156
• 157
• 158
• 159
• 160
• 161
• 162
• 163
• 164
• 165
• 166
• 167
• 168
• 169
• 170
• 171
• 172
• 173
• 174

以上就是Update类的所有代码，Update类主要方法只有3个，6个变量。
方法：
startDownloadCallback() 按下开始下载时的操作。
init() 初始化。
onLoadEnd() 下载结束后。

变量：
_testIndex 配置文件与存储路径的下标。
_loadLayer 展示层。
_downloadMenu menu控件。
_am AssetsManagerEx对象。
_progress 显示进度的Label。
_amListener EventListenerAssetsManagerEx对象(创建下载线程在这里面进行)。

实践证明，改热更新只能下载少量的资源，一旦要更新的资源比较大，则很大几率会出现下载超时，导致下载失败。

（编辑：李大同）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!