インポートの問題

症状： インポートしようとすると、ゲームファイルがグレーアウトしているか表示されない。

原因： 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は展開されたアーカイブ全体を再帰的に検索するレガシースキャンをフォールバックとして実行します。このエラーは、レガシー検出でも有効なゲームを見つけられなかったことを意味します。

解決方法：

• アーカイブの構造に互換性がない可能性があります。ゲームの別のバージョンまたはプラットフォームのアーカイブを試してください
• PCでアーカイブを展開し、フォルダ構成を確認し、game/フォルダが期待されるレベルにある標準的なZIPとして再パッケージしてください
• ゲーム名を添えてサポートチームに問題を報告してください

症状： ゲームが 「Ren’Pyバージョンを特定できません。起動を中止します。」 というメッセージで起動しない、またはエンジンバージョンの指定を求めるプロンプトが表示される。

原因： Sparkがゲームに必要なRen’Pyバージョンを自動的に検出できませんでした。

解決方法： ゲーム設定（ゲームを長押し）を開き、Ren’Pyバージョンの横の変更をタップして、正しいエンジンバージョンを手動で選択してください。不明な場合は、古いゲームには最新の7.xバージョン、新しいゲームには最新の8.xバージョンを試してください。

症状： エラー 「要求されたエンジンバージョンが見つかりません。」 で起動に失敗する。

原因： ゲームに選択されたエンジンバージョンがデバイスで利用できません。

解決方法： ゲーム設定を開き、別の利用可能なエンジンバージョンを選択してください。

症状： 推定解凍サイズと利用可能な容量を示すエラーでインポートが失敗する。

原因： デバイスにアーカイブを展開するのに十分な空きストレージがありません。通常、少なくともアーカイブサイズの2倍（アーカイブ自体と展開されたファイル）が必要です。

解決方法： デバイスのストレージを解放して再試行してください。ストレージマネージャーを使用して、削除できるゲームやバックアップを特定してください。

症状： インポートが 「解凍後のアーカイブサイズを特定できません。アーカイブが破損していませんか？」 で失敗する。

原因： Sparkがアーカイブのメタデータを読み取って解凍サイズを計算できませんでした。ファイルが破損しているか、フォーマットのサポートされていないバリアントである可能性があります。

解決方法： アーカイブを再ダウンロードして再試行してください。問題が続く場合、アーカイブが非標準フォーマットを使用している可能性があります。サポートチームに報告してください。

症状： インポートが 「オペレーティングシステムからファイル権限を取得できません。」 で失敗する。

原因： iOSがSparkに選択されたファイルへのアクセス権限を付与しませんでした。これは、特定のクラウドストレージプロバイダーや外部の場所からのファイルで発生する可能性があります。

解決方法： まずファイルアプリのこのiPhone/iPad内セクションにアーカイブをコピーしてから、そこからインポートしてみてください。

症状： 進捗インジケーターがフリーズするか、インポート中にリストにないエラーが表示される。

解決方法：

• 十分な空きストレージがあることを確認する（少なくともアーカイブサイズの2倍）
• 非常に大きなアーカイブ（2 GB以上）の場合、インポートに数分かかることがあります — お待ちください
• 7zなどの一部のアーカイブ形式は、数千のファイルがばらばらにある場合、非常に遅くなることがあります
• エラーが続く場合、エラーメッセージとゲーム名を添えてサポートチームに報告してください

症状： APKをインポートした後、ゲームの名前が正しくないまたは汎用的な名前になる。

原因： APKメタデータからゲーム名を特定できませんでした。

解決方法： ライブラリでゲームを長押しし、手動で名前を変更してください。