Defold引擎中ios-deploy设备列表读取问题的解决方案

问题背景

在Defold游戏引擎的开发过程中，当开发者需要通过ios-deploy工具列出连接的iOS设备时，系统会返回JSON格式的设备信息。然而，在最近的更新中，JSON解析库对输入流处理方式发生了变化，导致设备列表读取功能出现异常。

问题现象

开发者执行ios-deploy设备列表命令时，会遇到以下错误提示：

JSON error (unexpected character): K

这表明JSON解析器在读取数据流时遇到了意外的字符"K"，导致解析失败。

技术分析

问题的根源在于JSON库的更新引入了一个重要的变更：现在需要PushbackReader来从同一数据源读取多个JSON文档。ios-deploy工具输出的设备信息实际上包含多个JSON文档，而原有的简单读取器无法正确处理这种情况。

PushbackReader是一种特殊的输入流读取器，它允许"回推"（push back）已经读取的字符到流中。这种特性对于解析多个JSON文档特别重要，因为：

1. 当解析完一个JSON文档后，可能还有后续文档需要处理
2. 解析器需要能够"回看"流中的内容以确定是否还有更多数据
3. 传统的InputStreamReader无法回退已经读取的字符

解决方案

修复方案是使用PushbackReader包装原始的输入流，这样JSON解析器就能够：

1. 正确识别多个JSON文档的边界
2. 在解析完一个文档后回退到适当位置
3. 继续处理后续的JSON文档而不丢失数据

具体实现上，我们需要在调用JSON解析前，将ios-deploy命令的标准输出流包装在PushbackReader中：

PushbackReader reader = new PushbackReader(new InputStreamReader(process.getInputStream()));

影响范围

这一修复主要影响以下场景：

• 使用Defold引擎开发iOS应用时
• 需要通过ios-deploy工具管理设备时
• 特别是当系统连接了多个iOS设备需要列出时

最佳实践

对于开发者而言，遇到类似JSON解析问题时，可以考虑：

1. 检查数据源是否包含多个文档
2. 确认使用的JSON库是否支持多文档解析
3. 考虑使用PushbackReader等具有回退功能的读取器
4. 在复杂数据流处理场景下，优先选择具有缓冲和回退能力的IO类

总结

Defold引擎通过引入PushbackReader解决了ios-deploy设备列表读取问题，这一改进不仅修复了现有功能，也为处理复杂的多文档数据流提供了更健壮的解决方案。对于开发者而言，理解底层IO处理机制对于调试类似问题具有重要价值。