ソースコードを見える化する方法【結論→Sourcetrailを使う】

プログラム学生

ソースコードが複雑すぎて、どんなことになってるか分からないんですが、、、何か良い方法がありますか？

ソースコードの中身を解析して、可視化してくれる無料のツールの「Sourcetrail」というのがあるので、それを紹介するよ。

Tommy

ソースコードを見える化する概要

この記事では、ソースコードを見える化するためのツール「sourcetrail」の使い方について説明して、ソースコードをどのように見える化するのかを説明します。

ソフトウェアの開発に携わっているとよく下記のような問題に遭遇します。

自分が書いたコードであれば理解できるのですが、人が書いたコードに加えることが大半です。ですが、人が書いたコードは相当に読みにくいものです。

• ソースコードの全体像が掴みにくい
• ファイル同士がどう関係しているかわからない
• 同じ変数やマクロがどのファイルで使われているかわからない

そんな時には、sourcetrailというツールlを使うことで、問題を解決してくれます。

• ファイル、クラス、関数、属性、構造体などカテゴリ別にソースコードを把握できる
• ファイルの関連をグラフィカルに表示してくれる
• プロジェクト内でのどのファイルから変数やマクロが使われているか表示してくれる

では、「sourcetrail」のインストール方法をみていきましょう。

sourcetrailインストール方法

下記のGitHubからインストーラーをダウンロードします。

Sourcetrail · GitHub

「Sourcetrail_2019_4_61_64bit_Installer」を開きます。
（今回はSourcetrail_2019_4_61_64bit_Installerを使用しました。）

１．sourcetrail.msiを開くとインストール開始のダイアログ場所が出てきます。インストールを開始するので、「Next」を押します。

２．インストールする場所の設定画面が出てきます。そのままでOKなので、Nextを押します。

３．ショートカットをデスクトップとスタートメニューに作るかの選択画面が出てきます。私はスタートメニューだけにショートカットを作成しました。

４．全ての設定が終わったらインストールを開始します。

５．下記の画面が出ればインストールは完了です。

以上でインストールは完了です。
続いて、sourcetrailの使用方法をみていきましょう。

sourcetrail具体的な使い方

さっそく、sourcetrailを実行してみましょう。
下記のようなトップ画面が表示されました。

tictactoe_cppというサンプルプロジェクトを開いてみると、プロジェクト内のファイルやマクロ、クラス、関数がまとめられた画面が表示されました。

このブラフでは、HumanPlayerはPlayerの継承クラスで、TicTacToeクラスのSelectPlayerメソッドからインスタンスを作成され、FiledクラスのTokenメソッドを呼び出していることが分かります。