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处理源文件。在编辑器中临时更改编码只能解决显示问题，而实际构建时使用的仍然是乱码的字节流。正确的做法是：
- 在乱码状态下全选文件内容并复制
- 新建一个UTF-8编码的文件
- 粘贴内容并保存
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 系统性排查方法
我和助教一起开发了一套有效的排查流程：
- 新建一个干净工程，确认基础环境正常
- 逐步导入原项目的Java类文件，每次构建确认状态
- 分批次导入资源文件，定位问题文件
- 对可疑图片使用图像处理软件重新导出
最终我们发现f1.png、p1.png和start.png三个文件有问题。用Photoshop重新保存这些文件后，构建错误消失。
4. 环境配置的深层次问题
4.1 Gradle版本的兼容性迷宫
在解决了主要问题后，我决定再次尝试Android Studio 2.0.0。这次遇到了工程打开极慢的问题。通过分析，发现是Gradle版本不匹配导致的：
- 项目使用的是Gradle 2.10
- Android Studio 2.0.0默认期望更高版本
- 手动修改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迁移流程：
预处理阶段：
- 备份原始项目
- 统一所有源文件编码为UTF-8
- 检查所有资源文件的格式合规性
环境准备：
- 使用稳定的Android Studio版本（非最新）
- 预先下载所需的SDK平台和构建工具
- 确定兼容的Gradle版本
分步迁移：
- 先创建一个新工程
- 逐步导入源码和资源
- 每次变更后立即构建验证
问题排查：
- 从构建错误的最早出现点入手
- 使用二分法隔离问题组件
- 保持原始环境和迁移环境的并行可运行
验证阶段：
- 在模拟器和真机上分别测试
- 检查所有UI元素的正确渲染
- 验证所有功能点的正常运行
这次经历让我深刻认识到，看似简单的开发环境迁移实际上涉及大量隐式依赖和假设。最宝贵的教训是：在环境变更时，要保持系统化的思维方式，不能仅凭直觉行事。同时，有一个经验丰富的伙伴（如我的助教）共同排查问题，能极大提高效率。