导入游戏

Spark 支持多种方法将 Ren’Py 游戏导入到您的 iOS 设备。

• ZIP (.zip) — 最常见
• APK (.apk) — Android 安装包
• 7-Zip (.7z) — 高压缩比
• RAR (.rar) — 传统格式支持
• TAR (.tar) — 未压缩归档
• Gzip (.gz) — Gzip 压缩的 TAR 归档
• BZ2 (.bz2) — Bzip2 压缩的 TAR 归档
• IPA (.ipa) — iOS 应用归档
• APP (.app) — 应用包

1. 打开 Spark 并点击游戏库中的导入按钮
2. 使用系统文件选择器浏览到您的游戏压缩包
3. 选择文件并等待解压完成

Spark 在解压前会检查压缩包：

• 计算未压缩大小以验证您是否有足够的可用空间
• 检测压缩包是否有密码保护，如需要则提示您输入密码
• 扫描压缩包内容以定位 game/ 文件夹

如果压缩包内发现多个游戏文件夹，系统会要求您选择导入哪一个。

压缩包会被解压到一个临时暂存目录。Spark 在解压过程中会监控磁盘空间，如果存储空间严重不足将会停止。macOS 伪影文件夹（__MACOSX）会被自动移除。

对于双层打包的 APK 文件（ZIP 中包含 APK），Spark 会检测到这种情况并自动解压两层。

解压后，Spark 会将文件整理到最终的游戏目录中：

• 游戏文件夹 — 包含脚本、资源和归档的 game/ 文件夹会被移动到最终位置
• 游戏名称 — 从 android.json（APK 导入）、游戏文件夹旁的 .py 文件或归档文件名（作为备选）中确定
• 唯一命名 — 如果已存在同名游戏，将附加数字后缀

Spark 会搜索解压文件中捆绑的 Ren’Py 引擎文件夹（renpy/）。如果找到：

• 引擎会保存到游戏的 advanced/renpy/ 目录，供高级模式使用
• 从引擎文件夹内的版本文件（例如 vc_version.py、__init__.py、script_version.txt 或其编译等价物）中读取 Ren’Py 版本
• 检测到的版本会存储在游戏的元数据中用于引擎匹配
• 对于 Android APK 导入，会解压捆绑文件（private.mp3）以恢复引擎并检测 Python 版本

• 自定义字体 — 如果游戏捆绑的引擎包含修改过的字体（与 Ren’Py 默认字体不同），它们会被复制到游戏文件夹，以便游戏在运行时使用
• Live2D 支持 — 压缩包会被扫描是否包含 Live2D 库。如果找到，会创建标记以便 Spark 在游戏启动时加载 Live2D 框架

• 写入 info.json 文件，包含游戏名称、检测到的引擎版本、原始归档文件名和导入时间戳
• 清除暂存目录并移除临时文件
• 刷新游戏库，新游戏将出现在您的库中

• 大型游戏（1 GB 以上）可能需要较长时间解压
• 某些归档格式如 7z 在包含数千个散文件时可能需要极长的解压时间。游戏理想情况下应使用 .rpa 归档或类似的合并格式进行打包。一些解压库并未针对这些情况进行优化
• 如果游戏出现但无法启动，请尝试在游戏设置中更改引擎版本
• APK 文件可能被文件过滤器隐藏——请在设置 > 游戏库中禁用