Gradle&Maven-Android Gradle 常用命令参数及解释

Posted Android和Java技术驿站

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Gradle&Maven-Android Gradle 常用命令参数及解释相关的知识，希望对你有一定的参考价值。

介绍

Gradle 是google开发的基于 groovy语言 ，用于代替 ant 构建的一种配置型语言

Gradle 是基于groovy语言实现（基于JVM的语法和java类似的脚本语言）的一个android编译系统， google针对Android编译用groovy语言开发了一套 DSL 语言 有额外需要直接使用groovy，或者java代码解决

gradle wrapper

每个基于gradle构建的工程都有一个gradle本地代理，叫做 gradle wrapper 在 /gradle/wrapper/gralde-wrapper.properties 目录中声明了指向目录和版本

如果gradle初次构建缓慢，可以手动下载代理放到${USER}/.gradle/wrapper/dists下

本地建立文件 gradle.properties 或者在用户的 .gradle目录下建立 gradle.properties文件作为全局设置，参数有

 
   
   
 
    
  
    
    
  
  1. # 开启并行编译
    2. 
  
    
    
  
  2. org.gradle.parallel=true
    3. 
  
    
    
  
  3. # 开启守护进程
    4. 
  
    
    
  
  4. org.gradle.daemon=true
    5. 
  
    
    
  
  5. # 按需编译
    6. 
  
    
    
  
  6. org.gradle.configureondemand=true
    7. 
  
    
    
  
  7. # 设置编译jvm参数
    8. 
  
    
    
  
  8. org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
    9. 
  
    
    
  
  9. # 设置代理
    10. 
  
    
    
  
  10. systemProp.http.proxyHost=127.0.0.1
    11. 
  
    
    
  
  11. systemProp.http.proxyPort=10384
    12. 
  
    
    
  
  12. systemProp.https.proxyHost=127.0.0.1
    13. 
  
    
    
  
  13. systemProp.https.proxyPort=10384
    14. 
  
    
    
  
  14. # 开启JNI编译支持过时API
    15. 
  
    
    
  
  15. android.useDeprecatedNdk=true
    16.

安装一个全局的gradle，并配置好Path变量，避免每个项目重复下载，这样后面编译项目就可以直接运行gradle build

常用命令

注意:在window下可以直接运行 gradlew 如果是Linux 或者 mac 命令为 gradle gradlew 这里都简写成 ./gradlew

gradle 任务查询命令

  • 所有后面的命令，都必须在 tasks --all 可见，不然报告找不到这个任务

 
   
   
 
    
  
    
    
  
  1. # 查看任务
    2. 
  
    
    
  
  2. ./gradlew tasks
    3. 
  
    
    
  
  3. # 查看所有任务 包括缓存任务等
    4. 
  
    
    
  
  4. ./gradlew tasks --all
    5. 
  
    
    
  
  5. # 对某个module [moduleName] 的某个任务[TaskName] 运行
    6. 
  
    
    
  
  6. ./gradlew :moduleName:taskName
    7.

说明，module 定义在 工程根 settings.gradle 下，由 include 指定 子模块任务，不代表工程根也有同样的任务，所以需要单独查询

moduel 最佳命名实践为 全小写英文 防止编译兼容问题

快速构建命令

 
   
   
 
    
  
    
    
  
  1. # 查看构建版本
    2. 
  
    
    
  
  2. ./gradlew -v
    3. 
  
    
    
  
  3. # 清除build文件夹
    4. 
  
    
    
  
  4. ./gradlew clean
    5. 
  
    
    
  
  5. # 检查依赖并编译打包
    6. 
  
    
    
  
  6. ./gradlew build
    7. 
  
    
    
  
  7. # 编译并安装debug包
    8. 
  
    
    
  
  8. ./gradlew installDebug
    9. 
  
    
    
  
  9. # 编译并打印日志
    10. 
  
    
    
  
  10. ./gradlew build --info
    11. 
  
    
    
  
  11. # 译并输出性能报告，性能报告一般在 构建工程根目录 build/reports/profile
    12. 
  
    
    
  
  12. ./gradlew build --profile
    13. 
  
    
    
  
  13. # 调试模式构建并打印堆栈日志
    14. 
  
    
    
  
  14. ./gradlew build --info --debug --stacktrace
    15. 
  
    
    
  
  15. # 强制更新最新依赖，清除构建并构建
    16. 
  
    
    
  
  16. ./gradlew clean build --refresh-dependencies
    17.

注意 build命令把 debug、release环境的包都打出来的 如果需要指定构建使用如下命令

gradle 指定构建目标命令

 
   
   
 
    
  
    
    
  
  1. # 编译并打Debug包
    2. 
  
    
    
  
  2. ./gradlew assembleDebug
    3. 
  
    
    
  
  3. # 这个是简写 assembleDebug
    4. 
  
    
    
  
  4. ./gradlew aD
    5. 
  
    
    
  
  5. # 编译并打Release的包
    6. 
  
    
    
  
  6. ./gradlew assembleRelease
    7. 
  
    
    
  
  7. # 这个是简写 assembleRelease
    8. 
  
    
    
  
  8. ./gradlew aR
    9.

