gradle--命令

左手的ㄟ右手 2022-11-28 13:59 131阅读 0赞

原文网址：[gradle--命令\_IT利刃出鞘的博客-CSDN博客][gradle--_IT_-CSDN]

# 其他网址 #

> [gradle命令学习\_约会远行的专栏-CSDN博客\_only daemons for the current gradle version are di][gradle_-CSDN_only daemons for the current gradle version are di]

# 语法 #

gradle [taskName...] [--option-name...]

gradlew是包装器，自动下载包装里定义好的gradle 版本，保证编译环境统一，gradle 是用本地的gradle。所以./gradlew、gradle通用，不神秘，使用更方便一些,可以使用gradle互相替换。其中gradlew的内容可以在项目的目录下查看。

*  任务 如果需要处理多任务，任务列表必须使用空格分割开，如

gradle test deploy

*  选项 选项可以放在任务列表前也可以放在任务列表后，如下的写法作用是相同的

gradle --console=plain test
    gradle test --console=plain

> 记忆技巧：长格式的选项 表示启用特性的都具有反向操作（关闭特性），关闭特性长选项格式在启用特性前缀no-

--build-cache
    --configure-on-demand
    --daemon
    --parallel
    --scan
    
    --no-build-cache
    --no-configure-on-demand
    --no-daemon
    --no-parallel
    --no-scan

# 参数 #

