2013/03/09 visualstudio勉強会 lt 「統合開発環境の支援ツール」
TRANSCRIPT
Visual Studio勉強会LT
統合開発環境の支援ツール
2013/03/09 野田悟志@scarviz
自己紹介
名前 野田悟志@scarviz
仕事 C#で業務系システム開発
主な活動 日本Androidの会 神戸支部
GDG神戸 >最近Go言語についてブログ書いてます!
VS VS
今日はVisualStudioの素晴らしい面を
いっぱい見てきたと思います
VS VS
皆さんきっと
VisualStudioすごいVisualStudioたよりになるVisualStudioつかいやすいVisualStudioでよかったVisualStudioでAndroidしたいEclipseクソ
VS VS
プロジェクト作成からユニットテストまで開発に必要なことは何でも出来るそう
Visual Stadio ならね!
VS VS
ただ、それだと・・・
ア○プル信者と変りませんよ!
このVS信者どもめ!
VS信者の嘘
よくよく考えてくださいVisualStudioは開発者の
飯を作ってくれません!
VS信者の嘘
よくよく考えてくださいVisualStudioは開発者のために
ドキュメント整備をしてくれません!
VS信者の嘘
よくよく考えてくださいVisualStudioは開発者が将来安心して開発できるように
女の子を紹介してくれません!
一方
その点Eclipseは潔いですよ!
一方
開発環境としていまいちですそう
Eclipseならね!
VSって・・・
出来ないこともあるし、潔くも無いつまり
VSクソ
本当に申し訳ありませんでした
・・・ 。すいません。
調子に乗りました。
とはいえ
せめて
ドキュメント整備くらいやってくれたっていいじゃないか
と思いませんか?
というと
VSだけでは出来ないんですが、
実はクラスやメソッドなどの定義一覧をつくるくらいのこと
が出来るんです
本題へ
ということで
無駄に時間をつかってやったところでそろそろ本題に入ります
支援ツール
Sandcastle(サンドキャッスル)
って知ってますか?
Sandcastleとは
VSでビルドする時にXMLドキュメントコメントを出力することができるんですが、それを使って、ヘルプドキュメントを作るものです
←XMLドキュメントコメントとは これのこと
←これも
1. 必要なものを準備
Sandcastleを実行するには以下がインストールされている必要があります
・Microsoft .NET Framework Version 2.0・HTML Help Workshop
1. 必要なものを準備
2. Sandcastleをインストール
3. バッチファイルをコピー
インストール先の\Examples\Sandcastleから、build_Sandcastle.batをコピーして、任意のフォルダに格納してください
※環境変数の「DXROOT」の値がインストール先になっているのですが、最後の部分(\Sandcastle\の最後の\)は不要なので、取って保存し、PCを再起動します。ただ、間違ってはいますが、修正しなくても問題は無いようです
4. XMLファイルを出力する
5. EXE,DLL,XMLファイルを格納
build_Sandcastle.batを格納したフォルダに、ヘルプファイルを作成したい各プロジェクトのexeファイルまたはdllファイルとそのプロジェクトのxmlファイルを格納します
6. build_Sandcastle.batを編集
もしexeファイルのヘルプを出力したい場合はbuild_Sandcastle.batを編集します
MRefBuilder %2.dll /out:reflection.org→MRefBuilder %2.exe /out:reflection.org
6. build_Sandcastle.batを編集
privateなメンバやメソッドを出力する場合は、最後に「 /internal+」をつけます
MRefBuilder %2.dll /out:reflection.org↓
MRefBuilder %2.dll /out:reflection.org /internal+
7. Sandcastleの実行
コマンドプロンプトを起動し、カレントをbuild_Sandcastle.batを格納したフォルダまで移動し、下記を実行します
build_Sandcastle.bat prototype (exeまたはdllファイル名の拡張子なし)chm
7. Sandcastleの実行
「prototype」部分はprototype / vs2005 / hanaから選べます出力されるヘルプファイルの内容の形式が変ります
「chm」部分はhtml / chm / hxs / mshcから選べます出力されるヘルプファイル形式になります
8. 気長に待ちましょう
結構時間かかるので、気長に待ちましょう。
完成したヘルプファイルは、Outputフォルダか、chmファイルの場合、chmフォルダが作成され、その中に格納されています。
MSDNのリファレンスみたいな感じに仕上がったものが出来ていると思います。
完成したもの
ちょっと工夫する
ちょっとしたドキュメント、というものでなく、結構確りしたものができますね
exe,dll,xmlファイルをコピーしたり、build_Sandcastle.batを実行したりするバッチファイルを作っておくのがオススメです
※各フォルダは実行毎にクリアされるので、複数のヘルプファイルを一度に作成する場合は、作成したヘルプファイルを退避させる必要があるので気をつけてください!
ということで
こういう支援ツールに恵まれている面もあります
Visual Stadio ならね!
おわり
ご清聴ありがとうございました!