gradle 更新最新依赖问题

这个是困扰不少开发者的问题，其实研究一下就知道

  • gradle 相对 maven 做了一层本地缓存 ${user}/.gradle/caches/modules-2（默认缓存更新是 24小时）

  • gradle 在当前工程也做了一层缓存 ${project.root}/.gradle

  • 使用 IDE 这种集成开发环境，也加了一层缓存(在 IDE 的缓存目录里面)

  • 工程开发配置文件（当前工程下 .idea .vsc 等等），这个会影响到代码提示

所以，经常出现 gradle 命令更新到最新依赖代码，IDE 不显示的问题，你需要自行处理好缓存 一般命令行 加入 --refresh-dependencies 可以更新 gradle 部分，但不会影响到 IDE 如果想要 IDE 在写代码时知道更新，你需要刷新或者修改 IDE 的缓存，具体怎么操作需要根据情况自行解决 这里提供2个工具脚本辅助

  • 脚本工具 当前目录 IDEA 类工程清理工具

  • 脚本工具 gradle 本地缓存 SNAPSHOT 清理工具

脚本工具由 python2 编写，怎么做到全局使用，请配置在环境变量中，需要额外功能，请自行修改脚本，本人不提供免费的技术服务

gradle 构建并安装调试命令

 
   
   
 
    
  
    
    
  
  1. # 编译并打Debug包
    2. 
  
    
    
  
  2. ./gradlew assembleDebug
    3. 
  
    
    
  
  3. # 编译app module 并打Debug包
    4. 
  
    
    
  
  4. ./gradlew install app:assembleDebug
    5. 
  
    
    
  
  5. # 编译并打Release的包
    6. 
  
    
    
  
  6. ./gradlew assembleRelease
    7. 
  
    
    
  
  7. #  Release模式打包并安装
    8. 
  
    
    
  
  8. ./gradlew installRelease
    9. 
  
    
    
  
  9. # 卸载Release模式包
    10. 
  
    
    
  
  10. ./gradlew uninstallRelease
    11.

gradle 多渠道打包

assemble还可以和productFlavors结合使用，如果出现类似 Task'install'isambiguousinroot project 这种错误，请查看配置的多个渠道然后修改命令为./gradlew install[productFlavorsName]app:assembleDebug来用命令构建调试

 
   
   
 
    
  
    
    
  
  1. # Release模式打包并安装
    2. 
  
    
    
  
  2. ./gradlew installRelease
    3. 
  
    
    
  
  3. # 卸载Release模式包
    4. 
  
    
    
  
  4. ./gradlew uninstallRelease
    5.

==

 
   
   
 
    
  
    
    
  
  1. # Release模式全部渠道打包
    2. 
  
    
    
  
  2. ./gradlew assembleRelease
    3. 
  
    
    
  
  3. # Release模式 test 渠道打包
    4. 
  
    
    
  
  4. ./gradlew assembleTestRelease
    5. 
  
    
    
  
  5. # debug release模式全部渠道打包
    6. 
  
    
    
  
  6. ./gradlew assemble
    7.

gradle 查看包依赖

 
   
   
 
    
  
    
    
  
  1. ./gradlew dependencies
    2. 
  
    
    
  
  2. # 或者模组的 依赖
    3. 
  
    
    
  
  3. ./gradlew app:dependencies
    4. 
  
    
    
  
  4. # 检索依赖库
    5. 
  
    
    
  
  5. ./gradlew app:dependencies | grep CompileClasspath
    6. 
  
    
    
  
  6. # windows 没有 grep 命令
    7. 
  
    
    
  
  7. ./gradlew app:dependencies | findstr "CompileClasspath"
    8. 
  
    
    
  
    9. 
  
    
    
  
  9. # 将检索到的依赖分组找到 比如 multiDebugCompileClasspath 就是 multi 渠道分发的开发编译依赖
    10. 
  
    
    
  
  10. ./gradlew app:dependencies --configuration multiDebugCompileClasspath
    11. 
  
    
    
  
  11. # 一般编译时的依赖库，不是固定配置方式，建议检索后尝试
    12. 
  
    
    
  
  12. ./gradlew app:dependencies --configuration compile
    13. 
  
    
    
  
  13. # 一般运行时的依赖库，不是固定配置方式，建议检索后尝试
    14. 
  
    
    
  
  14. ./gradlew app:dependencies --configuration runtime
    15.

gradle 依赖管理

  • 传递依赖特性

 
   
   
 
    
  
    
    
  
  1. dependencies {
    2. 
  
    
    
  
  2.     transitive true
    3. 
  
    
    
  
  3. }
    4.

