Bazelでプロジェクトの依存関係を可視化する

依存関係をグラフで確認する 

実際の手順

BUILD ファイルのルールによってビルドに成功した場合、Bazel はプロジェクトの依存関係をグラフ化して作成しています。 Bazel はこの情報を使用して差分ビルド行いますが、これを可視化することも出来ます。

サンプルプロジェクトのグラフ情報を可視化してみましょう。

初めに、Bazel が作成した依存関係のグラフ情報をテキスト表現に変換しましょう。

bazel query --notool_deps --noimplicit_deps 'deps(//main:hello-world)' --output graph

このコマンドは、//main:hello-world ターゲットに含まれる依存関係をグラフとして出力するものです。
ただし、このグラフには標準ライブラリや暗黙的な依存関係は含まれません。(そんなもん表示されたら収拾つかないし) このコマンドに成功すると、以下のようなテキスト表現がプロンプト上に表示されます。

digraph mygraph {
  node [shape=box];
  "//main:hello-world"
  "//main:hello-world" -> "//main:hello-world.cc"
  "//main:hello-world.cc"
}
Loading: 0 packages loaded

このテキストをコピーして、GraphVizオンライン版にペーストすることで手軽に確認することが出来ます。

実使用するのであれば、

bazel query --notool_deps --noimplicit_deps 'deps(//main:hello-world)' --output graph > result.txt

などとしてファイル出力してしまったほうが使いやすいかもしれません。

 実行環境が Ubuntu の場合は、GrawphViz と xdot をインストールすることで、ローカル環境でグラフを確認することが出来ます。

sudo apt update && sudo apt install graphviz xdot

GrawphViz と xdot をインストールしたら、Linux のパイプを使って xdot に出力を直接渡して表示させることが出来ます。
保存や印刷も可能です。

xdot <(bazel query --notool_deps --noimplicit_deps 'deps(//main:hello-world)' --output graph)

実際にやってみた場合の表示はこんな感じ