简述Android中gradle的简单知识

在Android开发中在项目根目录、app或者其他module中我们都能看到build.gradle 这个文件，我们也知道Android项目的编译和运行都是通过gradle来实现，需要引入第三方库时就找到对应项目的build.gradle 中按照集成文档修修改改引入即可，有可能也不会过多的去关注，这里简单介绍下关于在Android开发中gradle的使用。

1. 调整gradle的编译参数（gradle.properties文件中配置）
   内存配置：

   org.gradle.jvmargs=-Xmx4096m -XX:MaxPermSize=1024m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8

   • 堆的内存分配用-Xms和-Xmx
     1. Xms分配堆最小内存，默认为物理内存的1/64；
     2. Xmx分配最大内存，默认为物理内存的1/4。
   • 非堆内存分配用-XX:PermSize和-XX:MaxPermSize
     1. XX:PermSize分配非堆最小内存，默认为物理内存的1/64；
     2. XX:MaxPermSize分配最大内存，默认为物理内存的1/4。

   守护进程
   org.gradle.daemon=true
   并行编译
   org.gradle.parallel=true
   开启缓存
   android.enableBuildCache=true
   开启孵化模式
   org.gradle.configureondemand=true
   更多配置信息，移步Gradle官方文档

2. 推荐引用固定版本依赖库

    dependencies { 
      compile 'com.google.code.gson:gson:2.2.1' //推荐写法
    // compile 'com.google.code.gson:gson:2.+' // 不推荐写法
   }
   

   虽然带+号的引用可以保证库是最新的，但更新的新库有没有更改库逻辑而带来的bug是未知的。

3. module和jar的依赖方式

    implementation project(':commonlibrary')
    implementation files('libs/alipaysdk.jar')
   

4. 用exclude关键字解决依赖库冲突问题
   如我们在Android项目中集成某个第三方库时，可能第三方库也会引入某个本地已经引入的库，所以就会存在引入多版本的依赖库。

   • 移除整个组织的库

     compile ('com.facebook.fresco:animated-webp:0.13.0') { 
            exclude group: 'com.android.support' // 仅仅写组织名称
     }
     

   • 精确移除某个指定库

     compile('com.android.support:appcompat-v7:23.2.0') {
           exclude group: 'com.android.support', module: 'support-annotations' // 写全称
           exclude group: 'com.android.support', module: 'support-compat'
           exclude group: 'com.android.support', module: 'support-v4'
           exclude group: 'com.android.support', module: 'support-vector-drawable'
     }
     

   如何产看项目中的第三方库的依赖关系？
   执行以下命令行：（如何你想查看某个module的依赖关系，此处的app使用你的module名来替换即可）

   • Windows：
     gradlew :app:dependencies > dependencis.txt
   • MAC:
     ./gradlew :app:dependencies > dependencis.txt

5. 设置java版本

   • 如果是在某个module中设置，那么就在对应module的build.gradle文件中配置：

     android {
        compileOptions {
            sourceCompatibility JavaVersion.VERSION_1_8
            targetCompatibility JavaVersion.VERSION_1_8
        }
     }
     

   • 如果想要做全局配置，那么就在根目录的build.gradle中配置：

     allprojects {
        repositories {
           jcenter()
        }
       tasks.withType(JavaCompile) {
          sourceCompatibility = JavaVersion.VERSION_1_8
          targetCompatibility = JavaVersion.VERSION_1_8
       }
     }
     

6. 在build.gradle中设置productFlavors

   android {  
         productFlavors {
             baidu {
                 manifestPlaceholders = [UMENG_CHANNEL_VALUE: "baidu"]
             }  
             xiaomi {
                 manifestPlaceholders = [UMENG_CHANNEL_VALUE: "xiaomi"]
             }
         }  
     }
   

7. assemble是Gradle中的编译打包命令

   • 打包baidu渠道的release版本
     gradlew assembleBaiduRelease
   • 打包baidu渠道的debug版本
     gradlew assembleBaiduDebug
   • 生成baidu渠道的Release和Debug版本
     gradlew assembleBaidu
   • 打包全部渠道Release版本
     gradlew assembleRelease

