コンテンツにスキップ

ログビューア

ログビューアでは、ゲームがエラーやクラッシュに遭遇した際に生成されるRen’Pyトレースバックログを確認できます。

Ren’Pyゲームがゲームプレイ中にクラッシュまたはPythonエラーに遭遇すると、エンジンはゲームのディレクトリにtraceback.txtファイルを書き込みます。ゲームが終了すると、Sparkは自動的に:

  1. traceback.txtファイルを検出
  2. Sparkのシステム情報(iOSバージョン、Sparkバージョン、エンジンバージョン、ゲーム設定、デバイス構成)を追加
  3. ファイルにタイムスタンプを付けてリネーム(例:traceback_20260311_143022.txt
  4. ゲームディレクトリ内のlogs/フォルダに移動

各クラッシュごとに個別のログファイルが生成されるため、ゲームのエラー履歴を確認できます。

ログビューアはゲーム詳細画面からアクセスできます。ゲームに1つ以上のトレースバックログがある場合、緑色のLogsボタンが表示されます。

ゲーム終了直後にトレースバックが検出された場合、Sparkはログファイルが確認可能であることをアラートで通知し、すぐに表示するオプションを提供します。

ログにはRen’Pyトレースバック — ゲーム実行中に何が問題だったかを説明するPythonエラーメッセージとスタックトレースが含まれています。各ログの末尾にはSparkのシステム情報も追加されます:

  • 使用されたRen’Pyエンジンバージョン
  • iOSバージョンとSparkバージョン/ビルド番号
  • 完全なアプリおよびゲーム設定
  • 翻訳設定(有効な場合)
  • デバイスバリアントの上書き(設定されている場合)

ログブラウザは、選択されたゲームのすべての保存済みトレースバックファイルを新しい順に表示します。各エントリにはファイル名と作成日が表示されます。ログをタップすると全文を表示できます。

ログを表示中に、サポートチームと共有できます:

  • 共有ボタン — iOSの共有シートを開き、トレースバックを任意のアプリ(メール、クラウドストレージ、メッセージングなど)でエクスポート
  • サポートへメール — トレースバックファイルを添付してSparkサポートメールに直接送信

ログブラウザメニューからゲームのすべてのログを削除できます。これにより、そのゲームのlogs/フォルダ全体が削除されます。

トラブルシューティングにログを活用する

Section titled “トラブルシューティングにログを活用する”

サポートチームに問題を報告する際:

  1. ゲームを起動して問題を再現する
  2. クラッシュ後、ゲーム詳細画面からログビューアを開く
  3. 最新のトレースバックログをDiscordまたはメールで共有

トレースバックと追加されたシステム情報により、サポートチームが問題を診断するために必要な詳細が提供されます。

一般的なトレースバックメッセージ

Section titled “一般的なトレースバックメッセージ”
メッセージ意味
SystemExitゲームが正常に終了したか、Sparkによって終了された
ImportErrorPythonモジュールが見つからない — 別のエンジンバージョンが必要かもしれません
IOError / FileNotFoundErrorゲームアセットまたはファイルが見つからない
MemoryErrorデバイスのメモリが不足 — Jetsamを参照
pickleエラーセーブファイルの互換性の問題 — セーブの問題を参照