2014年5月20日火曜日

doxygen+graphvizでXCodeプロジェクトのクラス図を作る

特に自分がハマった点を中心に。

・・メモる前に間違えてターミナルを閉じてしまって途方に暮れている。。
思い出す限りで書きます。。ショック。


環境: OSX 10.9.2

主な参考記事
http://qiita.com/paming/items/b40662d4e3494c00ae30


doxygenとgraphvizをインストール

Homebrewを使いました。

brew install doxygen graphviz

以下ログ
==> Downloading http://ftp.stack.nl/pub/users/dimitri/doxygen-1.8.3.1.src.tar.gz

################################################################## 100.0%

==> ./configure –prefix /usr/local/Cellar/doxygen/1.8.3.1
==> make
==> make MAN1DIR=share/man/man1 install
Warning: Could not link doxygen. Unlinking…
Error: The brew link step did not complete successfully
The formula built, but is not symlinked into /usr/local
You can try again using `brew link doxygen’
Error: Permission denied - /usr/local/opt

パーミッションエラーが・・・
https://github.com/Homebrew/homebrew/issues/19670
こちらの解決策に従います。

sudo chmod -R $USER /usr/local
ドキドキしながらchmod。

もう一度チャレンジ。
brew install doxygen graphviz

今度は、doxygenはインストールできたが、graphvizが出来ない模様。
libpngが404でErrorとか言われる。

https://github.com/Homebrew/homebrew/issues/20109
これこれ。これが発生。

というわけで、
brew update
を実行する。

・・updateできない。。

http://boiled-octopus.blog.so-net.ne.jp/2013-03-24
これこれ。これが発生。

上の記事を参考に、
git diff
とやったら抜けられなくなって焦るgit初心者。
qとかwqとか叩いたら抜けられたような・・うろ覚え。

git statusで、masterに変更が無い状態にできたのを確認して、
再度brew updateを実行する。

・・できた!!

この状態で、
brew install graphviz
してみると、成功。
doxygenとgraphvizがインストールできた模様。


XCodeのプロジェクトをdoxygenしてみる

htmlフォルダが作られてしまうので、
対象のプロジェクトをコピーしたものにdoxygenしました。ビビリなもので。
対象のプロジェクトのディレクトリに入ります。
AppDelegateがある階層にしました。(どこでも良いでしょう)

doxygen -g

を実行すると、「DoxyFile」というファイルが生成される。
vim使いではない私は、これをファイルエディタ等で開いて、中身を編集。

http://momijiame.tumblr.com/post/23166110981/doxygen-graphviz
http://www.fides.dti.ne.jp/~oka-t/doxygen.html
こちらの記事を参考にしました。
前者の方と同じ内容で実行しています。

さあ、 いざdoxygen!

doxygen

ずらずら〜〜〜とファイルが生成されていきました。
やった!

同じ階層に出来上がったhtmlフォルダのindex.htmlを開く。
Classes - Class Hierarchy
生成されたクラス図を見る事ができました。わいわい!

以上です。