导入问题

症状： 尝试导入时，您的游戏文件显示为灰色或不可见。

原因： Spark 的文件扩展名过滤器默认只显示已识别的格式。

解决方案：

1. 前往设置 > 游戏库
2. 关闭文件扩展名过滤器
3. 重新尝试导入

这在 APK 文件中尤为常见。

症状： 导入似乎完成，但游戏库中没有出现新游戏。

可能的原因：

1. 无效的游戏结构 — 压缩包不包含有效的 Ren’Py 游戏

   • 解决方案：验证压缩包是否包含带有 .rpy 或 .rpa 文件的 game/ 文件夹

2. 嵌套目录 — 游戏在压缩包中嵌套太深

   • 解决方案：先在 PC 上解压压缩包，然后只传输游戏文件夹

3. 损坏的压缩包 — 文件已损坏

   • 解决方案：重新下载压缩包

症状： 导入失败并显示错误 “Unable to find the ‘game’ folder. Is this a Ren’Py title? It is possible that the game was packaged in an unknown way.”

原因： Spark 扫描解压后的压缩包以查找 game/ 文件夹，这是 Ren’Py 游戏的标准结构。如果未找到，导入将无法继续。这可能发生在以下情况：

• 压缩包不是 Ren’Py 游戏
• 游戏以非标准方式打包（非官方重新打包、自定义文件夹结构）
• 压缩包是双层打包的，Spark 的自动检测未找到内层游戏

解决方案：

1. 验证压缩包确实是包含 game/ 文件夹的 Ren’Py 游戏
2. 尝试使用来自原始开发者的官方游戏压缩包而非重新打包的版本
3. 如果压缩包包含有效的 Ren’Py 游戏但 Spark 无法检测到，请在 Discord 上或通过邮件向支持团队报告

症状： 导入失败并显示错误 “Legacy Method — Unable to find game folder.”

原因： 主要游戏文件夹检测失败后，Spark 会尝试回退的传统扫描方法，递归搜索整个解压后的压缩包以查找 game/ 文件夹。此错误意味着即使传统检测也无法找到有效游戏。

解决方案：

• 压缩包结构可能不兼容。尝试游戏的不同版本或不同平台的压缩包
• 在 PC 上解压压缩包，验证文件夹结构，然后将其重新打包为标准 ZIP，game/ 文件夹在预期层级
• 向支持团队报告问题并附上游戏名称

症状： 游戏无法启动并显示消息 “Unable to determine Ren’Py Version. Aborting Launch.” 或提示您指定引擎版本。

原因： Spark 无法自动检测游戏需要哪个 Ren’Py 版本。

解决方案： 打开游戏设置（长按游戏），点击 Ren’Py 版本旁的修改，然后手动选择正确的引擎版本。如果不确定，对于较旧的游戏尝试最新的 7.x 版本，对于较新的游戏尝试最新的 8.x 版本。

症状： 启动失败并显示错误 “The requested engine version was not found.”

原因： 为游戏选择的引擎版本在设备上不可用。

解决方案： 打开游戏设置并选择其他可用的引擎版本。

症状： 导入失败并显示错误，显示预估的未压缩大小和可用空间。

原因： 您的设备没有足够的可用存储空间来解压压缩包。您通常需要至少压缩包大小的 2 倍空间（压缩包本身加上解压后的文件）。

解决方案： 释放设备上的存储空间并重试。使用存储管理器来确定可以移除的游戏或备份。

症状： 导入失败并显示 “Unable to determine the uncompressed archive size. Is the archive corrupt?”

原因： Spark 无法读取压缩包的元数据以计算未压缩大小。文件可能已损坏或使用了不受支持的格式变体。

解决方案： 重新下载压缩包并重试。如果问题持续，压缩包可能使用了非标准格式——请向支持团队报告。

症状： 导入失败并显示 “Unable to obtain file permission from the operating system.”

原因： iOS 未授予 Spark 访问所选文件的权限。这可能发生在某些云存储提供商或外部位置的文件上。

解决方案： 尝试先将压缩包复制到文件应用中的我的 iPhone/iPad 部分，然后从那里导入。

症状： 进度指示器冻结或在导入过程中出现未列出的错误。

解决方案：

• 确保您有足够的可用存储空间（至少为压缩包大小的 2 倍）
• 对于非常大的压缩包（2 GB 以上），导入可能需要几分钟——请耐心等待
• 某些归档格式如 7z 在包含数千个散文件时可能非常慢
• 如果错误持续，请向支持团队报告错误消息和游戏名称

症状： 导入 APK 后，游戏显示不正确或通用的名称。

原因： 无法从 APK 元数据确定游戏名称。

解决方案： 在游戏库中长按游戏并手动重命名。