Android studio 导入Eclipse project 注意事项

转换目录结构

• 打开Import
  • 新用户：
    
  • 老用户： File-->Import Project
    
• 直接找到原有的Eclipse工程
  • 单一工程直接导入即可。
    
  • 有库工程的需要注意，导入一定要指向主工程，而不是整个项目的目录。指向项目目录是无法进行转换的。
    
• 指定目标路径
  

• 这个地方需要详细说一下
  
  这里上面两个选项暂且不说，勾选上。
  最后一项提一下： 将Module名创建为camelCase风格。
  驼峰式，这个搞Java的都会熟悉，camelCase表示首字母小写的驼峰式风格，CamelCase表示首字母大写的驼峰式风格。
  不勾选这个选项意味着你原先的工程名是啥样，转换完就是啥样。
  这里的AndroidStudio会去分析Eclipse工程下的. project文件，里面的name就是你在Eclipse中看到的工程名。（没有此文件时会使用此工程的文件夹名。）
  
  当然也有例外，比如countly-sdk-android转换完就成了countlysdkandroid，下划线我就不知道了，这个没有再仔细研究规则，不过CamelCase会保持正常。
  这里我比较喜欢让Module首字母大写（不知道为啥看这首字母小写难受），原来的工程就是CamelCase风格，我就不勾选了。
  当然如果这里没注意直接转换成了camelCase但最后又不喜欢怎么办？ 可以看后面《如何更改Module名称》部分。
  OK，配置完点击Finish即可

• 之后需要经过一段时间的转换。成功后可以看到import-summary.txt，这个文件非常有用，后面会讲到。
  

到这里，你的应用其实已经可以通过AndroidStudio正常编译，你也可以写代码去了。
但我希望你还能继续看下去，因为这个成功后弹出来的import-summary.txt写了些很重要的东西。

带你看懂import-summary.txt

Manifest Merging

Your project uses libraries that provide manifests, and your Eclipse
project did not explicitly turn on manifest merging. In Android Gradle
projects, manifests are always merged (meaning that contents from your
libraries' manifests will be merged into the app manifest. If you had
manually copied contents from library manifests into your app manifest
you may need to remove these for the app to build correctly.

这段应该都能看懂，无非就是说你Library的清单文件有效啦。
不用手工拷贝到主工程的清单文件中了。以前拷贝过的，要移除才能正确build。

Ignored Files（这个最重要）

之所以说这部分重要，是因为AndroidStudio通过这段文字告诉了你，它导入的时候忽略了哪些文件。
也就是说这部分内容，它没给你拷进来，你要是不去自己拷贝，那这部分你新Gradle工程里面就没有了。
这里选一些典型的ignore文件来看一下：

From SDK:
* proguard-project.txt
* proguard.cfg
From UI:
* cert\
* cert\cert
From CrosswalkWebview:
* ant.properties
* build.xml
From SlidingMenuLibrary:
* LICENSE.txt
* pom.xml

给上面的忽略文件分分类：

• 确实不需要的：混淆文件、ant的ant.properties与build.xml、maven的pom.xml。
• 需要再次声明的： LICENSE.txt。不声明属于盗版侵权啊~~
• 自定义文件夹和文件：cert。 这个文件夹是自己创建的，不属于Android规定的目录，所以AndroidStudio没给拷贝。

需要留意你的Ignored Files部分，并根据自己的需要手工拷贝到新工程中。

Replaced Jars with Dependencies & Replaced Libraries with Dependencies

在Replaced Jars with Dependencies部分，有如下文字：

android-support-v4.jar => com.android.support:support-v4:21.0.3
gson-2.3.jar => com.google.code.gson:gson:2.3
joda-time-2.6.jar => joda-time:joda-time:2.6

可以看到jar被替换了。 可以看到工程里面没有了当初添加的jar包。那么jar包去哪了呢？
暂时先留个悬念。
我们继续来看 Replaced Libraries with Dependencies部分

ActionbarLibrary =>
    com.actionbarsherlock:actionbarsherlock:4.4.0@aar
    com.android.support:support-v4:21.0.3

可以看到ActionbarSherlock被替代为了aar（Android ARchive ，jar : Java ARchive）。关于aar的介绍可以看这里，本文就不再详细展开了。

可以看到的是Library和jar都被替换了，可是你在当前工程里再也找不到了。这是为什么？

跟我来看下面的操作：

• 在Module上右击，选择Open Module Settings
  
• 切换到Dependencies
  
• 点击右侧的加号添加，选择Library dependency
  
• 可以看到这个界面：
  

OK，到这里就可以知道真相了，在AndroidStudio中你可以添加在线的库或jar包，添加完成后你就可以和平时一样正常使用。
而你的同事在打开这个工程的时候会即时下载，保证你们的代码都能正常运行。
这也是为什么当你的工程转换完毕后，有些jar和Library消失的原因。他们被转成在线的了。

Moved Files

这部分在讲你的目录结构变化，基本上可以认为他在废话，没什么看的必要了。

Next Steps & Bugs

呵呵，略过吧

最后一句

This import summary is for your information only, and can be deleted
after import once you are satisfied with the results.

你一旦觉得自己的工程没问题了，就可以把这个文件删除了。

导入AndroidStudio工程注意

通过上面的步骤，你的项目已经转换了目录结构，这时候你可以提交代码，供其他同事下载使用了。
其他同事把代码下载下来，他们所需要引入的是一个Android Gradle Project了。

• 新用户
  • 如果项目中有.idea之类的IntelliJ的文件，开始选择的应该是Open an existing Android Studio project，而不是Import Non-Android Studio project。
  • 如果你下载下来的代码里面只有gradle的文件，即使还是要选Import Non-Android Studio project。
• 老用户依然使用： File-->Import Project

这里需要提醒的是，对于含有库工程的项目而言， 需要指定整个项目的目录，仅仅指定主工程是没用的。

到这里我们需要停下来总结一下：

• 如果你导入的是一个Eclipse工程，那么指定主工程目录。AndroidStudio通过分析来帮你完成转换。
• 如果你导入的是一个AndroidStudio工程，那么指定整个项目的目录 。

附： 如何更改Module名称

在Module上右键refactor--> rename ，当然可以看到有快捷键shift + F6， 这样就可以改变Module的名称了。
但是还没有结束，这样没有更改引用这个Module的地方。
如果他是一个库工程，你还需要继续去查看引用它的地方并进行修改。主要是其他Module的Gradle文件。

Tips：
选中Module，ctrl+c即可复制工程名，在相关Gradle文件中ctrl+v替换成新的名称即可。

最后，别忘了，settings.gradle，这里include的module名称也需要更改。 至此，算是修改结束。

一切修改完毕，点击弹出提示中的Sync Now，让工程重新构建

构建结束后就一切正常了。
当然你如果对文件夹的名称也看着不顺眼，也可以去修改文件夹名称，改变后记得重新导入即可。

总结

以上就是两种导入的方式的介绍，总体来说第一种适合无奈的时候提前熟悉AndroidStudio，第二种则是更推荐的方式。

无论采用哪一种，都希望你能尽快的接触AndroidStudio，体验它的强大。

点击打开链接