Eclipse を古いリリースから新しいリリースにアップグレードする場合、簡単なステップがあります。 このステップにしたがって、新しいリリースにワークスペースをマイグレーションします。 ワークスペースは、ディスク上のディレクトリーです。 このディレクトリーには、すべてのプロジェクト・ファイルの他に、カスタマイズされた可能性のある 設定などのメタデータが含まれます。 アップグレードのために従うべきステップは、Eclipse の開始時に「-data」コマンド行引数を使用したかどうかで 異なります。 「-data」引数はワークスペースのロケーションを明確に指定するため、この引数の使用をお勧めします。
ヒント: アップグレードする前にワークスペースのバックアップを作成することをお勧めします。 ワークスペースをアップグレードした後は、古いバージョンの Eclipse でそのワークスペースを再度使用することは できません。 前のリリースに「戻る」場合は、バックアップが必要です。
「ワークスペース選択 (workspace chooser) 」ダイアログを使用するとワークスペースのロケーションを選択することができます。 このダイアログは、-data 引数なしで最初に始動したときにユーザーに表示されます。このダイアログによって提供されるデフォルト・ロケーションは、 ユーザーのホーム・ディレクトリーの子「ワークスペース」(例えば、C:¥Documents and Settings¥UserName¥workspace) になります。
3.1 の新規ユーザーはこのデフォルトのままにするか、 他のロケーションを指定する必要がありますが、Eclipse のインストール・ディレクトリーの下に置くことはお奨めしません。ワークスペースには、 絶対ファイル・システム・パスを持つメタデータが含まれることがあり、 ワークスペースが他の場所にコピーされたときにこのパスが無効になるため、 ワークスペースはコピーしないでください。
Eclipse 3.0 以前では、ワークスペース用の Eclipse のデフォルト・ロケーションは Eclipse ディレクトリーの下にありました。例えば、eclipse.exe が D:¥eclipse-SDK-3.0.1¥eclipse の中にある場合、 デフォルト・ワークスペース・ロケーションは D:¥eclipse-SDK-3.0.1¥eclipse¥workspace でした。
3.0 以前を使用して作成されたワークスペースをロードするには、 古いワークスペース・ディレクトリーが古いインストール・ディレクトリーまたは他の場所にある場合でも、 ワークスペース選択を使用して、古いワークスペース・ディレクトリーをポイントするだけで済みます。
Eclipse を開始するための「-data」引数を以前に使用していた場合は、アップグレード・パスは非常に分かりやすくなります。
図に関しては前のセクションの例を参照してください。
追加のプラグインを Eclipse 環境にインストールした場合、その新規プラグインを、インストールする Eclipse の 新規ビルドまたはバージョンごとに追加する必要があります。 その前に、そのプラグインに関するドキュメンテーションを参照して、そのプラグインが、移動先の バージョンの Eclipse と互換性があることを確認してください。 追加のプラグインを新規の Eclipse インストールに追加するには、いくつかの方法があります。