将Eclipse代码导入到AndroidStudio的两种方式

野性酷女 2022-06-16 06:51 159阅读 0赞

说到使用AndroidStudio，除了新建的项目，我们都会面临的问题是原先Eclipse的代码该怎么导入到AndroidStudio中使用。  
这方面相关的资料还比较少，自己摸索了一下，总结出这篇博客，希望能让开发者少走些弯路。  
OK，进入正题。

Google为了让我们更加方便的使用AndroidStudio，提供了两种导入Eclipse代码的方式：一种兼容Eclipse，一种是全新的Android Gradle Project.  
这里，我们先从兼容模式说起。

# 兼容模式 #

这种模式下，保证了Eclipse时代的代码目录结构，整体操作和使用和Eclipse也差不多。  
最重要的，当你使用AndroidStudio时，你或者其他人也可以方便的使用Eclipse，互不干扰。

## 实现步骤 ##

### 1. 从Eclipse中导出Gradle build files ###

*  在Eclipse菜单中 File --> Export-->Generate Gradle build files  
    ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio]  
    
 *  接下来会到达警告界面，这里会提示AndroidStudio可以直接导入ADT的工程，先过，后面有直接导入的讲解。  
    ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 1]  
    
 *  选中你的项目工程，包括主工程和库工程（Library）。  
    ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 2]  
    
 *  确认生成  
    ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 3]

### 2. 修改导出文件参数 ###

导出后，由于adt很久没更新，需要手动改一些参数，才能保证正常使用。  
为了保证能够讲解的更清晰，下面分情况讲解一下：

#### 没有库工程，只有主工程 ####

这种情况下你看到的目录是这样的  
![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 4]

*  首先需要更改的是 build.gradle 文件  
    AndroidStudio 1.0 ~ 1.0.2 使用的都是 Android Gradle plugin 1.0.0，因此需要将图中红框内的 0.12.+ 改为 1.0.0  
    ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 5]  
    
 *  然后还需要更新Gradle版本，指定为所需要的2.2.1  
    在 /gradle/wrapper/gradle-wrapper.properties里面  
    ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 6]

#### 含有库工程 ####

其实改动方法和上面一样，只需要注意是改动整个项目的build.gradle和 /gradle/wrapper/gradle-wrapper.properties。  
而不要尝试去主工程或者库工程里面找build.gradle  
![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 7]

### 3. 导入AndroidStudio ###

*  进入到AndroidStudio中，选择导入非AndroidStudio工程  
    ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 8]  
    
 *  找到需要导入的工程目录，可以看到图标和Eclipse创建的工程不一样。  
    ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 9]  
    
 *  点击OK，进入漫长的加载过程，之后就可以正常使用了。  
    ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 10]

已经创建过工程的打开AndroidStudio会直接进入以前的工程  
这时候可以选择File-->Import Project， 选中后点击ok  
![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 11]

## 兼容模式下的bug ##

使用IDE的打包：  
![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 12]

在兼容模式只打主工程的，库工程没有加入到apk中，导致无法正常运行。  
截止到1.0.2，AndroidStudio依然存在这个bug。  
因为这个bug的存在，你在兼容模式可以使用AndroidStudio编程，打包时开启Eclipse。

OK，兼容模式介绍到这里。 我们开始介绍主角： Android Gradle Project。 这里必须说明的是Google更希望我们使用这种方式，如果没有什么团队的压力，还是使用这种吧。

# 使用新的目录结构 #

## 转换目录结构 ##

*  打开Import
    
     *  新用户：  
        ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 13]  
        
     *  老用户： File-->Import Project  
        ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 14]  
        
 *  直接找到原有的Eclipse工程
    
     *  单一工程直接导入即可。  
        
     *  有库工程的需要注意，导入一定要指向主工程，而不是整个项目的目录。指向项目目录是无法进行转换的。  
        ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 15]  
        
 *  指定目标路径  
    ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 16]  
    
 *  这个地方需要详细说一下  
    ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 17]  
    这里上面两个选项暂且不说，勾选上。  
    最后一项提一下： 将Module名创建为camelCase风格。  
    驼峰式，这个搞Java的都会熟悉，camelCase表示首字母小写的驼峰式风格，CamelCase表示首字母大写的驼峰式风格。  
    不勾选这个选项意味着你原先的工程名是啥样，转换完就是啥样。  
    这里的AndroidStudio会去分析Eclipse工程下的. project文件，里面的name就是你在Eclipse中看到的工程名。（没有此文件时会使用此工程的文件夹名。）  
    ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 18]  
    当然也有例外，比如countly-sdk-android转换完就成了countlysdkandroid，下划线我就不知道了，这个没有再仔细研究规则，不过CamelCase会保持正常。  
    这里我比较喜欢让Module首字母大写（不知道为啥看这首字母小写难受），原来的工程就是CamelCase风格，我就不勾选了。  
    当然如果这里没注意直接转换成了camelCase但最后又不喜欢怎么办？ 可以看后面《如何更改Module名称》部分。  
    OK，配置完点击Finish即可
 *  之后需要经过一段时间的转换。成功后可以看到import-summary.txt，这个文件非常有用，后面会讲到。  
    ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 19]

