# クイック・スタート・ガイド

このチュートリアルではワークベンチの紹介を行い、シンプルなアプリケーションの作成に必要なステップの概要を説明します。イメージを含むさらに詳しい説明については、ワークベンチ・ユーザー・ガイドを参照してください。

ワークベンチのクイック・スタート

タスク | 説明

シンプルなプロジェクトの作成

1. 「ファイル」>「新規」>「プロジェクト... 」を選択します。
2. 「新規プロジェクト」ウィザードで、「シンプル」>「プロジェクト」を選択してから、「次へ」をクリックします。
3. 「プロジェクト名」フィールドに、新規プロジェクトの名前を入力します。

4. プロジェクトのロケーションを指定するか、デフォルトを使用します。

5. 「終了」をクリックします。

フォルダーの作成

1. 1 つ以上のプロジェクトが存在することを確認します。
2. 「ファイル」>「新規」>「フォルダー」を選択します。
3. 「新規フォルダー」ウィザードの「フォルダー名 (Folder name)」フィールドに、新規フォルダーの名前を入力します。
4. 「終了」をクリックします。

ファイルの作成

1. 1 つ以上のプロジェクトが存在することを確認します。
2. 「ファイル」>「新規」>「ファイル」を選択します。
3. 「新規フォルダー」ウィザードの「ファイル名 (File name)」フィールドに、新規フォルダーの名前を入力します。
4. 「終了」をクリックします。

リソースのインポート

1. 「ファイル」>「インポート」を選択します。
2. インポート・ソースを選択します。
3. 「次へ」をクリックします。
4. 該当するウィザードの指示に従って、リソースを収容するインポート・ロケーションを選択します。
5. 「終了」をクリックします。

リソースのエクスポート

1. 「ファイル」>「エクスポート」と選択します。
2. エクスポート先を選択します。
3. 「次へ」をクリックします。
4. 該当するウィザードの指示に従って、エクスポート先を選択します。
5. 「終了」をクリックします。

Java プロジェクトの作成: JUnit の例

1. JUnit ソース・コードをダウンロードするには、http://www.eclipse.org/downloads/ にアクセスして、作業中の Eclipse リリースを探します。
2. 「サンプル・プラグイン (Example Plug-ins)」セクションまでスクロールダウンして、サンプルのアーカイブをダウンロードします。
3. Zip ファイルの内容をディレクトリーに解凍します。
4. Eclipse に戻り、「ファイル」>「新規」>「プロジェクト... (Project...)」を選択します。
5. 「Java プロジェクト」を選択して、「次へ」をクリックします。
6. 「プロジェクト名」フィールドに JUnit と入力します。
7. 「終了」をクリックします。
8. パッケージ・エクスプローラーで、JUnit プロジェクトが選択されていることを確認します。
9. メニュー項目「ファイル」>「インポート...」を選択します。
10. Zip ファイルを選択してから、「次へ」をクリックします。
11. 「Zip ファイル」フィールドの横にある「参照」をクリックし、 <ExamplesDownloadPath>eclipse/plugins/org.eclipse.jdt.ui.examples.projects_3.0.0/archive/junit/junit381src.jar をブラウズして選択します。

12. 「インポート」ウィザードの階層リストの下で、「すべて選択」をクリックします。

13. JUnit プロジェクトが宛先の「フォルダー」フィールドに表示されたら、「終了」をクリックします。

14. インポートの進行状況表示で、リソースがワークベンチにインポートされるとそのリソースがコンパイルされることを確認してください。 これは、「ワークベンチ」設定ページで「自動的にビルド」オプションにチェック・マークが付けられているためです。 JUnit プロジェクト内の .classpath ファイルおよび .project ファイルの上書きを求めるプロンプトが表示されます。 これは、JUnit プロジェクトの作成時に .classpath リソースが作成されたためです。 これらのファイルは、上書きしても問題ありません。
    「パッケージ・エクスプローラー」ビューで、JUnit プロジェクトを拡張して JUnit パッケージを表示します。

Java クラスの作成: JUnit の例

