热更新的思路:
玩家一启动游戏时,将客户端资源的版本与服务器进行比对,如果客户端版本低于服务端版本,则下载最新的资源,并将客户端的资源版本更新至服务端的版本。由于我们没有对打包出来的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
-
@H_404_72@1
@H_404_72@2
@H_404_72@3
@H_404_72@4
@H_404_72@5
@H_404_72@6
@H_404_72@7
@H_404_72@8
@H_404_72@9
@H_404_72@10
@H_404_72@11
@H_404_72@12
@H_404_72@13
@H_404_72@14
@H_404_72@15
@H_404_72@16
@H_404_72@17
@H_404_72@18
@H_404_72@19
@H_404_72@20
@H_404_72@21
@H_404_72@22
@H_404_72@23
@H_404_72@24
@H_404_72@25
@H_404_72@26
@H_404_72@27
@H_404_72@28
@H_404_72@29
@H_404_72@30
@H_404_72@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();
}
}
-
@H_404_72@1
@H_404_72@2
@H_404_72@3
@H_404_72@4
@H_404_72@5
@H_404_72@6
@H_404_72@7
@H_404_72@8
@H_404_72@9
@H_404_72@10
@H_404_72@11
@H_404_72@12
@H_404_72@13
@H_404_72@14
@H_404_72@15
@H_404_72@16
@H_404_72@17
@H_404_72@18
@H_404_72@19
@H_404_72@20
@H_404_72@21
@H_404_72@22
@H_404_72@23
@H_404_72@24
@H_404_72@25
@H_404_72@26
@H_404_72@27
@H_404_72@28
@H_404_72@29
@H_404_72@30
@H_404_72@31
@H_404_72@32
@H_404_72@33
@H_404_72@34
@H_404_72@35
@H_404_72@36
@H_404_72@37
@H_404_72@38
@H_404_72@39
@H_404_72@40
@H_404_72@41
@H_404_72@42
@H_404_72@43
@H_404_72@44
@H_404_72@45
@H_404_72@46
@H_404_72@47
@H_404_72@48
@H_404_72@49
@H_404_72@50
@H_404_72@51
@H_404_72@52
@H_404_72@53
@H_404_72@54
@H_404_72@55
@H_404_72@56
@H_404_72@57
@H_404_72@58
@H_404_72@59
@H_404_72@60
@H_404_72@61
@H_404_72@62
@H_404_72@63
@H_404_72@64
@H_404_72@65
@H_404_72@66
@H_404_72@67
@H_404_72@68
@H_404_72@69
@H_404_72@70
@H_404_72@71
@H_404_72@72
@H_404_72@73
@H_404_72@74
@H_404_72@75
@H_404_72@76
@H_404_72@77
@H_404_72@78
@H_404_72@79
@H_404_72@80
@H_404_72@81
@H_404_72@82
@H_404_72@83
@H_404_72@84
@H_404_72@85
@H_404_72@86
@H_404_72@87
@H_404_72@88
@H_404_72@89
@H_404_72@90
@H_404_72@91
@H_404_72@92
@H_404_72@93
@H_404_72@94
@H_404_72@95
@H_404_72@96
@H_404_72@97
@H_404_72@98
@H_404_72@99
@H_404_72@100
@H_404_72@101
@H_404_72@102
@H_404_72@103
@H_404_72@104
@H_404_72@105
@H_404_72@106
@H_404_72@107
@H_404_72@108
@H_404_72@109
@H_404_72@110
@H_404_72@111
@H_404_72@112
@H_404_72@113
@H_404_72@114
@H_404_72@115
@H_404_72@116
@H_404_72@117
@H_404_72@118
@H_404_72@119
@H_404_72@120
@H_404_72@121
@H_404_72@122
@H_404_72@123
@H_404_72@124
@H_404_72@125
@H_404_72@126
@H_404_72@127
@H_404_72@128
@H_404_72@129
@H_404_72@130
@H_404_72@131
@H_404_72@132
@H_404_72@133
@H_404_72@134
@H_404_72@135
@H_404_72@136
@H_404_72@137
@H_404_72@138
@H_404_72@139
@H_404_72@140
@H_404_72@141
@H_404_72@142
@H_404_72@143
@H_404_72@144
@H_404_72@145
@H_404_72@146
@H_404_72@147
@H_404_72@148
@H_404_72@149
@H_404_72@150
@H_404_72@151
@H_404_72@152
@H_404_72@153
@H_404_72@154
@H_404_72@155
@H_404_72@156
@H_404_72@157
@H_404_72@158
@H_404_72@159
@H_404_72@160
@H_404_72@161
@H_404_72@162
@H_404_72@163
@H_404_72@164
@H_404_72@165
@H_404_72@166
@H_404_72@167
@H_404_72@168
@H_404_72@169
@H_404_72@170
@H_404_72@171
@H_404_72@172
@H_404_72@173
@H_404_72@174
以上就是Update类的所有代码,Update类主要方法只有3个,6个变量。
方法:
startDownloadCallback() 按下开始下载时的操作。
init() 初始化。
onLoadEnd() 下载结束后。
变量:
_testIndex 配置文件与存储路径的下标。
_loadLayer 展示层。
_downloadMenu menu控件。
_am AssetsManagerEx对象。
_progress 显示进度的Label。
_amListener EventListenerAssetsManagerEx对象(创建下载线程在这里面进行)。
实践证明,改热更新只能下载少量的资源,一旦要更新的资源比较大,则很大几率会出现下载超时,导致下载失败。