<table> 
 <thead> 
  <tr> 
   <th>command_Parameters</th> 
   <th>introduction</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-?, -h, --help</td> 
   <td>展示帮助信息</td> 
  </tr> 
  <tr> 
   <td>-a, --no-rebuild</td> 
   <td>忽略构建"项目依赖",[废弃]</td> 
  </tr> 
  <tr> 
   <td>-b, --build-file</td> 
   <td>使用用-b参数将会忽略setting文件,用指定的.gradle文件进行构建(默认情况下首先会寻找当前目录下的 build.gradle文件或依据settings.gradle中的配置寻找子项目中的build.gradle)</td> 
  </tr> 
  <tr> 
   <td>--build-cache</td> 
   <td>支持gradle缓存。Gradle将试图重用以前的版本的输出</td> 
  </tr> 
  <tr> 
   <td>-c, --settings-file</td> 
   <td>执行指定的*.gralde文件(默认settings.gradle)</td> 
  </tr> 
  <tr> 
   <td>--configure-on-demand</td> 
   <td>配置必要的项目。Gradle将试图减少大型多项目构建的配置时间</td> 
  </tr> 
  <tr> 
   <td>--console</td> 
   <td>指定控制台输出类型,可选值有’plain’、‘auto’(默认)、‘rich’、‘verbose’。plain 是生成普通的文本，该选项禁止所有颜色和富文本输出;auto当构建程序与控制台相关联时启动颜色和富文本输出，或者不关联时生成普通文本;rich 启动颜色和富文本输出，忽略构建程序是否关联了控制台,如果没有关联构建输出将输出 ANSI 控制字符来生产富文本输出;verbose会输出更多的详细信息(感觉很乱，调试问题可能会用到)</td> 
  </tr> 
  <tr> 
   <td>--continue</td> 
   <td>构建时遇到错误忽略报错,继续构建,默认报错后终止构建</td> 
  </tr> 
  <tr> 
   <td>-D, --system-prop</td> 
   <td>-D属性会被传送给启动Gradle的jvm，作为一个系统属性被jvm使用(例如:-Dmyprop=myvalue)</td> 
  </tr> 
  <tr> 
   <td>-d, --debug</td> 
   <td>指定日志输出级别为debug,可打印一般堆栈信息</td> 
  </tr> 
  <tr> 
   <td>--daemon</td> 
   <td>使用Gradle守护进程执行构建,如果没有守护进程则启动一个守护进程</td> 
  </tr> 
  <tr> 
   <td>--foreground</td> 
   <td>以foreground形式启动守护进程</td> 
  </tr> 
  <tr> 
   <td>-g, --gradle-user-home</td> 
   <td>指定默认的指定Gradle 用户home目录.默认在"用户目录/.gradle"</td> 
  </tr> 
  <tr> 
   <td>-I, --init-script</td> 
   <td>运行指定初始化脚本,脚本会在build之前执行.查找init.gradle的路径顺序：./,USER_HOME/.gradle/ ,USER_HOME/.gradle/init.d/,GRADLE_HOME/init.d/</td> 
  </tr> 
  <tr> 
   <td>-i, --info</td> 
   <td>指定日志级别为info</td> 
  </tr> 
  <tr> 
   <td>--include-build</td> 
   <td>在组合中包含指定的构建</td> 
  </tr> 
  <tr> 
   <td>-m, --dry-run</td> 
   <td>模拟任务执行过程并将过程打印出来,并非真正执行,目的是展示执行的过程</td> 
  </tr> 
  <tr> 
   <td>--max-workers</td> 
   <td>设定参与构建的cpu的核数</td> 
  </tr> 
  <tr> 
   <td>--no-build-cache</td> 
   <td>禁用构建缓存</td> 
  </tr> 
  <tr> 
   <td>--no-configure-on-demand</td> 
   <td>根据需要禁用配置</td> 
  </tr> 
  <tr> 
   <td>--no-daemon</td> 
   <td>禁用守护进程,不使用守护进程执行构建. 如果你已经配置了Gradle总会使用守护进程运行，此选项有帮助</td> 
  </tr> 
  <tr> 
   <td>--no-parallel</td> 
   <td>禁止使用并行模式构建项目</td> 
  </tr> 
  <tr> 
   <td>--no-scan</td> 
   <td>禁用创建构建扫描,更多信息可以参考https://gradle.com/build-scans</td> 
  </tr> 
  <tr> 
   <td>--offline</td> 
   <td>采用离线模式构建项目,不使用网路资源(此时很有可能出现构建失败的情况慎用)</td> 
  </tr> 
  <tr> 
   <td>-P, --project-prop</td> 
   <td>设置Gradle的项目参数,会被直接加载到Gradle领域对象上(例如:-Pmyprop=myvalue)</td> 
  </tr> 
  <tr> 
   <td>-p, --project-dir</td> 
   <td>为gradle指定起始目录。默认为当前目录</td> 
  </tr> 
  <tr> 
   <td>--parallel</td> 
   <td>采用并行模式构建。gradle采用配置的线程数进行构建</td> 
  </tr> 
  <tr> 
   <td>--profile</td> 
   <td>存储一份执行报告到&lt;build_dir&gt;/reports/profile,包括总时间和在配置和任务执行阶段的细节。并以时间大小倒序排列，并且记录了任务的执行情况.Gradle会根据构建时间命名这些报告文件</td> 
  </tr> 
  <tr> 
   <td>--project-cache-dir</td> 
   <td>指定项目的缓存目录。默认在项目目录中。</td> 
  </tr> 
  <tr> 
   <td>-q, --quiet</td> 
   <td>静默方式，只输出error信息</td> 
  </tr> 
  <tr> 
   <td>--recompile-scripts</td> 
   <td>强制构建脚本重新编译[废弃]</td> 
  </tr> 
  <tr> 
   <td>--refresh-dependencies</td> 
   <td>刷新依赖的状态</td> 
  </tr> 
  <tr> 
   <td>--rerun-tasks</td> 
   <td>忽略先前缓存的任务结果</td> 
  </tr> 
  <tr> 
   <td>-S, --full-stacktrace</td> 
   <td>打印全部详细信息，所有异常的堆栈信息</td> 
  </tr> 
  <tr> 
   <td>-s, --stacktrace</td> 
   <td>打印所有异常的堆栈信息</td> 
  </tr> 
  <tr> 
   <td>--scan</td> 
   <td>创建一个构建扫描。如果构建扫描插件没有被应用，那么gradle会发出警告(<a href="https://gradle.com/build-scans" title="Build Scan™ - Root Cause Analysis Data | Gradle Enterprise" rel="nofollow">Build Scan™ - Root Cause Analysis Data | Gradle Enterprise</a>)</td> 
  </tr> 
  <tr> 
   <td>--status</td> 
   <td>统计信息，展示正在运行和最近停止的gradle进程</td> 
  </tr> 
  <tr> 
   <td>--stop</td> 
   <td>如果守护进程正在运行，停止gradle的守护进程</td> 
  </tr> 
  <tr> 
   <td>-t, --continuous</td> 
   <td>连续构建模式,采用此模式后会监听所有构建文件变化,文件发生变化后会自动重新构建</td> 
  </tr> 
  <tr> 
   <td>-u, --no-search-upward</td> 
   <td>不使用父目录中的settings.gradle文件,如果不添加此项,父目录的setting.gradle会覆盖子目录下的配置</td> 
  </tr> 
  <tr> 
   <td>-v, --version</td> 
   <td>打印gradle版本信息</td> 
  </tr> 
  <tr> 
   <td>-w, --warn</td> 
   <td>指定日志级别为warn</td> 
  </tr> 
  <tr> 
   <td>--warning-mode</td> 
   <td>指定要生成的警告模式。值是’all’, ‘summary’(默认) or ‘no’</td> 
  </tr> 
  <tr> 
   <td>-x, --exclude-task</td> 
   <td>任务排除,跳过执行指定任务</td> 
  </tr> 
 </tbody> 
