Coco2dx文件操作FileUtils

添加资源路径

一般我们添加图片资源的时候，会写上图片路径，但是一旦路径很长的话，每个都写是不是很麻烦。这时候可以统一路径。在Delegate.cpp使用默认文件路径.

最简便的方法就是:

auto fileUtils = FileUtils::getInstance();

std::vector<std::string> searchPaths;

searchPaths.push_back("res");

searchPaths.push_back(“ui”);

fileUtils->setSearchPaths(searchPaths);

比较繁琐的方法就是:

FileUtils::getInstance()->addSearchPath("res")

FileUtils::getInstance()->addSearchPath("ui")

 

FileUtils::getInstance()->getWritablePath()该读取的文件路径在Debug.win32路径下

 

 

FileUtils类主要的功能：设置加载、保存文件的所在路径

    1、文件读取

        getDataFromFile、getStringFromFile、getFileDataFromZip

    2、文件查找

        文件字典(Dictionary)、搜索路径(SearchPaths)、子区分路径(SearchResolutionsOrder)

        fullPathForFilename、fullPathFromRelativeFile

    3、文件判断

        isFileExist、isAbsolutePath、PopupNotify

    4、文件写入

        getWritablePath、UserDefault、RenderTexture

    5、文件查找的应用

        举例：精灵的创建

l获取单例对象

    FileUtils也是一个单例类，可以通过getInstance()来获取单例对象。

    static FileUtils* getInstance();   //获得单例对象  

    static void destroyInstance();     //释放单例对象资源  

virtual void purgeCachedEntries(); //清理文件查找缓存  

 

3.1文件读取

    //读取文件内容.  

    virtual Data getDataFromFile(const std::string& filename); //数据返回: data  

    virtual std::string getStringFromFile(const std::string& filename); //数据内容.返回: data.getBytes()  

    //读取zip中某资源文件的内容  

    //  [in]    zip文件路径 ,相对zip的文件路径  

    //  [out]   size. 若文件读取成功，这个值为数据大小，否则为零  

    //  如果成功，则返回数据指针，否则返回 nullptr.  

    virtual unsigned char* getFileDataFromZip(const std::string& zipFilePath, const std::string& filename, ssize_t *size);  

3.2文件查找

1)2.1、设置文件查找路径

    > 文件字典  （Dictionary）

    > 搜索路径  （SearchPaths）

    > 子区分路径（SearchResolutionsOrder）

    具体用法见下面的 2.3 。

    //设置文件词典.相当于给文件起别名  

    //map["sprite.png"] = "sp.png"  

    virtual void setFilenameLookupDictionary(const ValueMap& filenameLookupDict);  

    virtual void loadFilenameLookupDictionaryFromFile(const std::string &filename); //plist加载文件词典  

    //设置搜索路径(可以是绝对路径、相对路径)  

    virtual void setSearchPaths(const std::vector<std::string>& searchPaths); //清除之前add的全部搜索路径（除了默认路径"Resources"）  

    void addSearchPath(const std::string & path, const bool front=false);  

    virtual const std::vector<std::string>& getSearchPaths() const;  

    //设置子区分路径  

    virtual void setSearchResolutionsOrder(const std::vector<std::string>& searchResolutionsOrder); //清除之前add的全部子区分路径  

    virtual void addSearchResolutionsOrder(const std::string &order,const bool front=false);  

    virtual const std::vector<std::string>& getSearchResolutionsOrder();  

2)2.2、查找文件

    当然查找之前，先判断filename是否存在文件字典，若有将替换。

    //获取文件的完整路径（绝对路径）  

    //注意:查找的是文件 ,而不是文件夹  

    virtual std::string fullPathForFilename(const std::string &filename);  

    //路径拼接  

    //relativeFile.substr(0, relativeFile.rfind('/')+1) + getNewFilename(filename);  

    virtual std::string fullPathFromRelativeFile(const std::string &filename, const std::string &relativeFile);  

请注意fullPathFromRelativeFile的用法：

（1）保留relativeFile最后一个'/'前面的路径（如："xyz/123"）

（2）通过文件字典替换filename（如："sprite.png" -> "sp.png"）

（3）路径拼接："xyz/sp.png"

（4）若relativeFile = "xyz/123/"，则路径拼接："xyz/123/sp.png"

3)2.3、举例

    map["sprite.png"] = "bg.png";  

    void        setFilenameLookupDictionary(map);    //设置字典  

    void        setSearchPaths("C:/Res/xyz", "xyz"); //设置搜索路径  

    void        setSearchResolutionsOrder("1", "2"); //设置子区分路径  

    std::string fullPathForFilename("sprite.png");   //获取完整路径  