手动配置transitive属性为false，阻止依赖的下载

  • 强制指定编译版本

 
   
   
 
    
  
    
    
  
  1. configurations.all{
    2. 
  
    
    
  
  2.   // transitive false
    3. 
  
    
    
  
  3.   // 强制指定版本
    4. 
  
    
    
  
  4.   resolutionStrategy{
    5. 
  
    
    
  
  5.     force 'org.hamcrest:hamcrest-core:1.3'
    6. 
  
    
    
  
  6.   // 强制不编译
    7. 
  
    
    
  
  7.   all*.excludegroup: 'org.hamcrest', module:'hamcrest-core'
    8. 
  
    
    
  
  8.   }
    9. 
  
    
    
  
  9. }
    10.

  • 动态依赖特性

 
   
   
 
    
  
    
    
  
  1. dependencies {
    2. 
  
    
    
  
  2.     // 任意一个版本
    3. 
  
    
    
  
  3.     compile group:'b',name:'b',version:'1.+'
    4. 
  
    
    
  
  4.     // 最新的版本
    5. 
  
    
    
  
  5.     compile group:'a',name:'a',version:'latest.integration'
    6. 
  
    
    
  
  6. }
    7.

查看详细依赖信息

使用离线模式

 
   
   
 
    
  
    
    
  
  1. ./gradlew aDR --offline
    2.

守护进程

 
   
   
 
    
  
    
    
  
  1. ./gradle build --daemon
    2.

并行编译模式

 
   
   
 
    
  
    
    
  
  1. ./gradle build --parallel --parallel-threads=N
    2.

按需编译模式

 
   
   
 
    
  
    
    
  
  1. ./gradle build --configure-on-demand
    2.

不使用snapshot依赖仓库

前提是离线可以使用时

 
   
   
 
    
  
    
    
  
  1. ./gradlew clean aDR
    2.

设定编码

 
   
   
 
    
  
    
    
  
  1. allprojects {
    2. 
  
    
    
  
  2. ...
    3. 
  
    
    
  
  3.     tasks.withType(JavaCompile){
    4. 
  
    
    
  
  4.         options.encoding = "UTF-8"
    5. 
  
    
    
  
  5.     }
    6. 
  
    
    
  
  6. ...
    7. 
  
    
    
  
  7. }
    8.

仓库设置

设置中心仓库

默认是jcenter、可以是mavenCentral

 
   
   
 
    
  
    
    
  
  1. repositories {
    2. 
  
    
    
  
  2.     // gralde 4.0 以后出现，访问仓库为 https://dl.google.com/dl/android/maven2/
    3. 
  
    
    
  
  3.     google()
    4. 
  
    
    
  
  4.     // 私有，或者国内镜像仓库配置方法
    5. 
  
    
    
  
  5.     maven { url "http://maven.oschina.net/content/groups/public" }
    6. 
  
    
    
  
  6.     // maven centeral 由Sonatype公司提供的服务，它是ApacheMaven、SBT和其他构建系统的默认仓库
    7. 
  
    
    
  
  7.     mavenCentral()
    8. 
  
    
    
  
  8.     // jcenter 由JFrog公司提供的Bintray中的Java仓库,是GoovyGrape内的默认仓库，Gradle内建支持
    9. 
  
    
    
  
  9.     jcenter()
    10. 
  
    
    
  
  10.     // mavenCentral 和 jcenter 搜索库 http://mvnrepository.com/
    11. 
  
    
    
  
    12. 
  
    
    
  
  12. }
    13.

repositories 仓库的写作顺序，会影响到拉取的速度，因为 groovy 脚本执行时，是按数组下标进行的

Android Studio 提速

禁用插件

去掉一些没有用的插件，这个不是固定的，如果你能解决网络问题，开启这些插件对你写代码有好处 Google Cloud Testing、Google Cloud Tools For Android Studio、Goole Login、Google Services、JavaFX、SDK Updater、TestNG-J

android studio 2.2.2新特性 编译缓存

工程根目录 gradle.properties 文件里加上

 
   
   
 
    
  
    
    
  
  1. android.enableBuildCache=true
    2.

这个设置可以让Android Studio 会把依赖的 jar 或 arr 缓存到本地，并且把模块名称设置为 hash 值

这个开启后，可能导致 includeJarFilter 配置失效，Android Studio 升级到 2.3.0修复这个问题

每次编译生成的缓存在 $HOME/.android/build-cache如果缓存过多可以手动删除该目录进行清除

升级到 Android Studio 2.3 后编译不兼容问题

升级到 Android Studio 2.3 后，Gradle Plugin 也升级到 2.3.0

  • 对应推荐使用的 Gradle 版本是 3.3 这时候会发现工程模块目录下 {modulename}/build/intermediates/exploded-aar/ 目录没了

它会在 $HOME/.android/build-cache 下生成一部分缓存文件，来代替 exploded-aar如果需要生成 exploded-aar，可以配置项目目录下的 gradle.properties ，添加一行内容

 
   
   
 
    
  
    
    
  
  1. android.enableBuildCache=false
    2.

然后重新构建项目即可在 {modulename}/build/intermediates/看到 exploded-aar 目录


以上是关于Gradle&Maven-Android Gradle 常用命令参数及解释的主要内容，如果未能解决你的问题，请参考以下文章

Gradle项目学习 & HttpAsyncClient学习 & CountDownLatch学习

CTRL+C w/ Spring Boot & Gradle 杀死 Gradle 守护进程

Gradle&Maven-Gradle专题

Gradle-构建过程&计算build执行时长

Gradle 依赖&解决依赖冲突

JFinal学习 & Gradle配置续