</table>

#       gradle命令 #

<table style="width:509px;"> 
 <tbody> 
  <tr> 
   <td style="vertical-align:top;width:170px;"> <p style="margin-left:0pt;"><strong><strong>命令</strong></strong></p> </td> 
   <td style="vertical-align:top;width:338px;"> <p style="margin-left:0pt;"><strong><strong>作用</strong></strong></p> </td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;width:170px;">gradle dependencies</td> 
   <td style="vertical-align:top;width:338px;">打印所有依赖树</td> 
  </tr> 
  <tr> 
   <td style="width:170px;"> <p style="margin-left:0pt;">gradle projects</p> </td> 
   <td style="width:338px;"> <p style="margin-left:0pt;">打印目前的项目构成</p> </td> 
  </tr> 
  <tr> 
   <td style="width:170px;"> <p style="margin-left:0pt;">gradle tasks</p> </td> 
   <td style="width:338px;"> <p style="margin-left:0pt;">当前项目的所有任务</p> </td> 
  </tr> 
 </tbody> 
</table>

# gradlew命令 #

<table> 
 <tbody> 
  <tr> 
   <td style="vertical-align:top;width:299px;"> <p style="margin-left:0pt;"><strong><strong>命令</strong></strong></p> </td> 
   <td style="vertical-align:top;width:451px;"> <p style="margin-left:0pt;"><strong><strong>作用</strong></strong></p> </td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;width:299px;">./gradlew 模块名:dependencies</td> 
   <td style="vertical-align:top;width:451px;">打印模块下的依赖树</td> 
  </tr> 
  <tr> 
   <td style="width:299px;">gradlew cleanBuildCache</td> 
   <td style="width:451px;"> <p>删除缓存。</p> <p>Gradle 缓存默认位于以下位置（若自己指定过位置，位置是指定位置的caches文件夹），可用命令删除，也可手动删除</p> <p>在Windows上：%USER_HOME%/.gradle/caches/<br> 在Mac / Unix上：$HOME/.gradle/caches/</p> </td> 
  </tr> 
  <tr> 
   <td style="width:299px;">gradlew build --refresh-dependencies</td> 
   <td style="width:451px;">先清除缓存再编译。</td> 
  </tr> 
 </tbody> 
</table>

[gradle--_IT_-CSDN]: https://knife.blog.csdn.net/article/details/108075674
[gradle_-CSDN_only daemons for the current gradle version are di]: https://blog.csdn.net/yue530tomtom/article/details/79361820