ログビューア
ログビューアでは、ゲームがエラーやクラッシュに遭遇した際に生成されるRen’Pyトレースバックログを確認できます。
ログの取得方法
Section titled “ログの取得方法”Ren’Pyゲームがゲームプレイ中にクラッシュまたはPythonエラーに遭遇すると、エンジンはゲームのディレクトリにtraceback.txtファイルを書き込みます。ゲームが終了すると、Sparkは自動的に:
traceback.txtファイルを検出- Sparkのシステム情報(iOSバージョン、Sparkバージョン、エンジンバージョン、ゲーム設定、デバイス構成)を追加
- ファイルにタイムスタンプを付けてリネーム(例:
traceback_20260311_143022.txt) - ゲームディレクトリ内の
logs/フォルダに移動
各クラッシュごとに個別のログファイルが生成されるため、ゲームのエラー履歴を確認できます。
ログビューアへのアクセス
Section titled “ログビューアへのアクセス”ログビューアはゲーム詳細画面からアクセスできます。ゲームに1つ以上のトレースバックログがある場合、緑色のLogsボタンが表示されます。
ゲーム終了直後にトレースバックが検出された場合、Sparkはログファイルが確認可能であることをアラートで通知し、すぐに表示するオプションを提供します。
ログに表示される内容
Section titled “ログに表示される内容”ログにはRen’Pyトレースバック — ゲーム実行中に何が問題だったかを説明するPythonエラーメッセージとスタックトレースが含まれています。各ログの末尾にはSparkのシステム情報も追加されます:
- 使用されたRen’Pyエンジンバージョン
- iOSバージョンとSparkバージョン/ビルド番号
- 完全なアプリおよびゲーム設定
- 翻訳設定(有効な場合)
- デバイスバリアントの上書き(設定されている場合)
ログブラウザ
Section titled “ログブラウザ”ログブラウザは、選択されたゲームのすべての保存済みトレースバックファイルを新しい順に表示します。各エントリにはファイル名と作成日が表示されます。ログをタップすると全文を表示できます。
ログを表示中に、サポートチームと共有できます:
- 共有ボタン — iOSの共有シートを開き、トレースバックを任意のアプリ(メール、クラウドストレージ、メッセージングなど)でエクスポート
- サポートへメール — トレースバックファイルを添付してSparkサポートメールに直接送信
ログブラウザメニューからゲームのすべてのログを削除できます。これにより、そのゲームのlogs/フォルダ全体が削除されます。
トラブルシューティングにログを活用する
Section titled “トラブルシューティングにログを活用する”サポートチームに問題を報告する際:
トレースバックと追加されたシステム情報により、サポートチームが問題を診断するために必要な詳細が提供されます。
一般的なトレースバックメッセージ
Section titled “一般的なトレースバックメッセージ”| メッセージ | 意味 |
|---|---|
SystemExit | ゲームが正常に終了したか、Sparkによって終了された |
ImportError | Pythonモジュールが見つからない — 別のエンジンバージョンが必要かもしれません |
IOError / FileNotFoundError | ゲームアセットまたはファイルが見つからない |
MemoryError | デバイスのメモリが不足 — Jetsamを参照 |
pickleエラー | セーブファイルの互換性の問題 — セーブの問題を参照 |