axmol/extensions/assets-manager/Manifest.h

251 lines
6.9 KiB
C
Raw Normal View History

2019-11-23 20:27:39 +08:00
/****************************************************************************
Copyright (c) 2013 cocos2d-x.org
Copyright (c) 2017-2018 Xiamen Yaji Software Co., Ltd.
2021-12-25 10:04:45 +08:00
https://axis-project.github.io/
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
****************************************************************************/
#ifndef __Manifest__
#define __Manifest__
#include <string>
#include <unordered_map>
#include <vector>
#include "extensions/ExtensionMacros.h"
#include "extensions/ExtensionExport.h"
#include "network/CCDownloader.h"
#include "platform/CCFileUtils.h"
2020-05-06 15:42:25 +08:00
#include "rapidjson/document-wrapper.h"
2019-11-23 20:27:39 +08:00
NS_AX_EXT_BEGIN
2019-11-23 20:27:39 +08:00
struct DownloadUnit
{
std::string srcUrl;
std::string storagePath;
std::string customId;
2021-12-25 10:04:45 +08:00
float size;
2019-11-23 20:27:39 +08:00
};
2021-12-25 10:04:45 +08:00
struct ManifestAsset
{
2019-11-23 20:27:39 +08:00
std::string md5;
std::string path;
bool compressed;
float size;
int downloadState;
};
typedef hlookup::string_map<DownloadUnit> DownloadUnits;
2019-11-23 20:27:39 +08:00
2022-07-16 10:43:05 +08:00
class AX_EX_DLL Manifest : public Ref
2019-11-23 20:27:39 +08:00
{
public:
friend class AssetsManagerEx;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
//! The type of difference
2021-12-25 10:04:45 +08:00
enum class DiffType
{
2019-11-23 20:27:39 +08:00
ADDED,
DELETED,
MODIFIED
};
2021-12-25 10:04:45 +08:00
enum DownloadState
{
2019-11-23 20:27:39 +08:00
UNSTARTED,
DOWNLOADING,
SUCCESSED,
UNMARKED
};
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
//! Asset object
typedef ManifestAsset Asset;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
//! Object indicate the difference between two Assets
2021-12-25 10:04:45 +08:00
struct AssetDiff
{
2019-11-23 20:27:39 +08:00
Asset asset;
DiffType type;
};
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
/** @brief Check whether the version informations have been fully loaded
*/
bool isVersionLoaded() const;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
/** @brief Check whether the manifest have been fully loaded
*/
bool isLoaded() const;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
/** @brief Gets remote package url.
*/
std::string_view getPackageUrl() const;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
/** @brief Gets remote manifest file url.
*/
std::string_view getManifestFileUrl() const;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
/** @brief Gets remote version file url.
*/
std::string_view getVersionFileUrl() const;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
/** @brief Gets manifest version.
*/
std::string_view getVersion() const;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
/** @brief Get the search paths list related to the Manifest.
*/
std::vector<std::string> getSearchPaths() const;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
protected:
/** @brief Constructor for Manifest class
* @param manifestUrl Url of the local manifest
*/
Manifest(std::string_view manifestUrl = "");
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
/** @brief Load the json file into local json object
* @param url Url of the json file
*/
void loadJson(std::string_view url);
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
/** @brief Parse the version file information into this manifest
* @param versionUrl Url of the local version file
*/
void parseVersion(std::string_view versionUrl);
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
/** @brief Parse the manifest file information into this manifest
* @param manifestUrl Url of the local manifest
*/
void parse(std::string_view manifestUrl);
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
/** @brief Check whether the version of this manifest equals to another.
* @param b The other manifest
* @return Equal or not
*/
2021-12-25 10:04:45 +08:00
bool versionEquals(const Manifest* b) const;
2019-11-23 20:27:39 +08:00
/** @brief Check whether the version of this manifest is greater than another.
* @param b The other manifest
* @param [handle] Customized comparasion handle function
* @return Greater or not
*/
bool versionGreater(const Manifest* b,
const std::function<int(std::string_view versionA, std::string_view versionB)>& handle) const;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
/** @brief Generate difference between this Manifest and another.
* @param b The other manifest
*/
hlookup::string_map<AssetDiff> genDiff(const Manifest* b) const;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
/** @brief Generate resuming download assets list
* @param units The download units reference to be modified by the generation result
*/
2021-12-25 10:04:45 +08:00
void genResumeAssetsList(DownloadUnits* units) const;
2019-11-23 20:27:39 +08:00
/** @brief Prepend all search paths to the FileUtils.
*/
void prependSearchPaths();
2021-12-25 10:04:45 +08:00
void loadVersion(const rapidjson::Document& json);
void loadManifest(const rapidjson::Document& json);
void saveToFile(std::string_view filepath);
2021-12-25 10:04:45 +08:00
Asset parseAsset(std::string_view path, const rapidjson::Value& json);
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
void clear();
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
/** @brief Gets all groups.
*/
const std::vector<std::string>& getGroups() const;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
/** @brief Gets all groups version.
*/
const hlookup::string_map<std::string>& getGroupVerions() const;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
/** @brief Gets version for the given group.
* @param group Key of the requested group
*/
std::string_view getGroupVersion(std::string_view group) const;
2021-12-25 10:04:45 +08:00
/**
2019-11-23 20:27:39 +08:00
* @brief Gets assets.
* @lua NA
*/
const hlookup::string_map<Asset>& getAssets() const;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
/** @brief Set the download state for an asset
* @param key Key of the asset to set
* @param state The current download state of the asset
*/
void setAssetDownloadState(std::string_view key, const DownloadState& state);
2021-12-25 10:04:45 +08:00
void setManifestRoot(std::string_view root) { _manifestRoot = root; };
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
private:
//! Indicate whether the version informations have been fully loaded
bool _versionLoaded;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
//! Indicate whether the manifest have been fully loaded
bool _loaded;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
//! Reference to the global file utils
2021-12-25 10:04:45 +08:00
FileUtils* _fileUtils;
2019-11-23 20:27:39 +08:00
//! The local manifest root
std::string _manifestRoot;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
//! The remote package url
std::string _packageUrl;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
//! The remote path of manifest file
std::string _remoteManifestUrl;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
//! The remote path of version file [Optional]
std::string _remoteVersionUrl;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
//! The version of local manifest
std::string _version;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
//! All groups exist in manifest [Optional]
std::vector<std::string> _groups;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
//! The versions of all local group [Optional]
hlookup::string_map<std::string> _groupVer;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
//! The version of local engine
std::string _engineVer;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
//! Full assets list
hlookup::string_map<Asset> _assets;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
//! All search paths
std::vector<std::string> _searchPaths;
2021-12-25 10:04:45 +08:00
2019-11-23 20:27:39 +08:00
rapidjson::Document _json;
};
NS_AX_EXT_END
2019-11-23 20:27:39 +08:00
#endif /* defined(__Manifest__) */