1. 「パッケージ・エクスプローラー」ビューで JUnit プロジェクトを右クリックし、「新規」>「パッケージ」を選択します。
2. 「名前」フィールドに、新しいパッケージの名前として test と入力します。
3. 「終了」をクリックします。
4. 「パッケージ・エクスプローラー」ビューで、新しいテスト・パッケージを選択して、ツールバーの「新規 Java クラス」をクリックします。 JUnit が「ソース・フォルダー」フィールドに表示されていることと、test が「パッケージ」フィールドに表示されていることを確認します。
5. 「名前」フィールドに MyTestCase と入力します。
6. 「スーパークラス (Superclass)」フィールドの横にある「参照」をクリックします。
7. 「スーパークラスの選択」ダイアログの「型の選択」フィールドに Test と入力して、使用可能なスーパークラスのリストを絞り込みます。
8. TestCase クラスを選択し、「OK」をクリックします。
9. 「スーパークラスからのコンストラクター」のチェック・ボックスを選択します。
10. 「終了」をクリックします。
11. 新規ファイルがエディターで開きます。 「アウトライン」ビューで新規クラス MyTestCase を選択します。コンテキスト・メニューを開いて、「ソース」>「メソッドのオーバーライド/実装」を選択します。
12. 「メソッドのオーバーライド」ダイアログで、setUp() と tearDown() にチェック・マークを付け、「OK」をクリックします。
13. setUp() の本体を container= new Vector(); に変更します。
14. container と Vector を解決できないため、これらの語に問題強調表示行で下線が付けられます。 電球がマーカー・バーに表示されます。 カーソルを Vector 内に置き、Ctrl+1 を押します (または、メニュー・バーの「編集」>「クイック・フィックス」を使用します)。「'Vector' のインポート (java.util) 」を選択します。 これで、欠落したインポート宣言が追加されます。
15. カーソルを container 内に置き、Ctrl+1 を押します。 「フィールド 'container' の作成」を選択して新しいフィールドを追加します。
16. 「アウトライン」ビューで、クラス MyTestCase を選択します。 コンテキスト・メニューを開いて、「ソース」>「Getter および Setter の生成...」 を選択します。
17. 「Getter および Setter の生成」ダイアログは、メソッド getContainer および setContainer の作成を提案します。 両方を選択して、「OK」をクリックします。 フィールド・コンテナーの getter および setter メソッドが追加されます。
18. ファイルを保管します。
19. 生成されたコードのフォーマットは、「ウィンドウ」>「設定」>「Java」>「コード・スタイル」>「コード・フォーマッター」で構成できます。 フィールド名に接頭部または接尾部を使用する場合、 それを「ウィンドウ」>「設 定」>「Java」>「コード・ スタイル」>「フィールド」で指定することができます。 これにより、生成された getter および setter は、接頭部または接尾部の付いていないメソッド名を提案します。

Java プログラムの起動: JUnit の例

1. 「パッケージ・エクスプローラー」ビューで junit.textui.TestRunner.java を探し、 これをダブルクリックしてエディターで開きます。
2. 「アウトライン」ビューで、TestRunner クラスに、クラスが main メソッドを定義することを示すアイコンが付いていることに注意してください。
3. 「パッケージ・エクスプローラー」で TestRunner.java を右クリックし、「実行」>「Java アプリケーション (Java Application)」を選択します。
4. 「実行」>「構成および実行... (Run...)」を選択します。TestRunner 起動構成が選択された「起動構成」ダイアログが開きます。
5. 「起動構成」ダイアログで、「引数 (Arguments)」タブを選択し、「プログラム引数 (Program arguments)」エリアに junit.samples.VectorTest と入力します。
6. 「実行」をクリックします。今度はプログラムが正常に実行され、いくつかのテストが実行されたことが示されます。
7. 「デバッグ」パースペクティブに切り替えます。 「デバッグ」ビューでは、プログラムを実行した際に、最新のプログラム起動のプロセスが登録されます。
8. ワークベンチ・ツールバーにある「実行」をクリックします。このリストには、前に起動されたプログラムが含まれています。 このプログラムは、ヒストリー・リストで選択することによって再起動できます。
9. 「デバッグ」ビューのコンテキスト・メニュー (または同等のツールバー・ボタン) から「終了したすべてを除去」を選択して、終了した起動プロセスのビューをクリアします。

作成

プラグイン

1. 「ファイル」>「新規」>「プロジェクト」を選択します。
2. 「プラグイン・プロジェクト」を選択し、「次へ」をクリックします。
3. 「プロジェクト名」フィールドに、プロジェクトの名前を入力し、「次へ」をクリックします。
4. 「プラグイン・コンテンツ」ページで、プラグイン ID、バージョン、名前など、plugin.xml ファイルの初期化に使用するデータを設定します。
5. 使用可能なテンプレートを選択し、「次へ」をクリックします。
6. サンプルの拡張子をカスタマイズし、「終了」をクリックします。

Eclipse ランタイムのワークベンチ・インスタンスを起動して、プラグインをテストします。

