Development/FAQs/Debugging FAQ/ja: Difference between revisions

    From KDE TechBase
    (Created page with "===デバッグ用の出力を標準エラー (stderr) に出したいのですが、おすすめの方法は何ですか?===")
    (Updating to match new version of source page)
    (14 intermediate revisions by one other user not shown)
    Line 30: Line 30:
    いったん core ファイルが手に入ったら、"gdb appname core" で調べることができます。これで gdb は与えられたアプリケーション用に core ファイル上でオープンできます。gdb のプロンプトが出たら、<code>bt</code> というコマンドが役に立ちます。これはクラッシュのバックトレースを生成することができます。gdb の使い方についてもっと情報がほしいなら、[[Special:myLanguage/Development/Tutorials/Debugging/Debugging_with_GDB|こちらのページ]]を見て下さい。
    いったん core ファイルが手に入ったら、"gdb appname core" で調べることができます。これで gdb は与えられたアプリケーション用に core ファイル上でオープンできます。gdb のプロンプトが出たら、<code>bt</code> というコマンドが役に立ちます。これはクラッシュのバックトレースを生成することができます。gdb の使い方についてもっと情報がほしいなら、[[Special:myLanguage/Development/Tutorials/Debugging/Debugging_with_GDB|こちらのページ]]を見て下さい。


    ===What tools are available to debug my application?===
    ===アプリケーションのデバッグツールにはどのようなものがありますか?===


    *kDebug() (kdDebug() in KDE3) calls are a simple but efficient way to debug an application.
    <span class="mw-translate-fuzzy">
    *gdb, the GNU debugger, is the quickest way to execute step-by-step and investigate variables (recommended versions are gdb >= 6.x)
    *kDebug() (KDE3 では kdDebug()) の呼び出しはシンプルですが効率の良いデバッグ方法です。
    *Valgrind
    *gdb (Gnu debugger) は1ステップずつ実行し、変数がどんな値にセットされているか調べるもっとも手っ取り早い方法です。(バージョン6以上がおすすめです)
    *kdbg is a nice graphical frontend to gdb with a KDE GUI. It has support for many Qt types (including QString).
    *kdbg は KDE 用の gdb フロントエンドです。多くの Qt の型(QString を含む)をサポートしています。
    *Memory leak tracer : See kdesdk/kmtrace. The README explains it all.
    *Memory leak tracer: kdesdk/kmtrace を見て下さい。README に解説があります。
    *qdbus and dbus-viewer from Qt allow to browse DBus interfaces and to easily make DBus calls.
    *Qt の qdbus dbus-viewer DBus インターフェースをブラウズしたり、DBus コールを簡単に作成したりできます。
    </span>


    Check [[Special:myLanguage/Development/Tools|this page]] and kdesdk, there are a bunch of useful scripts there.
    [[Special:myLanguage/Development/Tools|このページ]]kdesdk をチェックして下さい。便利なスクリプトが集まっています。


    ===How do I print a QString in gdb?===
    ===QString の文字列を gdb で出力するにはどうしたら良いですか?===


    Check out kdesdk, and add this line to your ~/.gdbinit :
    kdesdk をチェックアウトし ~/.gdbinit に以下の行を加えて下さい。{{Input|1=source /path/to/kde/sources/kdesdk/scripts/kde-devel-gdb}}
    {{Input|1=source /path/to/kde/sources/kdesdk/scripts/kde-devel-gdb}}
    そうすれば、gdb で <code>printqstring myqstring</code> とすることで内容を見ることができます。
    Then in gdb you can do <code>printqstring myqstring</code> to see its contents.
    たとえば、<code>QString myqstring=QString::fromLatin1("contents")</code> は次のマクロで調べることができます。
    For instance, <code>QString myqstring = QString::fromLatin1("contents");</code> can be examined using


    {{Input|1=
    {{Input|1=
    Line 52: Line 52:
    $1 = "content"}}
    $1 = "content"}}


    See the <tt>kde-devel-gdb</tt> file for the other macros it defines.
    定義されている他のマクロを知るには <tt>kde-devel-gdb</tt> を見て下さい。


    ===I have no symbol when I debug an app that uses kpart, what should I do?===
    ===KPart を使っているアプリケーションをデバッグしているとき、デバッグシンボルがありません。どうするべきですか?===


    You must stop just after the main to load the debugging symbols of the shared library. After that, you can debug normally.
    main が共有ライブラリーのデバッグシンボルをロードした直後に止める必要があります。そうすれば後は普通にデバッグできます。
    One can go as far as creating a gdb macro, to stop right after the part was loaded. For kword, by example, I use:
    kpart がロードされた直度に止めるために、gdb のマクロを作ることだってできます。KWord を例にすると、わたしは以下のマクロの定義を使っています。
    {{Input|1=
    {{Input|1=
    define startkword
    define startkword
    Line 65: Line 65:
                           QObject *, char const *, bool)' cont}}
                           QObject *, char const *, bool)' cont}}


    ===How do I debug an ioslave?===
    ===ioslave をデバッグするにはどうすればよいですか?===


    See [[Development/Tutorials/Debugging/Debugging IOSlaves|debugging ioslaves]]
    [[Development/Tutorials/Debugging/Debugging IOSlaves|ioslave のデバッグ]]を参照してください。


    === Why isn't my signal and slot connection working? ===
    === Why isn't my signal and slot connection working? ===
    Line 87: Line 87:
    ===デバッグ用の出力を標準エラー (stderr) に出したいのですが、おすすめの方法は何ですか?===
    ===デバッグ用の出力を標準エラー (stderr) に出したいのですが、おすすめの方法は何ですか?===


    Yes, you must use kDebug():
    kDebug() を使うとよいでしょう。


    <syntaxhighlight lang="cpp-qt">
    <syntaxhighlight lang="cpp-qt">
    Line 94: Line 94:
    </syntaxhighlight>
    </syntaxhighlight>


    The syntax is much like cout, you can use many native types between the "<<". This will print out a debugging message, which will automatically be turned off at release time (by <tt>--disable-debug</tt>). In case you want the message to still be there during releases, because it's a warning or an error, use <tt>kWarning()</tt> or <tt>kError()</tt>.
    文法は cout とほとんど同じで、多くのネイティブな型を "<<" の間に使えます。これはデバッグメッセージを出力しますが、リリース時に(<tt>--disable-debug</tt> )自動的に無効にすることができます。もし、メッセージをリリース中も出力したいならば、それらは警告やエラーなので <tt>kWarning()</tt> <tt>kError()</tt> を使って下さい。


    Components and libraries are advised to use a debug area number, as in kDebug(1234). For this, the number must be registered in kdelibs/kdecore/kdebug.areas. Debug areas make it possible to turn off or on the debug output for specific area numbers, using the {{program|kdebugdialog}} program, which is part of kdebase. <tt>kdebugdialog --fullmode</tt> also permits to control where to log debug output. It is usually not necessary to register area numbers for standalone applications, unless it's so complex that you want to divide the output into several areas.
    コンポーネントやライブラリなどは kDebug(1234) などのようにデバッグエリアナンバーを使うようにアドバイスされています。このためには、kdelibs/kdecore/kdebug.area にその数字が登録されていなければいけません。デバッグエリアのお陰で、特定のエリアナンバーのデバッグ出力を無効にすることができます。そのためには {{program|kdebugdialog}} という kdebase の一部であるプログラムを使います。<tt>kdebugdialog --fullmode</tt> によってまた、デバッグ出力のログをどこに取るか制御することもできます。普段、スタンドアローンなアプリケーションのためにエリアナンバーを登録することは、そのアプリケーションが複雑で出力をいくつかのエリアに分割したいと思うことが無ければ、必要ありません。


    It is possible to omit the debug area number when calling kDebug by adding the following code to your top-level CMakeLists.txt:
    It is possible to omit the debug area number when calling kDebug by adding the following code to your top-level CMakeLists.txt:
    Line 106: Line 106:
    For more information, about this, see [http://www.kdedevelopers.org/node/3171 Allen Winter's blog post].
    For more information, about this, see [http://www.kdedevelopers.org/node/3171 Allen Winter's blog post].


    To make it clear: do NOT use <tt>qDebug()</tt>, this one does not get disabled at releases. Also avoid using <tt>assert()</tt> or <tt>kFatal()</tt> which lead to a crash when something goes wrong and that is not a nice experience for the user. Better detect the error, output a <tt>kWarning()</tt> or <tt>kError()</tt>, and recover if possible.
    <tt>qDebug()</tt> を使ってはいけないということだけははっきり覚えておいて下さい。それはリリース時に無効になりません。また、<tt>assert()</tt> <tt>kFatal()</tt> を使うことも避けて下さい。それらは何かアプリケーションないでまずいことが起きた場合、アプリをクラッシュさせてしまいます。決してユーザーにとって良いものではないのです。エラーを発見する良い方法は <tt>kWarning()</tt> <tt>kError()</tt> を使って下さい。そして、できる限りそのエラーから回復させて下さい。


    To get timestamps with your debug output, which are useful for debugging multi-threaded, networked and asynchronous operations, <tt>export KDE_DEBUG_TIMESTAMP=1</tt> before running your app. Since KDE SC 4.5.
    To get timestamps with your debug output, which are useful for debugging multi-threaded, networked and asynchronous operations, <tt>export KDE_DEBUG_TIMESTAMP=1</tt> before running your app. Since KDE SC 4.5.

    Revision as of 19:16, 31 May 2012

    一般

    Dr Konqi が出ないようにするにはどうしたら良いですか?

    KDE_DEBUG 環境変数を1に設定してください。

    To get Dr Konqi back, unset the KDE_DEBUG environment variable.

    Example:

    • To avoid Dr Konqi:
    export KDE_DEBUG=1
    • To see Dr Konqi:
    unset KDE_DEBUG

    How do I switch Dr Konqi to developer mode?

    Edit file $KDEHOME/share/config/drkonqirc and add the following:

    [drkonqi]
    ConfigName=developer
    

    core ファイルって何ですか? どうすれば core ファイルを得ることができますか?

    core ファイルとはアプリケーションがクラッシュしたときのメモリイメージです。これを使うことによって、どの変数がセットされていたり、どこでアプリがクラッシュしたかを知ることができます。

    いくつかのディストリビューションでは core ファイルの生成を不可にしています。生成できるようにするには ulimit -c unlimited を実行してください。

    いったん core ファイルが手に入ったら、"gdb appname core" で調べることができます。これで gdb は与えられたアプリケーション用に core ファイル上でオープンできます。gdb のプロンプトが出たら、bt というコマンドが役に立ちます。これはクラッシュのバックトレースを生成することができます。gdb の使い方についてもっと情報がほしいなら、こちらのページを見て下さい。

    アプリケーションのデバッグツールにはどのようなものがありますか?

    • kDebug() (KDE3 では kdDebug()) の呼び出しはシンプルですが効率の良いデバッグ方法です。
    • gdb (Gnu debugger) は1ステップずつ実行し、変数がどんな値にセットされているか調べるもっとも手っ取り早い方法です。(バージョン6以上がおすすめです)
    • kdbg は KDE 用の gdb フロントエンドです。多くの Qt の型(QString を含む)をサポートしています。
    • Memory leak tracer: kdesdk/kmtrace を見て下さい。README に解説があります。
    • Qt の qdbus と dbus-viewer は DBus インターフェースをブラウズしたり、DBus コールを簡単に作成したりできます。

    このページや kdesdk をチェックして下さい。便利なスクリプトが集まっています。

    QString の文字列を gdb で出力するにはどうしたら良いですか?

    kdesdk をチェックアウトし ~/.gdbinit に以下の行を加えて下さい。

    source /path/to/kde/sources/kdesdk/scripts/kde-devel-gdb

    そうすれば、gdb で printqstring myqstring とすることで内容を見ることができます。 たとえば、QString myqstring=QString::fromLatin1("contents") は次のマクロで調べることができます。

    (gdb) printqstring myqstring
    $1 = "content"

    定義されている他のマクロを知るには kde-devel-gdb を見て下さい。

    KPart を使っているアプリケーションをデバッグしているとき、デバッグシンボルがありません。どうするべきですか?

    main が共有ライブラリーのデバッグシンボルをロードした直後に止める必要があります。そうすれば後は普通にデバッグできます。 kpart がロードされた直度に止めるために、gdb のマクロを作ることだってできます。KWord を例にすると、わたしは以下のマクロの定義を使っています。

    define startkword
    break main
    run
    break 'KoDocument::KoDocument(int, QWidget *, char const *, 
                           QObject *, char const *, bool)' cont

    ioslave をデバッグするにはどうすればよいですか?

    ioslave のデバッグを参照してください。

    Why isn't my signal and slot connection working?

    Here are some steps that you can use to troubleshoot why your signal/slot connection is not working (your slot does not get called for some reason).

    1) Verify that the connect() doesn't print a warning to the console at runtime.

    If it does, check that you wrote Q_OBJECT, that the parameter names are not in the connect, that the parameter types are compatible, and that the slot is defined, and that the moc was compiled.

    1b) Or you can just check to see what connect() returns as a bool. Although this won't give you the error message. 2) Verify that the signal is indeed emitted 3) Verify that the receiver isn't already deleted at that time 4) Verify that emitter->signalsBlocked() returns false


    KDE 4 specific

    デバッグ用の出力を標準エラー (stderr) に出したいのですが、おすすめの方法は何ですか?

    kDebug() を使うとよいでしょう。

    #include <kdebug.h>
    kDebug() << "KMyApp just started";
    

    文法は cout とほとんど同じで、多くのネイティブな型を "<<" の間に使えます。これはデバッグメッセージを出力しますが、リリース時に(--disable-debug で)自動的に無効にすることができます。もし、メッセージをリリース中も出力したいならば、それらは警告やエラーなので kWarning()kError() を使って下さい。

    コンポーネントやライブラリなどは kDebug(1234) などのようにデバッグエリアナンバーを使うようにアドバイスされています。このためには、kdelibs/kdecore/kdebug.area にその数字が登録されていなければいけません。デバッグエリアのお陰で、特定のエリアナンバーのデバッグ出力を無効にすることができます。そのためには kdebugdialog という kdebase の一部であるプログラムを使います。kdebugdialog --fullmode によってまた、デバッグ出力のログをどこに取るか制御することもできます。普段、スタンドアローンなアプリケーションのためにエリアナンバーを登録することは、そのアプリケーションが複雑で出力をいくつかのエリアに分割したいと思うことが無ければ、必要ありません。

    It is possible to omit the debug area number when calling kDebug by adding the following code to your top-level CMakeLists.txt:

    add_definitions(-DKDE_DEFAULT_DEBUG_AREA=XXXX)

    For more information, about this, see Allen Winter's blog post.

    qDebug() を使ってはいけないということだけははっきり覚えておいて下さい。それはリリース時に無効になりません。また、assert()kFatal() を使うことも避けて下さい。それらは何かアプリケーションないでまずいことが起きた場合、アプリをクラッシュさせてしまいます。決してユーザーにとって良いものではないのです。エラーを発見する良い方法は kWarning()kError() を使って下さい。そして、できる限りそのエラーから回復させて下さい。

    To get timestamps with your debug output, which are useful for debugging multi-threaded, networked and asynchronous operations, export KDE_DEBUG_TIMESTAMP=1 before running your app. Since KDE SC 4.5.