尽管Android Studio已成为当前主流的安卓开发环境，但仍有部分开发者在维护或迭代基于Eclipse + ADT的古老项目，在这些项目的打包过程中，开发者常常会遇到各种各样的报错，这些错误信息有时模糊不清，令人头疼，本文旨在系统性地梳理Eclipse环境下Android打包的常见错误类型，并提供清晰的排查思路与解决方案,帮助开发者高效地定位并解决问题。
资源文件与R.java生成问题
这是最常见的一类打包错误，根源通常在于项目资源文件存在瑕疵，导致R.java文件无法正确生成或更新。R.java是Android项目自动生成的资源索引文件，所有对资源的引用都依赖于它，一旦它出错,整个项目将无法编译。
常见原因：
- XML文件语法错误：
res/layout或res/values目录下的XML文件存在标签未闭合、属性名拼写错误、非法字符等问题。 - 资源文件名不规范： 资源文件名只能包含小写字母、数字和下划线，不能以数字开头，使用
Main_Activity.xml或1layout.xml都会导致错误。 - 资源文件损坏： 偶尔，某些图片资源（如
.9.png）在下载或转移过程中可能损坏,导致aapt工具无法处理。
排查与解决：
- 查看控制台和问题视图： 打包失败时，Eclipse的“控制台”和“问题”视图会输出详细的错误信息，通常会精确到某个具体的XML文件和行号,这是定位问题的首要途径。
- 清理并重建项目： 依次点击菜单栏的“项目” -> “清理”，选择你的项目并清理，清理操作会删除
bin和gen目录下的自动生成文件，然后重新构建,这能解决大部分因缓存或索引错乱导致的问题。 - 手动检查： 根据错误提示，仔细检查对应的资源文件，特别注意颜色、尺寸、字符串等值的定义是否正确,以及布局文件的层级结构是否合理。
依赖库冲突与配置错误
现代Android项目很少不依赖第三方库，在Eclipse中，依赖库的管理主要通过JAR包和Library Project两种方式,配置不当极易引发打包失败。
常见原因：
- JAR包重复： 项目中不同模块或libs文件夹中引入了同一个库的不同版本，同时存在两个版本的
support-v4.jar,会导致类冲突。 - Library Project引用错误： 作为库的项目没有正确勾选“Is Library”属性，或者主项目没有在“Android”属性中正确添加对库项目的引用。
- 导出顺序问题： 在“Java构建路径”的“顺序和导出”选项卡中，依赖库的导出顺序不正确,可能导致主项目无法找到库中的类。
为了更清晰地展示,下表小编总结了两种依赖方式的常见问题：
| 依赖类型 | 常见问题 | 解决方案 |
|---|---|---|
| JAR包 | 重复引入、版本冲突 | 检查libs目录和“构建路径”中的库，移除重复项。 |
| Library Project | 未勾选Is Library、主项目未正确引用 | 右键库项目 -> 属性 -> Android -> 勾选Is Library，右键主项目 -> 属性 -> Android -> 库区域 -> 添加。 |
项目构建配置问题
项目的核心构建设置，如Java编译级别、目标SDK版本等，如果配置不匹配,也会在打包阶段暴露问题。
排查要点：
- Java编译器级别： 右键项目 -> 属性 -> Java编译器，确保“编译器合规性级别”设置正确，对于老旧项目，通常设置为1.6或1.7，如果项目代码使用了高版本JDK的特性，但编译级别设置过低,会报错。
- 项目构建目标： 右键项目 -> 属性 -> Android，确保“项目构建目标”选择了一个已安装的SDK版本，并且该版本与
AndroidManifest.xml中声明的minSdkVersion和targetSdkVersion兼容。 - 检查“顺序和导出”： 在“Java构建路径”的“顺序和导出”选项卡中，确保“Android Private Libraries”或“Android Dependencies”被勾选,这是保证依赖库能被打包进APK的关键一步。
AndroidManifest.xml文件审查
AndroidManifest.xml是整个应用的配置清单,其中的任何错误都会导致打包失败。
检查清单：
- 语法正确性： 确保所有标签正确闭合,属性值用引号包裹。
- 包名唯一性：
manifest标签的package属性是应用的唯一标识,不能为空或与已安装应用冲突。 - 组件声明完整： 所有在代码中使用的Activity、Service、BroadcastReceiver都必须在此文件中声明，否则运行时会崩溃,打包时也可能因找不到类而失败。
- 权限声明： 如果应用使用了网络、存储等需要权限的功能，确保已在此文件中声明相应的
<uses-permission>。
Proguard代码混淆配置
当项目启用Proguard进行代码混淆和优化时，打包过程会增加一步代码转换，如果Proguard配置不当,很容易导致打包失败。
常见错误与解决：
- 警告转错误： Proguard在处理过程中可能会发现一些无法确定的引用并输出警告，默认情况下，这些警告可能不会中断构建,但某些配置会将其视为错误。
- 关键类被混淆： 第三方SDK、通过反射调用的类、JNI调用的native方法对应的类等，都不能被混淆，如果被混淆，轻则功能异常,重则直接打包失败。
解决方案：
在项目根目录下的proguard-project.txt文件中，添加-keep指令来保留不需要混淆的类和方法,保留一个包下的所有类：
-keep class com.example.mylibrary.** { *; }对于第三方SDK，通常其官方文档会提供所需的Proguard配置规则,直接复制添加即可。
相关问答FAQs
Q1: 清理并重建项目后，R.java仍然报红或无法生成，该怎么办？
A1: 如果常规的清理操作无效,可以尝试以下深度排查步骤：
- 手动删除： 关闭Eclipse，手动删除项目工作区目录下的
bin文件夹和gen文件夹。 - 检查构建自动： 重新打开Eclipse，确保“项目”菜单下的“构建自动”是勾选状态。
- 检查Eclipse设置： 检查Eclipse的“偏好设置” -> “Android” -> “构建”中，是否勾选了“在构建中自动修复错误”。
- 重启Eclipse： 有时Eclipse本身的状态异常,重启IDE可以解决很多莫名其妙的问题。
- 检查项目编码： 确保项目文件编码（尤其是XML文件）为UTF-8,错误的编码可能导致aapt解析失败。
Q2: 打包时出现“Conversion to Dalvik format failed with error 1”错误是什么原因？
A2: 这是一个非常经典的错误，通常指向类重复定义的问题，最常见的原因是项目中存在重复的JAR包，你可能将一个JAR包同时放在了项目的libs目录下，又通过“Java构建路径”->“库”->“添加外部JAR”的方式添加了一次,解决方法是：
- 右键项目 -> 属性 -> Java构建路径 -> “库”选项卡。
- 仔细检查列表中的所有JAR包，移除所有重复的条目，建议统一使用
libs目录来管理所有JAR依赖,Eclipse会自动将其添加到构建路径中。 - 检查“顺序和导出”选项卡，确保没有重复导出同一个库，清理并重新构建项目后,此问题通常能得到解决。
【版权声明】：本站所有内容均来自网络，若无意侵犯到您的权利，请及时与我们联系将尽快删除相关内容!
发表回复