お絵かきプログラミングのサンプルを開発する

このページでは、Eclipse と Git を使って、「お絵かきプログラミング」（Java 版）のサンプルを開発する手順を説明する。

SourceTree からライブラリのリポジトリをクローンする。

「お絵かきプログラミング」のライブラリは頻繁に変更される可能性があるので、変更を反映しやすいように Git で管理する。

SourceTreeを起動して、「新規／クローンを作成する」をクリックして、「元のパス／URL」に「http://guppy.eng.kagawa-u.ac.jp/GitRepos/BookCover.git」と入力する。
「保存先のパス」の部分をクリックすると、デフォルトの保存先が選択される。（必要があれば変更する）
「ソースを確認中…」のあとに「これは Git リポジトリです」と表示されたら、「クローン」をクリックする。
「Branch Selection」ではそのまま「Next」をクリックする。
「Local Destination」で「Directory:」に適切なパス（例えば、 C:\Users\YourId\Documents\BookCover）を指定して、「Next」をクリックする。
「Select a wizard to use for importing projects」で「Import existing projects」にチェックして「Next」をクリックする。
「Finish」をクリックする。

さきほど、クローンしたリポジトリを Eclipse から作業できるように import する。

Eclipse から直接リモートの Git ライブラリをインポートすることもできます。

「File」−「Import」で「Git」の「Projects from Git」を選択して、「Next」をクリックする。
さらに「Clone URI」を選択して、「Next」をクリックする。
「URI:」に「http://guppy.eng.kagawa-u.ac.jp/GitRepos/BookCover.git」と入力して「Next」をクリックする。

BookCover ライブラリの内容が変更されたとき、Git で管理していると変更を簡単に取り込める。

Eclipse の「Project Explorer」で BookCover を選択し右クリックして、メニューから「Team」−「Pull」を選択する。
（あるいは）
1. SourceTree で BookCover を選択して、「プル」をクリックする。
2. Eclipse の「Project Explorer」で BookCover を選択し右クリックして、メニューから「Refresh」を選択する。

BookCoverのリポジトリは現時点では読み込み専用になっているので、自分で管理できるように新しくプロジェクト（と Git リポジトリ）を作成する。

「File」−「New」−「Project」−「Java Project」で Java Project を作成する。名前は好きなものを付ければよいが、このドキュメントでは BookCoverSamples という名前をつけたと仮定する。
「Java Settings」−「Projects」−「Add」をクリックして、 BookCover にチェックを付ける。これで BookCover プロジェクトに定義されているクラスを利用できる。
「Finish」をクリックする。
プロジェクトのエンコーディングを UTF-8 に変更する。「Package Explorer」で BookCoverSamples を右クリックし、「Properties」の「Resource」を選択し、「Text file encoding」で「Other:」にチェックをいれて、「UTF-8」を選択する。

新しくクラスを作る。「New」− 「Class」をクリックし Name は適当に付ける。（以下の例では FirstSample とする。）
BookCover プロジェクトの samples.svg パッケージあたりから適当なファイルの中身をコピーする。（パッケージが替わるので package 〜の部分は適宜変更する必要がある。なお、「Package Explorer」内で、Drag & Drop でコピーするとパッケージも適宜付け替えてくれる。）
いったん、作成したプログラムを実行する。（「Run」−「Run As」で「Java Application」をクリックする。）ただし、このままでは、画像データ（SVG 形式）がコンソールに出力されてしまう。
「Run」−「Run Configurations …」で「Common」というタブをクリックする。「Standard Input and Output」の中で「File」にクリックし、適当なファイル（例えば C:\Users\YourId\Desktop\FirstSample.svg）を指定する。
次に実行すると、先ほど指定したファイル: C:\Users\YourId\Desktop\FirstSample.svg ができる。
このファイルを Internet Explorer や Firefox などのブラウザーで開く。（ダブルクリックするか、ドラッグ＆ドロップする。）

新しく作成したプロジェクト (BookCoverSamples) も変更を元に戻せるように、Git で管理するとよい。

Eclipse の「Package Explorer」内で BookCoverSamples を選択して、右クリックし、「Team」−「Share Project…」をクリックする。
「Share Project」の「Select a repository type:」で「Git」を選択して、「Next」をクリックする。
「Configure Git Repository」の「Repository:」で「Create」をクリックし、リポジトリを作りたい場所（例えば、 C:\Users\YourId\Documents\BookCoverSamplesRepository）を入力する。
「Finish」をクリックする。（これで、プロジェクトのフォルダの場所が workspace から、リポジトリとして指定したフォルダの下に移動する。）

Eclipse からも Git の操作ができるので以下の作業は必須ではないが、 SourceTree のほうが操作がわかりやすいので、リポジトリを SourceTree からも見えるようにしておくと良い。

SourceTree で「新規／クローンを作成する」をクリックする。
「リポジトリをクローン／追加／作成」で「作業コピーを追加」タブを開く。
「作業コピーのパス:」に先ほど作成したリポジトリのパス（ C:\Users\YourId\Documents\BookCoverSamplesRepository）を入力する。
「追加」をクリックする。

これで SourceTree からも Git の操作が行える。

リモートリポジトリを BitBucket や GitHub のようなホスティングサービスにおくと、便利です。

（もし、まだなら）サインアップする。
BitBucket に空のリポジトリ（BookCoverSamples）を作成する。
SourceTree で設定をクリックし、「リモートリポジトリ」の「追加」をクリックする
「リモート名」は「origin」にする。「URL／パス」は BitBucket のページの右上に HTTPS🔽 の右側に表示されている「https://TaroYamada@bitbucket.org/TaroYamada/bookcoversamples.git」
「プッシュ」をクリックする。

これで BitBucket の URL を覚えておけば、別のコンピューターから、 SourceTree などを使って作業内容を取り出せます。

以下の参考リンクでわからない点は、… ググってください。

Koji Kagawa