匯入遊戲

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 檔案（一個包含 APK 的 ZIP），Spark 會偵測到這種情況並自動解壓兩層。

解壓後，Spark 將檔案整理到最終的遊戲目錄：

• 遊戲資料夾 — 包含腳本、資源和封存的 game/ 資料夾會移動到最終位置
• 遊戲名稱 — 從 android.json（APK 匯入）、遊戲資料夾旁的 .py 檔案，或封存檔名作為後備方案來確定
• 唯一命名 — 如果已存在同名遊戲，會附加數字後綴

Spark 在解壓的檔案中搜尋隨附的 Ren’Py 引擎資料夾（renpy/）。如果找到：

• 引擎會儲存到遊戲的 advanced/renpy/ 目錄，以供進階模式使用
• Ren’Py 版本從引擎資料夾中的版本檔案讀取（例如 vc_version.py、__init__.py、script_version.txt 或其編譯版本）
• 偵測到的版本會儲存在遊戲的中繼資料中以供引擎配對
• 對於 Android APK 匯入，會解壓隨附的檔案（private.mp3）以恢復引擎並偵測 Python 版本

• 自訂字型 — 如果遊戲隨附的引擎包含修改過的字型（與 Ren’Py 預設不同），它們會被複製到遊戲資料夾，以便遊戲在執行時使用
• Live2D 支援 — 封存檔會被掃描以尋找 Live2D 程式庫。如果找到，會建立一個標記，以便 Spark 在遊戲啟動時載入 Live2D 框架

• 會寫入一個 info.json 檔案，包含遊戲名稱、偵測到的引擎版本、原始封存檔名和匯入時間戳記
• 暫存目錄會被清除，臨時檔案會被移除
• 遊戲資料庫會重新整理，新遊戲會出現在您的資料庫中

• 大型遊戲（1 GB 以上）可能需要一些時間來解壓
• 某些封存格式如 7z 如果封存包含數千個零散檔案，可能需要極長時間來解壓。遊戲理想上應使用 .rpa 封存或類似的整合格式封裝。某些解壓程式庫未針對這些情況進行最佳化
• 如果遊戲出現但無法啟動，請嘗試在遊戲設定中變更引擎版本
• APK 檔案可能被檔案篩選器隱藏 — 在 Settings > Game Library 中停用它