◀ 10.

Maven の使い分け

▶

編集

この記事の要点

Eclipse プロジェクトを別 PC や別ワークスペースに渡す方法
基本: ファイル → エクスポート → 一般 → アーカイブ・ファイルで zip 化
インポート: ファイル → インポート → 一般 → 既存プロジェクトをワークスペースへ
チーム開発では zip より Git クローンが原則 — 履歴も共有できる
Maven プロジェクトは 「既存 Maven プロジェクト」としてインポート（pom.xml が自動認識）

概要

Eclipse プロジェクトを別 PC や別ワークスペースに渡すための「エクスポート」と「インポート」の手順です。zip でファイルを渡す方式、Git で共有する方式、Maven プロジェクトとして渡す方式の使い分けを解説します。

方式の比較

方式	適している場面	注意点
zip アーカイブ	1 回限りの受け渡し / 教育用配布	履歴なし。`.classpath` に絶対パスが入っていると先方で要修正
Git クローン	チーム開発・継続的に共有	`.gitignore` で `target/` や `.metadata/` を除外する必要
Maven リポジトリ	ライブラリとして公開	`mvn deploy` でリポジトリにアップロード
ワークスペース丸ごとコピー	非推奨	`.metadata` に PC 固有設定が入っていて壊れやすい

エクスポート: zip 化する手順

パッケージ・エクスプローラーでプロジェクトを右クリック → エクスポート (Export...)
一般 → アーカイブ・ファイル (General → Archive File) を選択 → 次へ
左ペインで対象プロジェクト・サブフォルダを選択（target/ や .metadata/ は除外推奨）
「To archive file」に zip の保存先を指定
オプション:
- Save in zip format（推奨。tar 形式より互換性が高い）
- Create directory structure for files（チェック推奨）
完了を押す

インポート: zip を取り込む手順

Eclipse で ファイル → インポート (File → Import...)
一般 → 既存プロジェクトをワークスペースへ (General → Existing Projects into Workspace)
Select archive file で zip を選択（または Select root directory でフォルダ）
「Projects」リストに対象プロジェクトが表示されるのでチェック
「Copy projects into workspace」にチェックを入れるとワークスペース内に複製。チェックを外すと元の場所を参照
完了

Maven プロジェクトのインポート

zip ではなく「Maven プロジェクト」として渡された場合は専用インポートを使います:

ファイル → インポート → Maven → 既存 Maven プロジェクト
Root Directory に pom.xml がある親フォルダを指定
表示された pom.xml にチェック → 完了
初回は依存ライブラリのダウンロードに数分かかる
ビルドエラーが残っていれば プロジェクト右クリック → Maven → プロジェクトの更新

Git プロジェクトのインポート (EGit)

ファイル → インポート → Git → Git からプロジェクト
「URI のクローン」で Git URL を入力 → 認証 → ブランチ選択 → ローカル保存先指定
「Import existing Eclipse projects」または「Use the New Projects wizard」を選択
完了後、ワークスペースにプロジェクトが追加される

除外すべきファイル / フォルダ

zip エクスポート / Git push 時に含めないべきもの:

パス	説明
`target/`	Maven ビルド成果物。再生成可能
`bin/`	Eclipse のビルド出力
`.metadata/`	ワークスペース直下にある Eclipse 固有設定
`.idea/` / `*.iml`	IntelliJ IDEA 固有設定（混在開発で要注意）
`node_modules/`	npm 依存。再インストール可能
`.env` / `application-secrets.properties`	機密情報
`*.log`	ログファイル

.classpath と .project は基本的に共有しても OK ですが、絶対パス（C:\Users\xxx\...）が入っていないか確認してください。

よくあるトラブル

インポート後にコンパイルエラー多発: ターゲット・ランタイム / JDK / Maven 依存が解決されていない → 各設定を確認
「既存プロジェクト」に何も表示されない: 指定フォルダ直下に .project が無い → 1 階層下にプロジェクトがある可能性
絶対パスが残っていてリンクエラー: .classpath を開いて部分を確認、相対パスに修正
Git ブランチ名が違う: Eclipse の Git ビューでチェックアウトし直す

WAR エクスポートとデプロイ

動的 Web プロジェクトを実機の Tomcat にデプロイするには、WAR ファイルとしてエクスポートします:

プロジェクト右クリック → エクスポート (Export...)
Web → WAR file を選択 → 次へ
「Destination」に出力先 (例: C:/tmp/myapp.war) を指定
「Optimize for a specific server runtime」にチェック（推奨）
「Export source files」は通常チェックなし（ソース込みエクスポートが必要な場合のみ）
完了
生成された WAR を Tomcat の webapps/ にコピー（自動展開される）

ワークスペース全体のエクスポート（推奨されないが用途あり）

個別プロジェクトではなくワークスペース設定（パースペクティブ、ショートカット、外観設定など）を引き継ぎたい場合:

ファイル → エクスポート → 一般 → 設定 (Preferences)
出力ファイル名 (.epf 拡張子) を指定
すべての設定をエクスポートか、選択した範囲だけかを選ぶ
新規ワークスペースでファイル → インポート → 一般 → 設定で取り込み

注意: ワークスペースの .metadata フォルダ自体のコピーは PC 固有設定（インストール先 / Tomcat パスなど）が含まれるため、別 PC で動かないことが多いです。設定エクスポート機能か Oomph 経由がおすすめです。

チーム開発における推奨ワークフロー

シナリオ	推奨方法
新メンバー参加	Git クローン + README に「Tomcat ランタイム設定」など個別設定手順を明記
本番リリース	CI/CD で Maven / Gradle ビルド → WAR / Jar を成果物として配信
外注先に渡す	Git アクセス権を絞って付与 / または zip + README
学習用教材	zip + README + 動作確認手順 (run instructions)

ページ一覧

その他