cocos2d-x之__Array:: createWithContentsOfFile引发的“血案”

本文档详细介绍了在cocos2d-x3.2版本中,使用`__Array::createWithContentsOfFile`从plist文件读取数组时遇到的崩溃问题。原因在于3.x版本中`__Array`被弃用,`CCArray`被`cocos2d::Vector`取代,而`Vector`只能存储`cocos2d::Ref`子类的对象。解决方案是使用`ValueVector`来读取包含不同类型数据的plist文件。同时,文中还提到了ValueVector的使用和删除元素的注意事项。

***************************************************************************

时间:2014-11-8

作者:Sharing_Li

转载出处:http://blog.youkuaiyun.com/sharing_li/article/details/40895213

***************************************************************************

 

      昨天写代码,想从一个plist文件中读取一个数组,如下所示:

<?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">
<array>
	<dict>
		<key>x</key>
		<integer>12</integer>
		<key>y</key>
		<integer>20</integer>
	</dict>
	<dict>
		<key>x</key>
		<integer>17</integer>
		<key>y</key>
		<integer>25</integer>
	</dict>
</array>
</plist>

      用的方法是cocos2d-x3.2版本的__Array::createWithContentsOfFile("xxxxx.plist");结果读取失败,程序一运行直接崩溃,提示什么断言错误。一开始以为自己的plist文件格式不对,但一查资料,发现格式是对的,没什么问题。网上看了下别人用的2.x版本也没什么问题,然后对比了下2.x和3.x的数据存储结构,终于发现了问题的所在。

      在2.x版本中,使用CCArray可以保存不同数据类型的数据,使用createWithContentsOfFile生成Array没有问题。但是到了3.x版本中,用cocos2d::Vector替代了CCArray的功能,cocos2d::Vector<T>中的T必须是一个指向cocos2d::Ref子类对象的指针,不能是其他数据类型或者是原生类型(即基本类型),因为开发人员已经将Cocos2dx的内存管理模型集成到cocos2d::Vector<T>中,并且Vector自己并不是Ref的子类,所以不能对它的实例使用retain和release。在3.x版本中虽然有__Array,但已被弃用了,只保留了CCArray的部分功能。

      以前面的__Array::createWithContentsOfFile("xxxxx.plist");为例,我们按F12跟踪查看源代码:

__Array* __Array::createWithContentsOfFile(const std::string& fileName)
{
    __Array* ret = __Array::createWithContentsOfFileThreadSafe(fileName);
    if (ret != nullptr)
    {
        ret->autorelease();
    }
    return ret;
}

__Array* __Array::createWithContentsOfFileThreadSafe(const std::string& fileName)
{
    ValueVector arr = FileUtils::getInstance()->getValueVectorFromFile(fileName);
    
    __Array* ret = __Array::createWithCapacity(static_cast<int>(arr.size()));

    for(const auto &value : arr) {
        ret->addObject(__String::create(value.asString()));
    }
    
    return ret;
}

       之前崩溃的原因是在于这一句代码:ret->addObject(__String::create(value.asString()));因为我们的plist文件里面没有string类型,而这里好像只能读取string类型,所以读取失败。我们读取的plist文件中可以看到有int等基本类型,他不是Ref的子类,所以不能用cocos2d::Vector方法,并且Vector也没有提供createWithContentsOfFile方法。那么既然__Array和Vector都不行,那怎么解决呢?

       放心,引擎给我们提供了保存非Ref子类的容器类,就是ValueVector,它在文档中如下定义:

typedef std::vector<Value> ValueVector;

       可以看到,ValueVector实际上就是一个存放Value类型元素的std::vector容器。在3.2中,我们可以用如下方法读取plist:

ValueVector val = FileUtils::getInstance()->getValueVectorFromFile("star.plist");
for(auto ref : val) 
{
	//将val 里面读取的对象ref 转化为ValueMap 类型
	auto temp_map = ref.asValueMap();
	//转化之后的Val 对象 temp_map 取出x,y值
	auto x = temp_map.at("x").asInt();
	auto y = temp_map.at("y").asInt();
}

 

       不过用ValueVector读取的plist文件只局限于是该plist的格式的以array数组类型开头的,例如下面这种:

<array>  
    <dict>  
        <key>name</key>  
        <string>star</string>  
        <key>number</key>  
        <integer>yes</integer>  
    </dict>  
</array>

       如果是以dict字典类型开头的文件,则要换用ValueMap。

