从GitHub将Maven项目导入Eclipse4.2

简介

GitHub is a web-based hosting service for projects that user the Git revision control system. It is a social networking where you can share your code.

GitHub中的Maven项目一般没有本地配置文件（主要是为了去除依赖，使项目整体结构清晰）。

但是当导入Github的Maven项目，并与本地的Eclipse直接结成，总有些困难，直到Eclipse 4.2(Juno). 本文介绍如何导入github项目，并直接与eclipse集成。

引文

本文是在Windows 7下进行，下面的软件将被安装，并使之一起工作 :

1. Eclipse: Eclipse IDE（本文使用eclipse-4.2）

2. Java: Java编程语言(本文使用java-1.7.0_05)

3. Maven: Java项目管理工具(本文使用mava-3.0.4)

4. Druid: JDBC Connection Pool(本文使用Druid项目为例)

条件准备

1. GitHub流程， Set up git, Create a repo, Fork a repo, Be social. 参考GitHub Help.
2. 生成ssh keys. 参考Generating SSH Keys.
3. 有项目的push权限
4. Java, Eclipse, Maven安装正确

配置

Maven配置

Eclipse-4.2使用的Maven版本默认为maven-3.0.4, 但是还是建议设置一下：

版本设置: Window > Preferences > Maven > Installations

用户设置: Window > Preferences > Maven > User Settings

SSH配置

SSH2设置: Window > Preferences > General > Network Connections > SSH2

注意设置SSH2 home及private keys.

导入项目

1.右键 > Import > Project from Git

2.选择URI

3.输入Remote Git Repo的配置信息

注意：Protocol使用ssh, User使用git, Password为账户在github的密码

4.查找远程分支信息

5.选择分支

6.选择本地目标位置

7.从版本仓库中进行Clone

8.接受文件中

9.选择导入项目类型

注意: 选择Import as general project

10.确认项目名称

11.项目如下

注意: 此时项目为General Project不是Maven project, 需要手工修改配置文件。但是由[druid master]可以看出，已经是一个带版本控制的项目了。

修改项目配置文件

由于导入的是普通项目，需要转化成Maven Project。Eclipse中项目的主要配置文件是.classpath和.project,还有.settings文件夹。

原项目为General project, 只有.project文件，其.project配置文件内容如下

<? xml version="1.0" encoding="UTF-8"?>

<projectDescription>

<name> druid</name>

<comment></comment>

<projects></projects>

<buildSpec></buildSpec>

<natures></natures>

</projectDescription>

需要修改.project，并添加.classpath文件：

<? xml version="1.0" encoding="UTF-8"?>

<projectDescription>

<name> druid</name>

<comment></comment>

<projects>

</projects>

<buildSpec>

<buildCommand>

<name> org.eclipse.jdt.core.javabuilder</name>

<arguments>

</arguments>

</buildCommand>

<buildCommand>

<name> org.eclipse.m2e.core.maven2Builder</name>

<arguments>

</arguments>

</buildCommand>

</buildSpec>

<natures>

<nature> org.eclipse.jdt.core.javanature</nature>

<nature> org.eclipse.m2e.core.maven2Nature</nature>

</natures>

</projectDescription>

还有.classpath文件

<? xml version="1.0" encoding="UTF-8"?>

<classpath>

<classpathentry kind ="src" output="target/classes" path="src/main/java">

<attributes>

<attribute name ="optional" value="true"/>

<attribute name ="maven.pomderived" value="true"/>

</attributes>

</classpathentry>

<classpathentry excluding ="**" kind="src" output="target/classes" path="src/main/resources">

<attributes>

<attribute name ="maven.pomderived" value="true"/>

</attributes>

</classpathentry>

<classpathentry kind ="src" output="target/test-classes" path="src/test/java">

<attributes>

<attribute name ="optional" value="true"/>

<attribute name ="maven.pomderived" value="true"/>

</attributes>

</classpathentry>

<classpathentry excluding ="**" kind="src" output="target/test-classes" path="src/test/resources">

<attributes>

<attribute name ="maven.pomderived" value="true"/>

</attributes>

</classpathentry>

<classpathentry kind ="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/J2SE-1.5">

<attributes>

<attribute name ="maven.pomderived" value="true"/>

</attributes>

</classpathentry>

<classpathentry kind ="con" path="org.eclipse.m2e.MAVEN2_CLASSPATH_CONTAINER">

<attributes>

<attribute name ="maven.pomderived" value="true"/>

</attributes>

</classpathentry>

<classpathentry kind ="output" path="target/classes"/>

</classpath>

刷新项目

在项目上右键 > Refresh.

如果还有错误，可以在项目上右键 > Maven > Update project.. > OK, Eclipse 会自动重新建立.settings文件夹。

此时项目完成，可以直接提交到GitHub了。