ADT迁移Android Studio的常见问题与解决方案

1. 从ADT迁移到Android Studio的常见陷阱

那天早上8点30分，我像往常一样打开电脑准备继续开发MathsApp项目。这个原本在Eclipse ADT环境下运行良好的项目，现在需要迁移到Android Studio。作为一名有三年Android开发经验的程序员，我本以为这会是件轻松的事——毕竟Android Studio已经发布好几年了，迁移工具应该很成熟了。然而接下来24小时的经历，彻底改变了我的想法。

1.1 初始迁移的假象成功

我首先尝试了最直接的方法：在Android Studio 1.5.1中直接导入ADT工程。系统提示需要转换项目结构，我按照向导一步步操作，修改了targetSdkVersion和compileSdkVersion到23（对应Android 6.0）。首次运行竟然成功了，这让我误以为最难的部分已经过去。

重要提示：这种"假象成功"在项目迁移中很常见。表面运行正常不代表所有资源文件都已正确转换，特别是当项目中使用了一些特殊编码或非标准资源时。

1.2 升级Android Studio 2.0带来的灾难

看到Android Studio 2.0发布的消息，特别是新增的"Instant Run"功能让我心动不已。我毫不犹豫地卸载了1.5.1版本，安装了全新的2.0.0。这个决定让我付出了惨重代价——原本"正常"的项目突然无法构建，出现了一个莫名其妙的红叉。

我花了两个小时更新所有插件和SDK工具，问题依旧。这时我才意识到，新版本可能引入了一些兼容性问题，而我的项目恰好触发了这些边界情况。

2. 编码问题引发的连锁反应

2.1 中文乱码的幽灵

当我深入查看具体错误时，发现所有包含中文注释的Java类文件都显示乱码。我本能地将文件编码从UTF-8改为GBK，这解决了编辑器中的显示问题，但构建错误依然存在。

关键教训：Android构建系统始终使用UTF-8处理源文件。在编辑器中临时更改编码只能解决显示问题，而实际构建时使用的仍然是乱码的字节流。正确的做法是：

1. 在乱码状态下全选文件内容并复制
2. 新建一个UTF-8编码的文件
3. 粘贴内容并保存

2.2 AndroidManifest.xml的隐藏陷阱

在解决编码问题的过程中，我发现AndroidManifest.xml中明确定义了encoding="utf-8"。这提醒了我：整个Android构建系统都是基于UTF-8设计的，任何临时性的编码更改都只是权宜之计。

3. 图片资源的隐秘杀手

3.1 PNG文件的格式陷阱

构建失败的主要错误信息是："AAPT err(Facade for 2069296074): libpng error: Not a PNG file"。这看起来像是某个PNG资源文件损坏了，但检查所有.png文件都能正常打开。

经过仔细排查，发现几个关键点：

• 某些PNG文件使用了CMYK色彩模式（通常来自Photoshop）
• 部分文件虽然扩展名是.png，但实际可能是其他格式转换而来
• Android的AAPT工具对PNG文件有严格的校验

3.2 系统性排查方法

我和助教一起开发了一套有效的排查流程：

1. 新建一个干净工程，确认基础环境正常
2. 逐步导入原项目的Java类文件，每次构建确认状态
3. 分批次导入资源文件，定位问题文件
4. 对可疑图片使用图像处理软件重新导出

最终我们发现f1.png、p1.png和start.png三个文件有问题。用Photoshop重新保存这些文件后，构建错误消失。

4. 环境配置的深层次问题

4.1 Gradle版本的兼容性迷宫

在解决了主要问题后，我决定再次尝试Android Studio 2.0.0。这次遇到了工程打开极慢的问题。通过分析，发现是Gradle版本不匹配导致的：

1. 项目使用的是Gradle 2.10
2. Android Studio 2.0.0默认期望更高版本
3. 手动修改gradle-wrapper.properties后问题解决

关键配置修改：

// gradle-wrapper.properties distributionUrl=https\://services.gradle.org/distributions/gradle-2.10-all.zip // build.gradle classpath 'com.android.tools.build:gradle:2.0.0'

4.2 真机调试与AVD的微妙差异

在排查过程中，我们尝试了真机调试作为备选方案。这带来了另一个教训：真机环境有时能掩盖一些模拟器上会出现的问题。例如：

• 真机可能自带某些系统库的更新版本
• 不同厂商的设备对资源文件的处理可能有差异
• 真机的性能特征与模拟器完全不同

5. 经验总结与系统化解决方案

经过这一整天的折腾，我总结出了一套完整的ADT到Android Studio迁移流程：

1. 预处理阶段：

   • 备份原始项目
   • 统一所有源文件编码为UTF-8
   • 检查所有资源文件的格式合规性

2. 环境准备：

   • 使用稳定的Android Studio版本（非最新）
   • 预先下载所需的SDK平台和构建工具
   • 确定兼容的Gradle版本

3. 分步迁移：

   • 先创建一个新工程
   • 逐步导入源码和资源
   • 每次变更后立即构建验证

4. 问题排查：

   • 从构建错误的最早出现点入手
   • 使用二分法隔离问题组件
   • 保持原始环境和迁移环境的并行可运行

5. 验证阶段：

   • 在模拟器和真机上分别测试
   • 检查所有UI元素的正确渲染
   • 验证所有功能点的正常运行

这次经历让我深刻认识到，看似简单的开发环境迁移实际上涉及大量隐式依赖和假设。最宝贵的教训是：在环境变更时，要保持系统化的思维方式，不能仅凭直觉行事。同时，有一个经验丰富的伙伴（如我的助教）共同排查问题，能极大提高效率。