查找过程：

        查找 "sprite.png"

    （1）先根据字典替换别名"sprite.png" --> "bg.png"

    （2）然后查找"bg.png"（若无字典，直接查找"sprite.png"）

    （3）按以下顺序查找，并返回"sprite.png"的完整路径（如"C:/Res/xyz/bg.png"）。

    （4）若未找到，返回"sprite.png"

C:/Res/xyz/1/bg.png

C:/Res/xyz/2/bg.png

C:/Res/xyz/bg.png

 

C:/projects/MyGame/Resources/xyz/1/bg.png

C:/projects/MyGame/Resources/xyz/2/bg.png

C:/projects/MyGame/Resources/xyz/bg.png

 

 

C:/projects/MyGame/Resources/1/bg.png

C:/projects/MyGame/Resources/2/bg.png

C:/projects/MyGame/Resources/bg.png

注意：若找不到"bg.png"。即使"C:/Res/xyz/"路径下存在"sprite.png"，也显示找不到。

 

3.3文件判断

    //检查文件是否存在(相对路径、绝对路径，都可以)  

    virtual bool isFileExist(const std::string& filename) const;  

    //检查路径是不是绝对路径  

    //在Android平台上，若path是相对于"assets/"，该方法会把它当成绝对路径true  

    virtual bool isAbsolutePath(const std::string& path) const;  

    //设置图片加载失败时,是否弹出消息框  

    virtual void setPopupNotify(bool notify);  

    virtual bool isPopupNotify();  

3.4文件写入

1)获取写入路径

    写入路径一般无法修改。

    virtual std::string getWritablePath() const = 0;  

不同的平台,文件写入的路径不同，如：

    > Win32  ：在exe文件所在的目录。（如“proj.win32/Debug.win32/”）

    > Andriod："/data/data"目录。

    > iOS    ："document folder"目录。

2)写入文件的方法

    可以通过以下两个类来保存游戏的数据：

    > UserDefault  ：用于保存游戏中的用户数据。

    > RenderTexture：用于保存游戏中创建的图片数据。

    具体操作，请学习UserDefault、RenderTexture两个类。

3.5文件查找的应用（精灵的创建）

    精灵的创建需要一张图片资源，而图片资源是从哪里来的呢？

    > 创建sprite的过程中，首先会调用fullPathForFilename("sprite.png")。

    > 先查找图片所在路径，然后根据图片来创建sprite精灵。

    如果不设置文件查找的路径的话，Win32项目默认会在"Resources"中查找图片，而Android项目默认会在"assets"中查找资源图片。

    在这里还是通过 2.3 中的例子分析：

    map["sprite.png"] = "bg.png";  

    void         setFilenameLookupDictionary(map);    //设置字典  

    void         setSearchPaths("C:/Res/xyz", "xyz"); //设置搜索路径  

    void         setSearchResolutionsOrder("1", "2"); //设置子区分路径  

    Sprite* sp = Sprite::create("sprite.png");        //创建精灵  

查找过程：

        查找 "sprite.png"

    （0）调用fullPathForFilename("sprite.png")，查找图片所在路径。

    （1）先根据字典替换别名"sprite.png" --> "bg.png"

    （2）然后查找"bg.png"（若无字典，直接查找"sprite.png"）

    （3）按以下顺序查找，并返回"sprite.png"的完整路径（如"C:/Res/xyz/bg.png"）。

    （4）若未找到"bg.png"，继续查找"sprite.png"。

    （5）若依旧还未找到"sprite.png"，报错。

    （6）若找到图片所在路径，则用该图片创建sprite精灵。

 

C:/Res/xyz/1/bg.png

C:/Res/xyz/2/bg.png

C:/Res/xyz/bg.png

C:/projects/MyGame/Resources/xyz/1/bg.png

C:/projects/MyGame/Resources/xyz/2/bg.png

C:/projects/MyGame/Resources/xyz/bg.png

C:/projects/MyGame/Resources/1/bg.png

C:/projects/MyGame/Resources/2/bg.png

C:/projects/MyGame/Resources/bg.png

 

C:/Res/xyz/1/sprite.png

C:/Res/xyz/2/sprite.png

C:/Res/xyz/sprite.png

C:/projects/MyGame/Resources/xyz/1/sprite.png

C:/projects/MyGame/Resources/xyz/2/sprite.png

C:/projects/MyGame/Resources/xyz/sprite.png

C:/projects/MyGame/Resources/1/sprite.png

C:/projects/MyGame/Resources/2/sprite.png

C:/projects/MyGame/Resources/sprite.png

 

注意：如果"C:/Res/xyz/"路径同时存在"bg.png"和"sprite.png"。

      那么创建的精灵所使用的资源图片为"bg.png"，而不是"sprite.png"。