ソフトウェア設計及び演習2016

ソフトウェアを開発する際，リポジトリに格納されているファイルを直接に編集することは行いません． では，どうするのかというと，

• リポジトリの中身を，いったん，ローカルディレクトリにコピー（チェックアウト）して，
• コピーしたファイル達を編集します．
• 編集が一段落したら，編集したファイル達をリポジトリに保存（コミット（=チェックイン））します．

ここで出てくるローカルコピーのことをワーキングコピーとか，作業コピーと呼びます． 「ワーキングコピーを編集してリポジトリに保存する」ということを 繰り返し行ってソフトウェア開発を少しずつ進めていきます．

まずはリポジトリからコピーを取得する操作を行ってみましょう． コピーしたいディレクトリに移動してリポジトリの内容をコピーします． これをチェックアウトと言います．

例えば，g99班の班員が，自分のディレクトリ ~/csd/ に， g99 という名前のワーキングコピーを展開したいとしたら， 以下のコマンドを打ちます．

% cd ~/csd
% svn co https://svn.cis.iwate-u.ac.jp/svn/csd/16/g99

Tips

チェックアウトという用語を初めて聞くと「なぜチェックアウトと言うんだろう？？？」と思う方のいるかもしれません． 私の覚え方はこうです．リポジトリを「ホテル」だと思いましょう． そして，プログラムファイルやドキュメントといった成果物をホテルの「客」だと思いましょう． リポジトリというホテルに，お客さんとして成果物が泊まっていると考えたとします． 成果物は，ユーザからのコマンドによってホテルを「チェックアウト」してくるのです． 逆に，成果物をリポジトリに保存する操作はホテルへの「チェックイン」となります． しかしながら，本講義では，subversion のコマンド名を見習って 「コミット（= チェックイン）」という用語を使いますのでご了承ください．

通常のunixコマンドの頭に svn をつけると，リポジトリ上のディレクトリやファイルに対する操作になります．

使い始めのうちは，作業コピー（自分のローカルディレクトリ）上の状況と， リポジトリ上の状況を混同してしまう場合が多々あります． 通常のunixコマンドは作業コピー（自分のローカルディレクトリ）に対する操作， 頭に「svn」をつけるとリポジトリ上の操作になる，と覚えておきましょう．

ディレクトリ「Svn-test」を新たに追加したい場合は，

% svn mkdir Svn-test

のように，svn mkdirとします．また，ファイル「svn-test.txt」を新たに追加したいときは， ファイルを作った後に，リポジトリに反映させるために

% emacs svn-test.txt
(emacs を 使って svn-test.txt の中身を作成)
% svn add svn-test.txt

のようにsvn addとします．ただし，これらが真にリポジトリに登録追加されるのはコミットした時点なので注意が必要です． svn add を行った時点では，リポジトリは以前の状態のままであり，Svn-test や svn-text.txt を含みません． svn ci でコミットして初めてリポジトリに Svn-test と svn-text.txt が登録されます．

Tips

リポジトリに登録するファイルは「プロジェクトの成果物」のみにしましょう．プログラム（.cや.hなど）や，ドキュメント（READMEなど）はリポジトリに登録しますが，実行ファイル（a.outなど），オブジェクトファイル（.o），作業用ファイル（#,~のついたもの），コアファイル（.core）はリポジトリには登録しません．膨大な量の記憶領域を無駄遣いすることになってしまいます．

自分が加えた修正をリポジトリに反映させることを コミットまたはチェックインと言います． 次の svn ci というコマンドでコミットすることができます．

% svn ci -m '... Messages ...' 

「... Messages ...」の部分には，何を変更したかを書いておきます． このメッセージは必ず書かないといけません． commitする際には必ずメッセージが必要と覚えておきましょう． メッセージには，他の共同開発者に修正内容を伝える役割があります． まったく無意味なメッセージを書くことは極力避けるべきです．

上記の svn add 以外にも，ファイルやディレクトリを操作するコマンドがいくつかあります．

上記はすべて，svn add と同様に，コミット時に操作内容がリポジトリに反映されるので注意しましょう．

複数の人間で開発を行なう場合，他の人が開発を進めているかもしれません． つまり，自分のワーキングコピーは，最新のプログラムファイルでないかもしれません． そこで，編集作業を行う前に必ずワーキングコピーに （リポジトリの）最新情報を反映させる必要があります．

% cd ~/csd/proj
% svn update

Tips

自分が編集作業中でも，他の班員が作業しているかもしれません． こまめに svn update を実行するようにしましょう．

「ワーキングコピーのファイル xxx.c は，リポジトリに登録されていたっけ？」 などといった疑問が生じたときには，ワーキングコピー上のファイルの状態を 調べるということを行います． ワーキングコピー上のファイルの状態を確かめるには， （ワーキングコピーが存在するディレクトリ以下で）

% svn st

というコマンドを実行します． ファイル名の先頭にマークがつけられており， そのマークで状態を判断します．

オプションで「-u」を入れると，リビジョン番号の情報が， 「-v」 を入れると，各ファイルのリビジョン番号の情報が表示されます．