匯入問題

症狀： 嘗試匯入時，您的遊戲檔案顯示為灰色或不可見。

原因： Spark 的副檔名篩選器預設僅顯示可識別的格式。

解決方案：

1. 前往設定 > 遊戲庫
2. 關閉副檔名篩選器
3. 重新嘗試匯入

這在 APK 檔案中特別常見。

症狀： 匯入似乎已完成，但遊戲庫中沒有出現遊戲。

可能的原因：

1. 無效的遊戲結構 — 封存檔不包含有效的 Ren’Py 遊戲

   • 解決方案：確認封存檔包含帶有 .rpy 或 .rpa 檔案的 game/ 資料夾

2. 巢狀目錄 — 遊戲在封存檔中的層級太深

   • 解決方案：先在 PC 上解壓縮封存檔，然後僅傳輸遊戲資料夾

3. 損壞的封存檔 — 檔案已損壞

   • 解決方案：重新下載封存檔

症狀： 匯入失敗並顯示錯誤 「找不到 ‘game’ 資料夾。這是 Ren’Py 遊戲嗎？遊戲可能以未知的方式封裝。」

原因： Spark 會掃描解壓縮的封存檔以尋找 game/ 資料夾，這是 Ren’Py 遊戲的標準結構。如果找不到，匯入將無法繼續。這可能發生在以下情況：

• 封存檔不是 Ren’Py 遊戲
• 遊戲以非標準方式封裝（非官方重新封裝、自訂資料夾結構）
• 封存檔被雙重封裝，且 Spark 的自動偵測未找到內部遊戲

解決方案：

1. 確認封存檔確實是包含 game/ 資料夾的 Ren’Py 遊戲
2. 嘗試使用來自原始開發者的官方遊戲封存檔，而非重新封裝的版本
3. 如果封存檔包含有效的 Ren’Py 遊戲但 Spark 無法偵測到，請在 Discord 或透過電子郵件向支援團隊回報

症狀： 匯入失敗並顯示錯誤 「舊版方法 — 找不到遊戲資料夾。」

原因： 在主要遊戲資料夾偵測失敗後，Spark 會嘗試使用備用的舊版掃描，遞迴搜尋整個解壓縮封存檔以尋找 game/ 資料夾。此錯誤表示即使舊版偵測也無法找到有效的遊戲。

解決方案：

• 封存檔結構可能不相容。嘗試不同版本或不同平台的遊戲封存檔
• 在 PC 上解壓縮封存檔，確認資料夾結構，然後重新封裝為標準 ZIP，將 game/ 資料夾放在預期的層級
• 向支援團隊回報問題並附上遊戲名稱

症狀： 遊戲無法啟動，並顯示訊息 「無法確定 Ren’Py 版本。中止啟動。」 或提示您指定引擎版本。

原因： Spark 無法自動偵測遊戲需要的 Ren’Py 版本。

解決方案： 開啟遊戲設定（長按遊戲），點擊 Ren’Py 版本旁的修改，然後手動選擇正確的引擎版本。如果您不確定，較舊的遊戲請嘗試最新的 7.x 版本，較新的遊戲請嘗試最新的 8.x 版本。

症狀： 啟動失敗並顯示錯誤 「找不到所請求的引擎版本。」

原因： 為遊戲選擇的引擎版本在裝置上不可用。

解決方案： 開啟遊戲設定並選擇其他可用的引擎版本。

症狀： 匯入失敗並顯示錯誤，包含預估的解壓縮大小和可用空間。

原因： 您的裝置沒有足夠的可用儲存空間來解壓縮封存檔。您通常需要至少封存檔大小的 2 倍（封存檔本身加上解壓縮後的檔案）。

解決方案： 釋放裝置上的儲存空間後重試。使用儲存空間管理器來找出可以移除的遊戲或備份。

症狀： 匯入失敗並顯示 「無法確定未壓縮的封存檔大小。封存檔是否損壞？」

原因： Spark 無法讀取封存檔的中繼資料來計算未壓縮大小。檔案可能已損壞或使用了不支援的格式變體。

解決方案： 重新下載封存檔後重試。如果問題持續存在，封存檔可能使用了非標準格式 — 請向支援團隊回報。

症狀： 匯入失敗並顯示 「無法從作業系統取得檔案權限。」

原因： iOS 未授予 Spark 存取所選檔案的權限。這可能發生在來自某些雲端儲存提供者或外部位置的檔案。

解決方案： 嘗試先將封存檔複製到「檔案」App 中的**「我的 iPhone/iPad」**區段，然後從那裡匯入。

症狀： 進度指示器凍結或匯入期間出現未列出的錯誤。

解決方案：

• 確保您有足夠的可用儲存空間（至少封存檔大小的 2 倍）
• 對於非常大的封存檔（2 GB 以上），匯入可能需要幾分鐘 — 請耐心等候
• 某些封存格式如 7z 在處理數千個散落檔案時可能非常緩慢
• 如果錯誤持續存在，請向支援團隊回報，並附上錯誤訊息和遊戲名稱

症狀： 匯入 APK 後，遊戲名稱不正確或為通用名稱。

原因： 無法從 APK 中繼資料確定遊戲名稱。

解決方案： 在遊戲庫中長按遊戲並手動重新命名。