1. 「実行」>「構成および実行... (Run...)」を選択します。
2. 「起動構成」ダイアログの「名前」フィールドに、構成の名前を入力します。
3. 「ワークスペース・データ (Workspace data)」フィールドでは、「参照」をクリックして、ランタイム・ワークベンチで使用されるワークスペースを定義します。このランタイム・ワークスペースのロケーションは、ホスト・インスタンスのワークスペースとは異なって いなければなりません。
4. 「アプリケーションの実行 (Run an application)」フィールドでは、デフォルトの Eclipse アプリケーション org.eclipse.ui.ide.workbench を選択します。
5. 「実行」をクリックします。

2 番目のワークベンチ・インスタンスが表示されます。これを構成するプラグインは、ワークスペース・プラグインと、「ターゲット・プラットフォーム」設定ページで選択されているプラグインです。 適当な JRE を使用してランタイム・ワークベンチをテストできます。この JRE は、 ワークスペースにおけるプラグインのコンパイルの対象となる JRE と同じでなくてもかまいません。テストに 適した VM 引数を指定することもできます。

ビルドの自動実行

1. 「ウィンドウ」>「設定」を選択します。
2. 左側で「一般 (General)」カテゴリーを選択します。
3. 「自動的にビルド」を選択します。
4. 「OK」をクリックします。

ビルドの手動実行

1. 「リソース」パースペクティブの「ナビゲーター」ビューで、1 つまたは複数のプロジェクトを選択します。
2. 右マウス・ボタン・クリックして、ポップアップ・メニューから「プロジェクトのビルド」オプションを選択します。

CVS クイック・スタート

注: ワークベンチで有効なリポジトリー・ロケーションを作成するには、あらかじめホスト・マシンに CVS サーバーを構成しておかなければなりません。

タスク | 説明

CVS リポジトリー・ロケーションの作成

1. 「ウィンドウ」>「ビューの表示」>「その他...」を選択します。
2. 「CVS」>「CVS リポジトリー」を選択します。
3. 「CVS リポジトリーの追加」をクリックします。
4. リポジトリー・ロケーションを識別し、そこに接続するのに必要な以下の情報を入力します。
5. 「終了」をクリックします。

SSH による CVS との接続および構成

1. 「ウィンドウ」>「設定」を選択します。
2. 「チーム」>「CVS」>「SSH2 接続メソッド」を選択します。
3. 「一般 (General)」タブを選択し、「秘密鍵の追加」をクリックして、リストに秘密鍵を追加します。
4. 秘密鍵に対するパスワードを準備して、使用するコンピューターに保管します。

鍵ペアがない場合:

1. 「ウィンドウ」>「設定」を選択します。
2. 「チーム」>「CVS」>「SSH2 接続メソッド」を選択します。
3. 「鍵管理」タブを選択します。
4. ご使用のサーバーがプロトコルのバージョン 1 をサポートしている場合は「RSA 鍵の生成」を選択し、バージョン 2 をサポートしている場合は「DSA 鍵の生成」を選択します。公開鍵および秘密鍵が生成されます。 公開鍵は読み取り専用テキスト域に表示されます。
5. ご使用のサーバーに公開鍵をコピーします。 ご使用のサーバーが OpenSSH サーバーを実行している場合は、「SFTP 経由でエクスポート (Export via sftp)」をクリックします。そうでない場合は、リモートの ~/.ssh/authorized_keys ファイル内へ公開鍵をコピー・アンド・ペーストします。

CVS リポジトリーからのプロジェクトのチェックアウト

1. 「CVS リポジトリー・エクスプローラー」パースペクティブに切り替えます。
2. 「CVS リポジトリー」ビューで、リポジトリー・ロケーションを拡張します。
3. 「HEAD」を拡張して、ワークベンチにプロジェクトとして追加したいフォルダーを選択します。
4. 選択されたフォルダーのメニューから、以下の 1 つを選択します。
   - 「チェックアウト」 　　　　リポジトリー内のフォルダーと同じ名前を持つ、 ローカル・ワークスペース内のプロジェクトとして選択された各フォルダーをチェックアウトします。
   - 「別名チェックアウト...」 　　　　　選択されたフォルダーをローカル・ワークスペース内のカスタム構成プロジェクトにチェックアウトします。

リポジトリーとの同期化および変更点の更新またはコミット

1. 「ナビゲーター」ビューで、同期化したいリソースを選択します。
2. 右マウス・ボタン・クリックして、「チーム」>「リポジトリーと同期化」の順に選択します。
3. 「同期化」ビューでリソースを右クリックし、以下の 1 つを選択します。
   - 「コミット」。リソースの現在の CVS バージョンをオーバーライドし、ご使用のバージョンをリポジトリーに保管する場合。
   - 「更新」。リポジトリーに保管されたバージョンでワークスペースを更新する場合。