AndroidStudio的build.gradle文件配置以及导入支持包的问题

发表于   |   分类于   |     |   阅读次数

使用AndroidStudio的过程中，对build.gradle文件配置以及导入支持包的问题的一些总结，在此记录下来。有时候，头疼的不是面对新功能无从下手，而是为了可以正常敲代码与编译环境作斗争。

关于build.gradle配置

  • compileSdkVersion

    SDK的版本号，也就是API Level，例如API-19、API-20、API-21等等，一般保持最新即可。

  • buildeToolVersion

    构建工具的版本，其中包括了打包工具aapt、dx等等，这个一般与CompileSdkVersion对应。
    这个工具的目录位于..your_sdk_path/build-tools/XX.XX.XX，这个版本号一般是API-LEVEL.0.0。

  • 可以用高版本的build-tool去构建一个低版本的sdk工程

    例如build-tool的版本为20，去构建一个sdk版本为18的

    18、buildToolsVersion "22.0.1"``` 这样也是OK的。
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    * **targetSdkVersion与minSdkVersion**与清单文件中配置一样，含义一样。
    * **android:minSdkVersion**
    	表示APP所兼容的最低API版本，这个一般是项目初期就定好的，轻易不会改动。
    	指明应用程序运行所需的最小APIlevel。如果不指明的话，默认是1。也就是说该应用兼容所有的android版本。我们应该总是声明这个属性。如果系统的APIlevel低于android:minSdkVersion设定的值，那么android系统会阻止用户安装这个应用。
    	报错信息为：INSTALL_FAILED_OLDER_SDK
    	如果指明了这个属性，并且在项目中使用了高于这个API level的API， 那么会在编译时报错。
    * **android:targetSdkVersion**
    	表示应用程序目标API Level的一个整数，一般设置成最高的API版本。如果不设置，默认值和minSdkVersion相同。
    	这个属性通知系统，你已经针对这个指定的目标版本测试过你的程序，系统不必再使用兼容模式来让你的应用程序向前兼容这个目标版本。应用程序仍然能在低于targetSdkVersion的系统上运行。
    	为了让应用程序支持每个Android版本，应当提高targetSdkVersion的值到最新的APIlevel，然后在对应的平台上彻底的测试你的应用。
    	可知，targetSdkVersion这个属性是在程序运行时期起作用的，系统根据这个属性决定要不要以兼容模式运行这个程序。一般情况下，应该将这个属性的值设置为最新的API level 值，这样的话可以利用新版本系统上的新特性。
    # 关于v4、v7的导入
    * 假如项目是APPModule，需要依赖另外两个Module，A和B。但是ModuleA和ModuleB都需要导入V4包，各自在相应的gradle文件中compile v4即可，不过最好版本保持一致，这样是没问题的。假如此时APP Module需要v4包，就不必引入v4了，因为在依赖ModuleA和ModuleB的时候，已经也依赖了v4包。假如此时APP Module需要v7包，只需要在APP Module的gradle里面compile v7包就可以了，这样并不会冲突。
    * v7里面包含了v4的所有内容，所以如果导入了v7，就不用再导入v4。
    * 如果原来项目中引入的v7版本是19，后来想升级到23，直接改相应的数字就可以，但是这个版本要存在。同时，要修改相应的compileSdkVersion、buildeToolVersion、targetSdkVersion版本号，保持一致，不然会出现```Process 'command 'd:\Program\Android\sdk\build-tools\23.0.3\aapt.exe'' finished with non-zero exit value 1```这种错误。
    # 错误类型
    * aapt.exe'' finished with non-zero exit value 1
    	这种错误一般是由compileSdkVersion、buildeToolVersion、targetSdkVersion这种版本号与v4或v7的版本号不一致导致的，修复的方法就是修改这些数字，使版本号一致。当项目中存在多个Module的时候，最好将compileSdkVersion、buildeToolVersion、targetSdkVersion等配置成一样的，防止出现莫名其妙的问题。
    * Multiple dex files define  XXXXandroid/support/v4/aXXXX
    	
    	这种错误，一定是v4或v7包重复引用导致的，除了要看build.gradle文件的compile的支持包以外，还要看libs文件夹下是不是也有了这些支持包。相应的，如果报错信息Multiple dex files define是这种开头的，一定是导包重复造成的，有可能重复导入了其他的第三方，具体是哪个重复，从报错信息里应该能看出来。
    * Error: No resource found that matches the given name: attr  XXXXXX
    	这种错误一定是compileSdkVersion、buildeToolVersion、targetSdkVersion这种版本号与v4或v7的版本号不一致导致的，修复的方法就是修改这些数字，使版本号一致。比如原来是引用的v4的19.0.0版本，后来改成23.1.1，但是targetSdkVersion却还是原来的19，这样编译的时候，编译的时候使用的是v4的23.1.1版本，但是找资源的时候，还是找的v4的19.0.0版本的，就会找不到。
    * Attribute has already been defined XXXXXXXXXXXX
    	这种错误一是重复导包导致，二是自定义的属性与系统中（一般是支持包中）的属性名字重复。如果确定没有重复导包，就复制那个重复的属性名字，Android Studio中按Ctrl + H组合键，全局搜索，肯定可以找到自己定义的那个属性。不要觉得自己根本没有定义过这个属性，因为有可能项目的其他成员定义过，或者自己忘了，都有可能发生，利用工具，相信工具。一般是在attr.xml这个文件中。
    * com.android.dex.DexIndexOverflowException: Cannot merge new index XXXXXX into a non-jumbo instruction!（这个XXX数字一定大于65536）
    以及com.android.dex.DexIndexOverflowException: method ID not in [0, 0xffff]: 65536”
    	错误原因：
    	这个错误可能在导入第三方的时候会出现。
    	原因是同时在工程中引入了多个第三方jar包，导致调用的方法数超过了android设定的65536个（DEX 64K problem），进而导致dex无法生成，也就无法生成APK文件。
    	限制原因:早期的Dalvik VM内部使用short类型变量来标识方法的id，就有了 最大方法数的限制65536。
    	解决办法有两种：
    	第一种是**忽略方法数限制的检查**
    	
    	这样做的缺点是apk无法再低版本的设备上面安装，会出现错误：```INSTALL_FAILED_DEXOPT

    在App Module的build.gradle文件的android节点下添加如下代码：

    1
    2
    3
    dexOptions {
            jumboMode = true
        }

    第二种是分包

    通过在defaultConfig中设置multiDexEnabled可以开启分包模式，分包之后的Dex就低于了限制数，保证了正常的打包。

1
2
3
4
5
6
7
8
9
defaultConfig {
        multiDexEnabled=true
    }
//这时还要 
compile 'com.google.android:multidex:0.1' 0.1是版本号，用最新的就行。

  • 程序包org.apache.http 、org.apache.http.client.utils等不存在

    解决：在build.gradle(Module:app) 文件的android的那个括号里加上 useLibrary 'org.apache.http.legacy'

参考

总结

  • 在项目中，对于第三方的SDK或者jar等，可以在build.gradle中compile的就compile，不要导入Module，再compile project，容易出问题。

  • 导入第三方的时候，一定要仔细参考官方文档集成说明或者官方demo。

  • 遇到这些问题的时候，谁都会头大，就这些问题，折腾了我一个多星期，慢慢熬，去google上多看看别人的相同或相似问题，看看大神们的解答，最好明白其中的道理，记录下来，看多了有时候说不定就突然把问题解决了。