Simulinkモデルのバージョン管理（４）
Simulinkモデルのバージョン管理（３）からの続きです。今回はテキストファイルのバージョン管理を行います。
分散型バージョン管理システムとして、MercurialベースのKiln（FogCreek社）を採用しました。
やることは、次の５つです。
- リポジトリを作る
- リポジトリにファイルを保存する
- コードレビューする
- バージョンを戻したり、差分を見たりする
- 複数の人が別々に行った変更を、統合する
前回は上２つをやりましたので、今回は続きの２つをやります。
コードレビューする
Kilnには、コードレビュー機能があります。残念ながらSimulinkモデルのレビューはできません。しかし、m-fileや、S-Functionのソースコードなど、テキストファイルであればレビュー対象とする事が出来ます。
レビューを行うには、次の２つの条件が必要です。
- リポジトリが存在すること
- リポジトリに対し、HG Commit が行われていること
（他のレビューシステムをご存じの方へ： オープンソースのレビューシステムは、コミット前のパッチに対してレビューを行うものがほとんどです。一方このKilnは、コミット後のChangesetに対してレビューを行います。）
レビュー開始
（中央サーバーに、任意のマシンのWebブラウザでアクセス）
Kilnでは、リポジトリに対して行われた Commit 単位でレビューを実行します。レビュー開始は、New Review ボタンをクリックするだけです。
リポジトリのHistoryページにある、New Review ボタン
対象となるCommit、およびレビューアを指定
この結果、１つの「レビュー」が生成されました。
生成されたレビュー
左半分には、レビューアが記入したコメントが表示されます。右半分には、どのファイルがどう変更されたのか？が表示されます。
レビューコメント記入
（中央サーバーに、任意のマシンのWebブラウザでアクセス）
Kilnのレビュー画面では、各ファイルの変更箇所が色分けされて表示されます。
レビューアは、特定の行についてのコメントを記述することができます。そのためには、コメント入れしたい行を選択状態にします。
行を選択すると、コメント入力欄がポップする
ここで現れたコメント入力欄に、なにかコメントを入れましょう。コメントを入れた結果、次のようになります。
入力したコメントが反映された
レビューを終了する
（中央サーバーに、任意のマシンのWebブラウザでアクセス）
レビューを行ったら、結局これは良かったのか？悪かったのか？結論をださないといけません。
レビューの結果を選択する
レビュー結果は、以下の３つから選べるようになっています。
- Approved オッケーです。
- Rejected ダメです。修正しましょう。
- Won’t Review レビューしません。他の人に頼んで。。。
結果を選択すると、レビュー画面は次のようになります。
終了したレビューの画面
StatusとしてはClosedになっていますが、閲覧はいつでも出来ます。もしもRejectされた場合には、これを見ながら悪い点を修正していきます。
バージョンを戻したり、差分を見たりする
以前はちゃんと動いていたのに、いろいろ触ってたら動かなくなった！
こういう場合には、バージョンを戻してみたり、差分を見てみたり、いろいろしたくなる事でしょう。
分散型バージョン管理システムでは、リポジトリは開発PCに丸ごとコピーされます。ですから、これらの作業はすべて開発PCのみで行えます。車載試験のために中央サーバーと切り離されていても大丈夫です。
特定のバージョンを取り出す
（開発PCのみを使用する）
今つかっているフォルダから別のフォルダへ、特定のバージョンを取り出すことができます。以前動いていたのに・・・？という場合、その動いていた頃のバージョンを取り出して実験してみると良いでしょう。
別のフォルダへ特定バージョンを取り出す
まずは、どんなバージョンがあるか確認するため、TortoiseHGのHg Repository Explorerを起動します。
Mercurialでは、バージョンを Changeset と呼ぶ
１回Commitする度にChangesetというのが出来ます。これにはIDがついていて、これを指定することで特定バージョンを取り出せます。
試しに、バージョン０を取り出す場合、TortoiseHGのclone画面で次のような指定をします。
TortoiseHGのcloneコマンド
Source path には、今まで使っていたフォルダを指定します。
Destination pathには、新しく取り出すフォルダを指定します。
Advanced optionsの Clone to revisionにチェックを入れ、ここに先ほどのChangesetのIDを入力します。上図のように ０ と入力しても構いませんし、長いIDである23f584c1e1a0を指定しても構いません。
この作業を行った結果、あらたなフォルダに特定のバージョンを取り出すことができました。
バージョン０を取り出した
特定のバージョンとの差分を見る
（開発PCのみを使用する）
さて、特定のバージョンを取り出して動いていることを確認しました。でも、今のバージョンでは動きません。じゃあ、何が違うというのでしょうか？
こういった場合には、特定のバージョンと、現在のバージョンの違いを確認しましょう。
特定のバージョンとの違いを見る
そのためには、TortoiseHGのHg Repository Explorerを使用します。比べたいバージョンを選択して右クリックし、Diff to local を選択します。
Diff to localコマンド
すると、変更のあったファイル名の一覧が表示されます。
ためしに、my_mfile.mをダブルクリックしてみましょう。
その結果、次のようなdiffが表示されます。
特定のバージョンとの違いが見られる
この画面で、何がどう違っているかを確認できます。
ちなみに、今回はテキストの比較のみをあつかっています。次々回はSimulinkモデル同士をグラフィカルに比較する方法をご紹介します。
特定のバージョンに名前を付ける（＝タグ）
（開発PCのみを使用する）
こまごまとした変更を加えていくと、履歴がいっぱいになります。とあるバージョンを出荷したのであれば、ぜひそのバージョンは覚えておきたいところです。その場合、タグを打つことで解決出来ます。
そのためには、TortoiseHGのHg Repository Explorerを使用します。タグを打ちたいバージョンを選択して右クリックし、Add / Remove Tagをクリックします。
Add / Remove Tagコマンド
ここでタグを打った結果、バージョン履歴は次のようになります。
特定のバージョンに、タグがついた
ここで付けたタグは、TortoiseHg でcloneする時に指定することができます。
まとめ
今回は、Kiln上でレビューをしたり、以前のバージョンと比較を行ったりしました。
一人で開発しているのであれば、ここまでの作業で十分です。しかし、複数人で作業をしていると、これだけではすみません。次回は、複数人で開発している場合に特有の問題を解決します。