8. 为各渠道设置各自的配置信息

   android {  
          productFlavors {
              baidu {
                  applicationId "com.liujc.demo.baidu"
                  manifestPlaceholders = [UMENG_CHANNEL_VALUE: "baidu",
                                         APP_NAME :  "app应用01",  //app名称
                                         ]
                  buildConfigField "String", "API_APP_ID", "\"10001\""
              }  
              xiaomi {
                  applicationId "com.liujc.demo.xiaomi"
                  manifestPlaceholders = [UMENG_CHANNEL_VALUE: "xiaomi",
                                         APP_NAME :  "app应用02",  //app名称
                                         ]
                  buildConfigField "String", "API_APP_ID", "\"10002\""
              }
          }  
      }
   

   如何使用？
   如上的applicationId 和 manifestPlaceholders 中信息在AndroidManifest中使用如下：

     android:label="${APP_NAME}"
     <uses-permission android:name="${applicationId}.permission.JPUSH_MESSAGE" />
   

   而buildConfigField 中的参数在代码中使用BuildConfig.API_APP_ID。

9. Android Studio 为多渠道执行自定义名称打包命令：

   proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
               applicationVariants.all { variant ->
                   variant.outputs.each { output ->
                       def outputFile = output.outputFile
                       if (outputFile != null && outputFile.name.endsWith('.apk')) {
                           // 计划输出apk名称为App_V1.0.0_baidu.apk
                           def fileName = "App_V${variant.productFlavors.versionName}_${variant.productFlavors.name}.apk"
                           output.outputFile = new File(outputFile.parent, fileName)
                       }
                   }
               }
   

   下面是多渠道配置：

   android {  
       productFlavors {
           baidu {
               applicationId "com.liujc.demo.baidu"
               versionCode 1
               versionName "1.0.0"
               manifestPlaceholders = [UMENG_CHANNEL_VALUE: "baidu",
                                      APP_NAME :  "app应用01",  //app名称
                                      ]
               buildConfigField "String", "API_APP_ID", "\"10001\""
           }  
           xiaomi {
               versionCode 2
               versionName "1.0.1"
               applicationId "com.liujc.demo.xiaomi"
               manifestPlaceholders = [UMENG_CHANNEL_VALUE: "xiaomi",
                                      APP_NAME :  "app应用02",  //app名称
                                      ]
               buildConfigField "String", "API_APP_ID", "\"10002\""
           }
       }  
   }
   

   打包成功后你会发现包名为：App_V[1.0.0]_[baidu].apk ，这不是我想要的啊，怎么都多了个中括号呢，修改打包代码：

    proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
                applicationVariants.all { variant ->
                    variant.outputs.each { output ->
                        def outputFile = output.outputFile
                        if (outputFile != null && outputFile.name.endsWith('.apk')) {
                            // 计划输出apk名称为App_V1.0.0_baidu.apk
                            def fileName = "App_V${variant.productFlavors[0].versionName}_${variant.productFlavors[0].name}.apk"
                            output.outputFile = new File(outputFile.parent, fileName)
                        }
                    }
                }
   

   再重新打包，成功后发现包名为：App_V1.0.0_baidu.apk OK了。

10. 打包时相关属性介绍

    name：build type的名字
    applicationIdSuffix：应用id后缀
    versionNameSuffix：版本名称后缀
    debuggable：是否生成一个debug的apk
    minifyEnabled：是否混淆
    proguardFiles：混淆文件
    signingConfig：签名配置
    manifestPlaceholders：清单占位符
    shrinkResources：是否去除未利用的资源，默认false，表示不去除。
    zipAlignEnable：是否使用zipalign工具压缩。
    multiDexEnabled：是否拆成多个Dex
    multiDexKeepFile：指定文本文件编译进主Dex文件中
    multiDexKeepProguard：指定混淆文件编译进主Dex文件中

---

以下开发中开发中常用的gradle命令

1. 生成Android项目的依赖文件并导出
   gradlew :app:dependencies > dependencis.txt
2. 查看编译日志详细信息
   gradlew compileDebugSource --stacktrace -info
3. 输出项目debug编译日志
   gradlew assembleDebug --info>log2.txt