<?xml version="1.0" encoding="Shift_JIS" ?>
<doc>
<title>デバッグ</title>

<para>
<ptitle>アプリケーションのデバッグについて</ptitle>
　デバッグとは、アプリケーション内にあるバグ(機能不全や想定しない動作の原因)を特定し、修正する作業です。<r/>
　吉里吉里はいくつかのデバッグ支援機能を持っていますので、その機能を用い、アプリケーションをデバッグします。その方法について説明します。
</para>

<para>
<ptitle>デバッグ支援ウィンドウ</ptitle>
吉里吉里はデバッグを支援するためのウィンドウをいくつか提供しています。詳しくは各リンクの説明を参照してください。<r/>
<dl>
<dt><link href="Controller"/></dt>
<dd>各デバッグ支援ウィンドウを開いたり、イベント発生の停止や TJS コンテキストのダンプ、メッセージマップファイルの作成、システムの強制終了をすることができます。</dd>
<dt><link href="ScriptEditor"/></dt>
<dd>簡単な TJS スクリプトの編集とその実行をすることができます。また、例外が発生したとき、その例外の発生位置を指し示すために「スクリプトエディタ (例外通知)」というスクリプトエディタのウィンドウが開く場合があります。</dd>
<dt><link href="ExprWatch"/></dt>
<dd>多くの式の結果を一度に確認することができます。</dd>
<dt><link href="Console"/></dt>
<dd>吉里吉里のシステムや、ユーザスクリプトが出力する様々なデバッグ用メッセージを表示することができます。また、TJS2 式を入力してその場で実行し、式の結果を表示させる事もできます。</dd>
</dl>
<r/>
　特にコンソールでは、<at href="f_Debug_message.html">Debug.message</at> によってユーザプログラムがプログラム中で出力したメッセージが表示されます。プログラムの任意の場所でメソッドを呼び出し、変数の内容をコンソールに表示させ、実行中の変数の内容を見ることができます。<r/>
　また、コンソールの下部の入力欄にTJS2式を入力し、Enterキーを押すことでその式をその場で実行することができます。これは、実行中のオブジェクトのメソッドを直接呼び出したり、オブジェクトのプロパティや変数に値を代入する際に便利です。<r/>
　コンソールへメッセージを表示する方法やログをファイルに記述する方法については、<link href="CommandLine" /> の 「デバッグ関連のオプション」や <at href="f_Debug.html">Debug クラス</at> を参照してください。<r/>
</para>


