ゲームのインポート

SparkはiOSデバイスへのRen’Pyゲームのインポートに複数の方法をサポートしています。

• 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 Modeで使用するために、ゲームの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ファイルがファイルフィルターによって非表示になる場合があります — 設定 > ゲームライブラリで無効にしてください