plist文件操作

Cocos2d-x数据篇04：plist文件操作

【前言】

在Cocos2d-x中，plist文件 是非常常见的配置文件。它是特定格式的xml文件。

例如：小图打包成大图的纹理图片、制作粒子特效、帧动画等，都用到了plist文件作为配置文件。

本节要介绍的是：如何创建plist文件，以及读取plist文件中的数据信息。

 

【plist文件】

属性列表（Property List）文件是一种用来存储序列化后的对象的文件。

属性列表文件的文件扩展名为 .plist，因此通常被称为plist文件。

 

1、plist文件在Cocos中的应用

（1）图片纹理的配置信息

将多个纹理小图片打包成一个大图片，并生成plist文件。用于配置各个小图的名称、尺寸大小、以及在大图中的所在的矩形区域位置等信息。

可以使用TexturePacker工具，将多个小碎图的纹理打包成一张大图片。

（2）帧动画的配置信息

将帧动画的数据信息，生成为plist配置文件。包含每帧间隔、动画重复次数、每一帧所需的图片、每张图片的名称、尺寸大小、以及在大图中所在的矩形区域位置等信息。

（3）粒子特效的配置信息

将粒子特效的数据信息，生成为plist配置文件。包含粒子发射器的位置信息、发射器模式、最大粒子数量、发射角度、发射速度、纹理贴图等等信息。

（4）还有其它。

 

2、plist文件格式

plist文件为属性列表文件，类似于键值对（key-value）的形式。

plist文件举例：

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

// <?xml version= "1.0"  encoding= "UTF-8" ?> <!DOCTYPE plist PUBLIC  "-//Apple//DTD PLIST 1.0//EN"  "http://www.apple.com/DTDs/PropertyList-1.0.dtd" > <plist version= "1.0" > <dict> <key>dict</key> <dict> <key>name</key> <string>Alice</string> <key>age</key> <string>20</string> </dict> <key>array</key> <array> <integer>0</integer> <integer>1</integer> <integer>2</integer> </array> <key> bool </key> < true /> <key>data</key> <data></data> <key>date</key> <date>2015-02-16T16:47:11Z</date> <key>number</key> <integer>123456</integer> <key>string</key> <string>hello world!</string> </dict> </plist> //

属性类型有：

> Dictionary ：字典。（子属性列表为：键值对形式）

> Array         ：数组。（子属性列表为：数组值的形式）

> Boolean    ：逻辑值。（true / false）

> Number    ：数字。

> String       ：字符串。

> Date          ：日期。

> Data          ：数据。

其中，根节点只能为字典或数组。

并且在字典或数组中，键对应的值依然可以为以上的各个属性类型。

 

3、创建/编辑plist文件

在Mac OS系统中，XCode可以直接创建和编辑plist文件。

当然也可以使用plist编辑软件，或直接使用文本编辑器进行编写。

XCode中，编辑plist文件非常方便。

其中，根节点Root，只能为Dictionary、或Array类型。

以上plist文件数据，代码形式如下：

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

// <?xml version= "1.0"  encoding= "UTF-8" ?> <!DOCTYPE plist PUBLIC  "-//Apple//DTD PLIST 1.0//EN"  "http://www.apple.com/DTDs/PropertyList-1.0.dtd" > <plist version= "1.0" > <dict> <key>dict</key> <dict> <key>name</key> <string>Alice</string> <key>age</key> <string>20</string> </dict> <key>array</key> <array> <integer>0</integer> <integer>1</integer> <integer>2</integer> </array> <key> bool </key> < true /> <key>data</key> <data></data> <key>date</key> <date>2015-02-16T16:47:11Z</date> <key>number</key> <integer>123456</integer> <key>string</key> <string>hello world!</string> </dict> </plist> //

我想大家应该能读得懂把。

 

4、读取plist文件

接下来讲讲如何读取plist文件的数据信息。

（1）根节点为Dictionary ：使用 FileUtils::getInstance()->getValueMapFromFile(); 读取为一个ValueMap 。

（2）根节点为Array ：使用 FileUtils::getInstance()->getValueVectorFromFile(); 读取为一个ValueVector 。

使用举例：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23

// // 文件路径 std::string path =  "/soft/cocos2d-x-3.4/projects/Demo34/Resources/testPlist.plist" ; // 读取plist文件 // 以根节点为字典Dictionary为例 // 根节点为字典Dictionary , 读取为一个ValueMap ValueMap plist = FileUtils::getInstance()->getValueMapFromFile(path); // 若根节点为数组Array , 读取为一个ValueVector // ValueVector plist = FileUtils::getInstance()->getValueVectorFromFile(path); // 获取数据 // 读取 "string" CCLOG( "string = %s" , (plist[ "string" ].asString()).c_str()); // 读取 "dict" , 也是一个字典ValueMap ValueMap& dict = plist[ "dict" ].asValueMap(); CCLOG( "name = %s" , (dict[ "name" ].asString()).c_str()); CCLOG( "age  = %s" , (dict[ "age" ].asString()).c_str()); // 读取 "array" , 是一个数组ValueVector ValueVector& array = plist[ "array" ].asValueVector(); for  ( int  i = 0; i < array.size(); i++) { Value& value = array[i]; CCLOG( "%d" , value.asInt()); } //

 

【扩展阅读】

http://zh.wikipedia.org/wiki/Plist （维基百科）

http://zengrong.net/post/1981.htm （Cocos2d-x中的PLIST文件格式详解）

http://cn.cocos2d-x.org/tutorial/show?id=2117 （Spritesheet的plist文件格式解析）

转载于:https://www.cnblogs.com/dudu580231/p/4780604.html