<para>
<ptitle>デバッグモード</ptitle>
　<link href="CommandLine" /> で '-debug' を指定する (「デバッグモード」を'有効'にする) と、吉里吉里をデバッグモードで動作させることができます。<r/>
　デバッグモードではTJS2の動作は低速になりますが、デバッグに便利ないくつかの機能が有効になります。<r/>
<r/>
<dl>
<dt>型情報追跡機能</dt>
<dd>
　TJS2のオブジェクトに関する情報が強化されます。<r/>
　デバッグモードではない場合は、たとえば KAG で kag.saveSystemVariables の情報を得ようとしてコンソールに <tt>kag.saveSystemVariables</tt> と入力しても
<bq>
コンソール : kag.saveSystemVariables = (object)(object 0x0279E130:0x01EB0BD4)
</bq>
　と表示されるだけですが、デバッグモードが有効の場合は
<bq>
コンソール : kag.saveSystemVariables = (object)(object 0x0279E130[(function) KAGWindow.saveSystemVariables]:0x01EB0BD4[instance of class KAGWindow])
</bq>
　のように型の情報が表示されます (':' で区切られた２つの部分のうち、前の部分はオブジェクトの型、後ろの部分はそのオブジェクトが動作するコンテキストです )。<r/>
　この機能は、コンソールで値を表示させる場合にとどまらず、(現バージョンでは)オブジェクトが文字列に変換される過程すべてで有効になります。<r/>
</dd>
<dt>オブジェクトリーク検出機能</dt>
<dd>
　削除されていない(解放されていない)オブジェクトを終了時に警告する機能が有効になります。<r/>
　TJS2は本来、ガベージコレクション機能により、作成されたオブジェクトは自動的に削除され、明示的な削除の指示は必要ありません。しかし、プラグインや吉里吉里本体のバグ、循環参照が原因で、オブジェクトが削除されないままになる(リークする)可能性があります。<r/>
　デバッグモードでは、終了時になってもまだ解放されていないオブジェクトがコンソールのログファイルに書き出されます。<r/>
　たった一個のオブジェクトが解放されなかっただけでも、そのオブジェクトに関連するオブジェクトが全て検出されるため、ログファイルが巨大になる可能性がありますので注意してください。<r/>
<r/>
　<at href="f_System_exit.html">System.exit</at> メソッドは、アプリケーションを強制終了に近い形で終了させるもので、このメソッドでアプリケーションを終了させると多くのオブジェクトがリークし、大量のログが記録されますので注意してください。<r/>
<note>
循環参照とは、A は B を参照している、B は A を参照しているという状況の事です。<r/>
たとえば、以下のスクリプトは循環参照を生成します。
<bq>
var a = %[], b = %[];<r/>
a.b = b; b.a = a;
</bq>
このような状況では、オブジェクト a は b を必要とし、オブジェクト b は a を必要としています。TJS2が採用しているガベージコレクションの方法(参照カウンタ)はこのような状況を検出してオブジェクトを解放するのは困難であるため、TJS2ではこのような状況を検出しません。そのため、いつまで経ってもこれらのオブジェクトが削除されることはありません (明示的に invalidate 演算子でどちらかのオブジェクトを無効化すると循環参照を断ち切ることができます)。<r/>
<r/>
プラグインでは、参照カウンタの扱いを誤るとオブジェクトがリークする可能性があります。プラグインを作成して、その中でTJS2オブジェクトを扱う場合は、参照カウンタの扱いに十分注意してください。<r/>
</note>
</dd>
<dt>削除中のオブジェクトでのスクリプト実行の警告</dt>
<dd>
　オブジェクトは、削除あるいは無効化されるときに finalize メソッドが呼ばれます。<r/>
　オブジェクトが削除されるタイミングは、TJS2では「いつになるかわからない」ため、変なタイミングで finalize メソッドがよばれ、予期しない挙動を示す場合があります。デバッグモードでは、このような「不安定なタイミング」、つまり無効化されなかったオブジェクトがガベージコレクションによって削除され、finalizeメソッドが呼ばれたときに、警告がコンソールに表示されるようになります。<r/>
　警告は以下のような物です。<r/>
<bq>
警告: anonymous@0x016DFA7C(9)[(function) finalize]: 削除中のオブジェクト 0x0167DD44[instance of class A] 上でコードが実行されています。このオブジェクトの作成時の呼び出し履歴は以下の通りです:<r/>
                     anonymous@0x016DFA7C(13)[(top level script) global]
</bq>
　このような状況を防ぐため、new で作成したオブジェクトは、使用し終わったら明示的に invalidate 演算子で無効化することを推奨します。<r/>
　ただし、Array や Dictionary、Date のように finalize メソッドがない、あるいは finalize メソッドでは特に問題を起こすような動作を起こさないクラスのオブジェクトについては、明示的な無効化は必要ない場合があります。<r/>
　上記の警告は、明示的な無効化が無いままオブジェクトが削除されようとし、そのコンテキスト上でTJS2スクリプトが実行されようとした場合に表示されます。
</dd>

<dt>呼び出し履歴の取得機能</dt>
<dd>
　TJS2 の関数/メソッド呼び出し履歴をスクリプトから取得できるようになります。<r/>
　これには <at href="f_Scripts_getTraceString.html">Scripts.getTraceString</at> メソッドを用います。<r/>
　プログラムの途中に何か問題があり、そのメソッドがどこから呼ばれたのか分からない場合に、このメソッドを使って、呼び出し履歴をコンソールに出力したりができるようになります。<r/>
</dd>


</dl>

</para>

</doc>