到这里，你的应用其实已经可以通过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的介绍可以看[这里][Link 1]，本文就不再详细展开了。

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

跟我来看下面的操作：

*  在Module上右击，选择Open Module Settings  
    ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 20]  
    
 *  切换到Dependencies  
    ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 21]  
    
 *  点击右侧的加号添加，选择Library dependency  
    ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 22]  
    
 *  可以看到这个界面：  
    ![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 23]

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，让工程重新构建  
![将Eclipse代码导入到AndroidStudio的两种方式][Eclipse_AndroidStudio 24]  
构建结束后就一切正常了。  
当然你如果对文件夹的名称也看着不顺眼，也可以去修改文件夹名称，改变后记得重新导入即可。

# 总结 #

以上就是两种导入的方式的介绍，总体来说第一种适合无奈的时候提前熟悉AndroidStudio，第二种则是更推荐的方式。  
无论采用哪一种，都希望你能尽快的接触AndroidStudio，体验它的强大。

[Eclipse_AndroidStudio]: /images/20220616/d641534980af4cdbafc1bbf6e4645315.png
[Eclipse_AndroidStudio 1]: /images/20220616/e43cbcb57d6f41ea8b2d99722f98931e.png
[Eclipse_AndroidStudio 2]: /images/20220616/93f52ff0632348d680e85b79ad1a20dc.png
[Eclipse_AndroidStudio 3]: /images/20220616/401961adc41f4f32bf82997d22df5863.png
[Eclipse_AndroidStudio 4]: /images/20220616/dc7932738c3847b19d4828de8c647131.png
[Eclipse_AndroidStudio 5]: /images/20220616/e687fbaa60a04d09987621d2a0d1e535.png
[Eclipse_AndroidStudio 6]: /images/20220616/e9325f1829f342b580a2ae6ffc3b7979.png
[Eclipse_AndroidStudio 7]: /images/20220616/f23ab69072e044a7890d994c0a3b75bc.png
[Eclipse_AndroidStudio 8]: /images/20220616/7aaf276e53444dd598fce48e2089c373.png
[Eclipse_AndroidStudio 9]: /images/20220616/d41da5861c374c4bb9061d155227e69a.png
[Eclipse_AndroidStudio 10]: /images/20220616/d5dbea52073f4be8b6403207d4f5e86a.png
[Eclipse_AndroidStudio 11]: /images/20220616/676094e62f8d4758b0a942f82e3e7bd3.png
[Eclipse_AndroidStudio 12]: /images/20220616/1b284aab67de4514a43b3dd08dbde838.png
[Eclipse_AndroidStudio 13]: /images/20220616/14175d7b0ff94bd79a6c26a3c12cd845.png
[Eclipse_AndroidStudio 14]: /images/20220616/c2011fdad24244d9bdedc24dd3a6c267.png
[Eclipse_AndroidStudio 15]: /images/20220616/bee97487750545089be32cce015c7d99.png
[Eclipse_AndroidStudio 16]: /images/20220616/7ebf581113f045b79e4a1104794b66f5.png
[Eclipse_AndroidStudio 17]: /images/20220616/4b6ccb5afc314e699c760b1992909e05.png
[Eclipse_AndroidStudio 18]: /images/20220616/7865f824f71447f4a4ed7fcb1f57e2fe.png
[Eclipse_AndroidStudio 19]: /images/20220616/1c48b7a8eb76448a86ab5bc75009ae0c.png
[Link 1]: http://tools.android.com/tech-docs/new-build-system/aar-format
[Eclipse_AndroidStudio 20]: /images/20220616/a4f5c321278d48098895e137237761db.png
[Eclipse_AndroidStudio 21]: /images/20220616/b45da0636a1448d783ae974f89e49c17.png
[Eclipse_AndroidStudio 22]: /images/20220616/9c10310ec42c49b8917beefcc8442bbd.png
[Eclipse_AndroidStudio 23]: /images/20220616/2ac4edb143aa495b83d3c613a71db3ed.png
[Eclipse_AndroidStudio 24]: /images/20220616/f98fb3f6b8314f41b935eb5adc6a9894.png