2012-04-19 14:35:52 +08:00
|
|
|
/****************************************************************************
|
2014-01-07 11:25:07 +08:00
|
|
|
Copyright (c) 2010-2012 cocos2d-x.org
|
2018-01-29 16:25:32 +08:00
|
|
|
Copyright (c) 2013-2016 Chukong Technologies Inc.
|
|
|
|
Copyright (c) 2017-2018 Xiamen Yaji Software Co., Ltd.
|
2012-04-19 14:35:52 +08:00
|
|
|
|
|
|
|
http://www.cocos2d-x.org
|
|
|
|
|
|
|
|
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:
|
|
|
|
|
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
|
|
all copies or substantial portions of the Software.
|
|
|
|
|
|
|
|
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.
|
|
|
|
****************************************************************************/
|
2015-03-24 20:23:51 +08:00
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
#ifndef __SUPPORT_ZIPUTILS_H__
|
|
|
|
#define __SUPPORT_ZIPUTILS_H__
|
2015-03-24 20:23:51 +08:00
|
|
|
/// @cond DO_NOT_SHOW
|
2012-04-19 14:35:52 +08:00
|
|
|
|
2012-11-08 19:46:53 +08:00
|
|
|
#include <string>
|
2014-09-10 08:17:07 +08:00
|
|
|
#include "platform/CCPlatformConfig.h"
|
|
|
|
#include "platform/CCPlatformMacros.h"
|
2014-09-10 07:50:02 +08:00
|
|
|
#include "platform/CCPlatformDefine.h"
|
2016-05-04 09:21:35 +08:00
|
|
|
#include "platform/CCFileUtils.h"
|
2012-11-08 19:46:53 +08:00
|
|
|
|
2013-06-18 17:10:54 +08:00
|
|
|
#if (CC_TARGET_PLATFORM == CC_PLATFORM_ANDROID)
|
2014-09-10 07:50:02 +08:00
|
|
|
#include "platform/android/CCFileUtils-android.h"
|
2015-05-09 00:19:13 +08:00
|
|
|
#elif(CC_TARGET_PLATFORM == CC_PLATFORM_WIN32) || (CC_TARGET_PLATFORM == CC_PLATFORM_WINRT)
|
2013-12-10 23:13:21 +08:00
|
|
|
// for import ssize_t on win32 platform
|
2014-09-10 07:50:02 +08:00
|
|
|
#include "platform/CCStdC.h"
|
2013-06-18 17:10:54 +08:00
|
|
|
#endif
|
|
|
|
|
2015-03-24 14:12:58 +08:00
|
|
|
/**
|
|
|
|
* @addtogroup base
|
|
|
|
* @{
|
|
|
|
*/
|
|
|
|
|
2014-10-11 16:05:34 +08:00
|
|
|
namespace cocos2d
|
|
|
|
{
|
2014-10-11 09:21:15 +08:00
|
|
|
#ifndef _unz64_H
|
2014-10-11 08:41:11 +08:00
|
|
|
typedef struct unz_file_info_s unz_file_info;
|
2014-10-11 09:21:15 +08:00
|
|
|
#endif
|
2015-03-23 22:17:59 +08:00
|
|
|
/** XXX: pragma pack ???
|
|
|
|
* @struct CCZHeader
|
|
|
|
*/
|
2012-04-19 14:35:52 +08:00
|
|
|
struct CCZHeader {
|
2015-03-23 22:17:59 +08:00
|
|
|
unsigned char sig[4]; /** Signature. Should be 'CCZ!' 4 bytes. */
|
|
|
|
unsigned short compression_type; /** Should be 0. */
|
|
|
|
unsigned short version; /** Should be 2 (although version type==1 is also supported). */
|
|
|
|
unsigned int reserved; /** Reserved for users. */
|
|
|
|
unsigned int len; /** Size of the uncompressed file. */
|
2012-04-19 14:35:52 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
enum {
|
2015-03-23 22:17:59 +08:00
|
|
|
CCZ_COMPRESSION_ZLIB, /** zlib format. */
|
|
|
|
CCZ_COMPRESSION_BZIP2, /** bzip2 format (not supported yet). */
|
|
|
|
CCZ_COMPRESSION_GZIP, /** gzip format (not supported yet). */
|
|
|
|
CCZ_COMPRESSION_NONE, /** plain (not supported yet). */
|
2012-04-19 14:35:52 +08:00
|
|
|
};
|
|
|
|
|
2013-05-08 11:45:27 +08:00
|
|
|
class CC_DLL ZipUtils
|
2012-04-19 14:35:52 +08:00
|
|
|
{
|
|
|
|
public:
|
|
|
|
/**
|
2015-03-23 22:17:59 +08:00
|
|
|
* Inflates either zlib or gzip deflated memory. The inflated memory is expected to be freed by the caller.
|
|
|
|
*
|
|
|
|
* It will allocate 256k for the destination buffer. If it is not enough it will multiply the previous buffer size per 2, until there is enough memory.
|
|
|
|
*
|
|
|
|
* @return The length of the deflated buffer.
|
|
|
|
* @since v0.8.1
|
|
|
|
*/
|
2013-12-06 16:32:06 +08:00
|
|
|
CC_DEPRECATED_ATTRIBUTE static ssize_t ccInflateMemory(unsigned char *in, ssize_t inLength, unsigned char **out) { return inflateMemory(in, inLength, out); }
|
|
|
|
static ssize_t inflateMemory(unsigned char *in, ssize_t inLength, unsigned char **out);
|
2012-04-19 14:35:52 +08:00
|
|
|
|
|
|
|
/**
|
2015-03-23 22:17:59 +08:00
|
|
|
* Inflates either zlib or gzip deflated memory. The inflated memory is expected to be freed by the caller.
|
2012-04-19 14:35:52 +08:00
|
|
|
*
|
2016-07-03 23:42:10 +08:00
|
|
|
* @param outLengthHint It is assumed to be the needed room to allocate the inflated buffer.
|
2012-04-19 14:35:52 +08:00
|
|
|
*
|
2015-03-23 22:17:59 +08:00
|
|
|
* @return The length of the deflated buffer.
|
|
|
|
* @since v1.0.0
|
2012-04-19 14:35:52 +08:00
|
|
|
*/
|
2013-12-06 16:32:06 +08:00
|
|
|
CC_DEPRECATED_ATTRIBUTE static ssize_t ccInflateMemoryWithHint(unsigned char *in, ssize_t inLength, unsigned char **out, ssize_t outLengthHint) { return inflateMemoryWithHint(in, inLength, out, outLengthHint); }
|
|
|
|
static ssize_t inflateMemoryWithHint(unsigned char *in, ssize_t inLength, unsigned char **out, ssize_t outLengthHint);
|
2012-04-19 14:35:52 +08:00
|
|
|
|
2015-03-23 22:17:59 +08:00
|
|
|
/**
|
|
|
|
* Inflates a GZip file into memory.
|
|
|
|
*
|
|
|
|
* @return The length of the deflated buffer.
|
|
|
|
* @since v0.99.5
|
|
|
|
*/
|
2013-11-14 13:35:17 +08:00
|
|
|
CC_DEPRECATED_ATTRIBUTE static int ccInflateGZipFile(const char *filename, unsigned char **out) { return inflateGZipFile(filename, out); }
|
2013-11-12 10:09:47 +08:00
|
|
|
static int inflateGZipFile(const char *filename, unsigned char **out);
|
2013-07-25 21:35:00 +08:00
|
|
|
|
2015-03-23 22:17:59 +08:00
|
|
|
/**
|
|
|
|
* Test a file is a GZip format file or not.
|
|
|
|
*
|
|
|
|
* @return True is a GZip format file. false is not.
|
|
|
|
* @since v3.0
|
|
|
|
*/
|
2013-11-14 13:35:17 +08:00
|
|
|
CC_DEPRECATED_ATTRIBUTE static bool ccIsGZipFile(const char *filename) { return isGZipFile(filename); }
|
2013-11-12 10:09:47 +08:00
|
|
|
static bool isGZipFile(const char *filename);
|
2013-07-25 21:35:00 +08:00
|
|
|
|
2015-03-23 22:17:59 +08:00
|
|
|
/**
|
|
|
|
* Test the buffer is GZip format or not.
|
|
|
|
*
|
|
|
|
* @return True is GZip format. false is not.
|
|
|
|
* @since v3.0
|
|
|
|
*/
|
2013-12-06 16:32:06 +08:00
|
|
|
CC_DEPRECATED_ATTRIBUTE static bool ccIsGZipBuffer(const unsigned char *buffer, ssize_t len) { return isGZipBuffer(buffer, len); }
|
|
|
|
static bool isGZipBuffer(const unsigned char *buffer, ssize_t len);
|
2012-04-19 14:35:52 +08:00
|
|
|
|
2015-03-23 22:17:59 +08:00
|
|
|
/**
|
|
|
|
* Inflates a CCZ file into memory.
|
|
|
|
*
|
|
|
|
* @return The length of the deflated buffer.
|
|
|
|
* @since v0.99.5
|
|
|
|
*/
|
2013-11-14 13:35:17 +08:00
|
|
|
CC_DEPRECATED_ATTRIBUTE static int ccInflateCCZFile(const char *filename, unsigned char **out) { return inflateCCZFile(filename, out); }
|
2013-11-12 10:09:47 +08:00
|
|
|
static int inflateCCZFile(const char *filename, unsigned char **out);
|
2012-04-19 14:35:52 +08:00
|
|
|
|
2015-03-23 22:17:59 +08:00
|
|
|
/**
|
|
|
|
* Inflates a buffer with CCZ format into memory.
|
|
|
|
*
|
|
|
|
* @return The length of the deflated buffer.
|
|
|
|
* @since v3.0
|
|
|
|
*/
|
2013-12-06 16:32:06 +08:00
|
|
|
CC_DEPRECATED_ATTRIBUTE static int ccInflateCCZBuffer(const unsigned char *buffer, ssize_t len, unsigned char **out) { return inflateCCZBuffer(buffer, len, out); }
|
|
|
|
static int inflateCCZBuffer(const unsigned char *buffer, ssize_t len, unsigned char **out);
|
2013-07-25 21:35:00 +08:00
|
|
|
|
2015-03-23 22:17:59 +08:00
|
|
|
/**
|
|
|
|
* Test a file is a CCZ format file or not.
|
|
|
|
*
|
|
|
|
* @return True is a CCZ format file. false is not.
|
|
|
|
* @since v3.0
|
|
|
|
*/
|
2013-11-14 13:35:17 +08:00
|
|
|
CC_DEPRECATED_ATTRIBUTE static bool ccIsCCZFile(const char *filename) { return isCCZFile(filename); }
|
2013-11-12 10:09:47 +08:00
|
|
|
static bool isCCZFile(const char *filename);
|
2013-07-25 21:35:00 +08:00
|
|
|
|
2015-03-23 22:17:59 +08:00
|
|
|
/**
|
|
|
|
* Test the buffer is CCZ format or not.
|
|
|
|
*
|
|
|
|
* @return True is CCZ format. false is not.
|
|
|
|
* @since v3.0
|
|
|
|
*/
|
2013-12-06 16:32:06 +08:00
|
|
|
CC_DEPRECATED_ATTRIBUTE static bool ccIsCCZBuffer(const unsigned char *buffer, ssize_t len) { return isCCZBuffer(buffer, len); }
|
|
|
|
static bool isCCZBuffer(const unsigned char *buffer, ssize_t len);
|
2013-07-25 21:35:00 +08:00
|
|
|
|
2015-03-23 22:17:59 +08:00
|
|
|
/**
|
|
|
|
* Sets the pvr.ccz encryption key parts separately for added security.
|
|
|
|
*
|
|
|
|
* Example: If the key used to encrypt the pvr.ccz file is
|
|
|
|
* 0xaaaaaaaabbbbbbbbccccccccdddddddd you will call this function 4
|
|
|
|
* different times, preferably from 4 different source files, as follows
|
|
|
|
*
|
|
|
|
* ZipUtils::setPvrEncryptionKeyPart(0, 0xaaaaaaaa);
|
|
|
|
* ZipUtils::setPvrEncryptionKeyPart(1, 0xbbbbbbbb);
|
|
|
|
* ZipUtils::setPvrEncryptionKeyPart(2, 0xcccccccc);
|
|
|
|
* ZipUtils::setPvrEncryptionKeyPart(3, 0xdddddddd);
|
|
|
|
*
|
|
|
|
* Splitting the key into 4 parts and calling the function from 4 different source
|
|
|
|
* files increases the difficulty to reverse engineer the encryption key.
|
2015-12-03 20:00:51 +08:00
|
|
|
* Be aware that encryption is *never* 100% secure and the key code
|
2015-03-23 22:17:59 +08:00
|
|
|
* can be cracked by knowledgable persons.
|
|
|
|
*
|
|
|
|
* IMPORTANT: Be sure to call setPvrEncryptionKey or
|
|
|
|
* setPvrEncryptionKeyPart with all of the key parts *before* loading
|
|
|
|
* the sprite sheet or decryption will fail and the sprite sheet
|
|
|
|
* will fail to load.
|
|
|
|
*
|
|
|
|
* @param index Part of the key [0..3].
|
|
|
|
* @param value Value of the key part.
|
|
|
|
*/
|
2013-11-14 13:35:17 +08:00
|
|
|
CC_DEPRECATED_ATTRIBUTE static void ccSetPvrEncryptionKeyPart(int index, unsigned int value) { setPvrEncryptionKeyPart(index, value); }
|
2013-11-12 10:09:47 +08:00
|
|
|
static void setPvrEncryptionKeyPart(int index, unsigned int value);
|
2013-05-07 22:14:38 +08:00
|
|
|
|
2015-03-23 22:17:59 +08:00
|
|
|
/**
|
|
|
|
* Sets the pvr.ccz encryption key.
|
|
|
|
*
|
|
|
|
* Example: If the key used to encrypt the pvr.ccz file is
|
|
|
|
* 0xaaaaaaaabbbbbbbbccccccccdddddddd you will call this function with
|
|
|
|
* the key split into 4 parts as follows
|
|
|
|
*
|
|
|
|
* ZipUtils::setPvrEncryptionKey(0xaaaaaaaa, 0xbbbbbbbb, 0xcccccccc, 0xdddddddd);
|
|
|
|
*
|
|
|
|
* Note that using this function makes it easier to reverse engineer and discover
|
|
|
|
* the complete key because the key parts are present in one function call.
|
|
|
|
*
|
|
|
|
* IMPORTANT: Be sure to call setPvrEncryptionKey or setPvrEncryptionKeyPart
|
|
|
|
* with all of the key parts *before* loading the spritesheet or decryption
|
|
|
|
* will fail and the sprite sheet will fail to load.
|
|
|
|
*
|
|
|
|
* @param keyPart1 The key value part 1.
|
|
|
|
* @param keyPart2 The key value part 2.
|
|
|
|
* @param keyPart3 The key value part 3.
|
|
|
|
* @param keyPart4 The key value part 4.
|
|
|
|
*/
|
2013-11-14 13:35:17 +08:00
|
|
|
CC_DEPRECATED_ATTRIBUTE static void ccSetPvrEncryptionKey(unsigned int keyPart1, unsigned int keyPart2, unsigned int keyPart3, unsigned int keyPart4) { setPvrEncryptionKey(keyPart1, keyPart2, keyPart3, keyPart4); }
|
2013-11-12 10:09:47 +08:00
|
|
|
static void setPvrEncryptionKey(unsigned int keyPart1, unsigned int keyPart2, unsigned int keyPart3, unsigned int keyPart4);
|
2013-05-06 22:04:45 +08:00
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
private:
|
2016-07-06 07:27:39 +08:00
|
|
|
static int inflateMemoryWithHint(unsigned char *in, ssize_t inLength, unsigned char **out, ssize_t *outLength, ssize_t outLengthHint);
|
2013-12-06 16:32:06 +08:00
|
|
|
static inline void decodeEncodedPvr (unsigned int *data, ssize_t len);
|
|
|
|
static inline unsigned int checksumPvr(const unsigned int *data, ssize_t len);
|
2013-05-06 22:04:45 +08:00
|
|
|
|
|
|
|
static unsigned int s_uEncryptedPvrKeyParts[4];
|
|
|
|
static unsigned int s_uEncryptionKey[1024];
|
|
|
|
static bool s_bEncryptionKeyIsValid;
|
2012-04-19 14:35:52 +08:00
|
|
|
};
|
|
|
|
|
2012-11-08 19:46:53 +08:00
|
|
|
// forward declaration
|
|
|
|
class ZipFilePrivate;
|
2014-10-08 17:30:14 +08:00
|
|
|
struct unz_file_info_s;
|
2012-11-08 19:46:53 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Zip file - reader helper class.
|
|
|
|
*
|
|
|
|
* It will cache the file list of a particular zip file with positions inside an archive,
|
2015-12-09 00:45:39 +08:00
|
|
|
* so it would be much faster to read some particular files or to check their existence.
|
2012-11-08 19:46:53 +08:00
|
|
|
*
|
|
|
|
* @since v2.0.5
|
|
|
|
*/
|
2014-08-15 18:20:37 +08:00
|
|
|
class CC_DLL ZipFile
|
2012-11-08 19:46:53 +08:00
|
|
|
{
|
|
|
|
public:
|
|
|
|
/**
|
|
|
|
* Constructor, open zip file and store file list.
|
|
|
|
*
|
|
|
|
* @param zipFile Zip file name
|
|
|
|
* @param filter The first part of file names, which should be accessible.
|
|
|
|
* For example, "assets/". Other files will be missed.
|
|
|
|
*
|
|
|
|
* @since v2.0.5
|
|
|
|
*/
|
|
|
|
ZipFile(const std::string &zipFile, const std::string &filter = std::string());
|
|
|
|
virtual ~ZipFile();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Regenerate accessible file list based on a new filter string.
|
|
|
|
*
|
|
|
|
* @param filter New filter string (first part of files names)
|
|
|
|
* @return true whenever zip file is open successfully and it is possible to locate
|
|
|
|
* at least the first file, false otherwise
|
|
|
|
*
|
|
|
|
* @since v2.0.5
|
|
|
|
*/
|
|
|
|
bool setFilter(const std::string &filter);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Check does a file exists or not in zip file
|
|
|
|
*
|
2015-12-09 00:45:39 +08:00
|
|
|
* @param fileName File to be checked on existence
|
2012-11-08 19:46:53 +08:00
|
|
|
* @return true whenever file exists, false otherwise
|
|
|
|
*
|
|
|
|
* @since v2.0.5
|
|
|
|
*/
|
|
|
|
bool fileExists(const std::string &fileName) const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get resource file data from a zip file.
|
|
|
|
* @param fileName File name
|
2016-07-03 23:42:10 +08:00
|
|
|
* @param[out] size If the file read operation succeeds, it will be the data size, otherwise 0.
|
2013-12-18 17:47:20 +08:00
|
|
|
* @return Upon success, a pointer to the data is returned, otherwise nullptr.
|
|
|
|
* @warning Recall: you are responsible for calling free() on any Non-nullptr pointer returned.
|
2012-11-08 19:46:53 +08:00
|
|
|
*
|
|
|
|
* @since v2.0.5
|
|
|
|
*/
|
2013-12-05 17:19:01 +08:00
|
|
|
unsigned char *getFileData(const std::string &fileName, ssize_t *size);
|
2016-05-04 09:21:35 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Get resource file data from a zip file.
|
|
|
|
* @param fileName File name
|
|
|
|
* @param[out] buffer If the file read operation succeeds, if will contain the file data.
|
|
|
|
* @return True if successful.
|
|
|
|
*/
|
|
|
|
bool getFileData(const std::string &fileName, ResizableBuffer* buffer);
|
2012-11-08 19:46:53 +08:00
|
|
|
|
2014-10-08 17:30:14 +08:00
|
|
|
std::string getFirstFilename();
|
|
|
|
std::string getNextFilename();
|
|
|
|
|
|
|
|
static ZipFile *createWithBuffer(const void* buffer, unsigned long size);
|
|
|
|
|
2012-11-08 19:46:53 +08:00
|
|
|
private:
|
2014-10-08 17:30:14 +08:00
|
|
|
/* Only used internal for createWithBuffer() */
|
|
|
|
ZipFile();
|
|
|
|
|
|
|
|
bool initWithBuffer(const void *buffer, unsigned long size);
|
|
|
|
int getCurrentFileInfo(std::string *filename, unz_file_info *info);
|
|
|
|
|
2012-11-08 19:46:53 +08:00
|
|
|
/** Internal data like zip file pointer / file list array and so on */
|
2013-06-15 14:03:30 +08:00
|
|
|
ZipFilePrivate *_data;
|
2012-11-08 19:46:53 +08:00
|
|
|
};
|
2012-04-19 14:35:52 +08:00
|
|
|
} // end of namespace cocos2d
|
2015-03-24 14:12:58 +08:00
|
|
|
|
|
|
|
// end group
|
|
|
|
/// @}
|
|
|
|
|
2015-03-24 20:23:51 +08:00
|
|
|
/// @endcond
|
2012-11-08 19:46:53 +08:00
|
|
|
#endif // __SUPPORT_ZIPUTILS_H__
|