拓展:

       1、从前面的讨论当中,我们不难得出:ValueVector中可以放ValueVector,前提是将ValueVector转成Value类型;而Vector中不能存放Vector类型的元素。(不知道为什么的可以再重头看一遍)。

       2、另外在查看ValueVector源码时发现的一个需要注意的地方,删除ValueVector中的元素有两种方法:

        A、val.pop_back();直接删除容器中最后一个元素。

        B、用erase删除容器中的某一个元素,使用的方法是:

             auto iter = std::find(val.begin(),val.end(),x);  
             val.erase(iter);
             而不是star_val.erase(x);(鄙人曾经就放过这个错误)因为erase的参数是一个迭代器,更深层的原因是Value没有重载==运算符,而std::find里面的数据类型必须实现==运算符,否则就不能查找,那么也就不能删除元素了。

<think>我们正在讨论Cocos2d-x 3.17.2的环境配置,特别是运行setup.py脚本后的环境变量配置。 根据之前的内容,运行setup.py是为了设置Cocos2d-x开发所需的环境变量,包括NDK_ROOT, ANDROID_SDK_ROOT, ANT_ROOT(如果使用)等。 运行setup.py后,它会提示用户输入这些路径,然后将这些路径写入到用户主目录下的一个配置文件(例如.bash_profile或.cocos2d-x_env.ini等)中,并可能添加到系统环境变量中(具体取决于操作系统和脚本的实现)。 但是,需要注意的是,setup.py脚本在Cocos2d-x 3.17.2中可能只会在当前命令行会话中设置环境变量,或者将环境变量的设置命令写入到用户配置文件中(如.bashrc或.profile),以便在每次打开终端时自动设置。 具体步骤和说明: 1. 运行setup.py: 在Cocos2d-x根目录下,执行: ```bash python setup.py ``` 2. 根据提示输入路径: 脚本会依次提示输入以下路径(如果不需要可以留空,但安卓开发需要前两个): - ANDROID_SDK_ROOT:Android SDK的安装路径 - NDK_ROOT:Android NDK的安装路径 - ANT_ROOT:Apache Ant的安装路径(可选,因为现在大多使用Gradle) 3. 脚本执行后: - 对于Windows系统:脚本可能会将环境变量写入到注册表,或者生成一个批处理文件(.bat)供用户运行以设置临时环境变量。但更常见的是,它会提示用户手动设置环境变量(通过系统属性->高级->环境变量)。 - 对于Linux/macOS系统:脚本通常会将环境变量设置命令写入到用户主目录下的.bashrc、.bash_profile或.profile文件中,这样每次打开终端都会自动设置。 4. 如何验证环境变量已设置? 打开一个新的命令行窗口(确保重新加载了配置文件),输入: ```bash echo $ANDROID_SDK_ROOT # Linux/macOS echo %ANDROID_SDK_ROOT% # Windows(在cmd中) ``` 或者使用cocos命令: ```bash cocos --version ``` 如果输出了Cocos2d-x的版本信息,则说明环境变量配置成功。 5. 如果环境变量没有生效怎么办? - 检查是否在运行setup.py后重新启动了命令行窗口(因为新的环境变量需要新的会话才能加载)。 - 检查脚本是否将环境变量设置命令写入了正确的配置文件(如.bashrc等),并确保该配置文件被终端加载。 - 手动将环境变量添加到系统环境变量中(特别是Windows用户)。 6. 手动设置环境变量(以Windows为例): 右键“此电脑”->属性->高级系统设置->环境变量,在“系统变量”中新建: - 变量名:ANDROID_SDK_ROOT,变量值:SDK安装路径(如C:\android-sdk) - 变量名:NDK_ROOT,变量值:NDK安装路径(如C:\android-ndk-r16b) - 变量名:ANT_ROOT,变量值:Ant安装路径(如C:\apache-ant-1.9.16,可选) 然后,将Cocos2d-x的根目录下的tools\cocos2d-console\bin和tools\cocos2d-console\plugins目录添加到PATH环境变量中(这样可以在任意目录使用cocos命令)。 7. 对于Linux/macOS,可以手动将以下内容添加到~/.bashrc或~/.bash_profile中: ```bash export ANDROID_SDK_ROOT=/path/to/android-sdk export NDK_ROOT=/path/to/android-ndk-r16b export ANT_ROOT=/path/to/ant # 可选 export PATH=$PATH:/path/to/cocos2d-x-3.17.2/tools/cocos2d-console/bin ``` 然后运行`source ~/.bashrc`(或重启终端)使配置生效。 注意:Cocos2d-x 3.17.2要求NDK版本为r16b,SDK的API level至少为29(即android-29)。 引用[1]中提到了在Windows下使用VS2015和Cocos2d-x-3.17.2搭建开发环境,其中包括了修改项目名称和包名等步骤,但环境变量配置是通用的。 因此,运行setup.py后,我们主要需要确保环境变量设置正确且已生效,这样后续的编译命令(如`cocos compile`)才能正确执行。 如果用户按照上述步骤操作后仍然无法生效,可能需要检查路径是否正确,以及是否有权限修改环境变量。 生成相关问题: 1. 运行setup.py后环境变量没有生效怎么办? 2. 如何验证Cocos2d-x的环境变量配置是否正确? 3. Cocos2d-x 3.17.2 要求哪些特定版本的工具(如NDK、SDK)? 4. 在Windows系统中如何永久设置Cocos2d-x所需的环境变量?</think>### Cocos2d-x 3.17.2 运行 setup.py 后的环境变量配置说明 运行 `setup.py` 是配置 Cocos2d-x 开发环境的关键步骤,它会引导你设置必需的环境变量并生成配置文件。以下是详细说明: #### 一、运行 setup.py 的过程 在 Cocos2d-x 根目录执行: ```bash python setup.py ``` 脚本会依次提示输入以下路径(按回车跳过不需要的项): ``` 1. 输入 Android SDK 路径 (ANDROID_SDK_ROOT) 2. 输入 Android NDK 路径 (NDK_ROOT) 3. 输入 Apache Ant 路径 (ANT_ROOT) 4. 输入 Python 路径 (留空则使用系统默认) ``` #### 二、环境变量配置说明 脚本会创建以下环境变量(以 Windows 为例): | 环境变量名 | 作用描述 | 示例值 | |--------------------|--------------------------------------------------------------------------|--------------------------------| | `COCOS_CONSOLE_ROOT` | Cocos 命令行工具路径 | `C:\cocos2d-x-3.17.2\tools\cocos2d-console\bin` | | `NDK_ROOT` | Android NDK 路径(编译 C++ 代码必需) | `C:\android-ndk-r16b` | | `ANDROID_SDK_ROOT` | Android SDK 路径(构建 APK 必需) | `C:\Android\Sdk` | | `ANT_ROOT` | Apache Ant 路径(旧版构建工具,3.17.2 中可省略) | `C:\apache-ant-1.10.1\bin` | #### 三、配置文件生成位置 脚本会在用户目录生成配置文件: - **Windows**: `C:\Users\<用户名>\.cocos2d-x-3.17.2\setup_env.bat` - **Linux/macOS**: `~/.cocos2d-x-3.17.2/setup_env.sh` 文件内容示例(Windows): ```bat @echo off set COCOS_CONSOLE_ROOT=C:\cocos2d-x-3.17.2\tools\cocos2d-console\bin set NDK_ROOT=C:\android-ndk-r16b set ANDROID_SDK_ROOT=C:\Android\Sdk set ANT_ROOT=C:\apache-ant-1.10.1\bin set PATH=%COCOS_CONSOLE_ROOT%;%NDK_ROOT%;%ANDROID_SDK_ROOT%;%ANT_ROOT%;%PATH% ``` #### 四、环境变量生效方法 1. **临时生效**(当前命令行窗口): ```bash # Windows call %USERPROFILE%\.cocos2d-x-3.17.2\setup_env.bat # Linux/macOS source ~/.cocos2d-x-3.17.2/setup_env.sh ``` 2. **永久生效**(推荐): - **Windows**:将 `setup_env.bat` 内容复制到系统环境变量设置 1. Win+R → 输入 `sysdm.cpl` → 高级 → 环境变量 2. 在 **系统变量** 中添加上述变量 - **Linux/macOS**:将以下代码添加到 `~/.bashrc` 或 `~/.zshrc` ```bash source ~/.cocos2d-x-3.17.2/setup_env.sh ``` #### 五、验证配置 ```bash cocos --version ``` 成功输出示例: ``` Cocos Console 2.3 Cocos2d-x 3.17.2 ``` > **注意**:若使用 Android Studio 开发,还需在 `local.properties` 中添加: > ```properties > sdk.dir=C\:\\Android\\Sdk > ndk.dir=C\:\\android-ndk-r16b > ``` #### 六、常见问题处理 1. **路径包含空格**: 若 SDK/NDK 路径有空格(如 `Program Files`),需使用 **8.3 短路径格式**: ```bash # 查询短路径(Windows) dir /x C:\Progra~1 ``` 在配置中使用 `C:\Progra~1\Android` 格式 2. **环境变量未生效**: ```bash # 检查所有环境变量 cocos env --show ``` 3. **NDK 版本不兼容**: 必须使用 **NDK r16b**,其他版本可能导致编译失败[^1]。 ---
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值