Android Gradle 常用命令参数及解释
介绍
Gradle是google开发的基于groovy语言,用于代替ant构建的一种配置型语言
Gradle是基于groovy语言实现(基于JVM的语法和java类似的脚本语言)的一个Android编译系统,google针对Android编译用groovy语言开发了一套dsl,有额外需要直接使用groovy解决
gradlewrapper
每个基于gradle构建的工程都有一个gradle本地代理,叫做gradlewrapper
在/gradle/wrapper/gralde-wrapper.properties目录中声明了指向目录和版本
本地建立文件gradle.properties或者在用户的.gradle目录下建立gradle.properties文件作为全局设置,参数有
# 开启并行编译 org.gradle.parallel=true # 开启守护进程 org.gradle.daemon=true # 按需编译 org.gradle.configureondemand=true # 设置编译jvm参数 org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8 # 设置代理 systemProp.http.proxyHost=127.0.0.1 systemProp.http.proxyPort=10384 systemProp.https.proxyHost=127.0.0.1 systemProp.https.proxyPort=10384 # 开启JNI编译支持过时API android.useDeprecatedNdk=true
安装一个全局的gradle,并配置好Path变量,避免每个项目重复下载,这样后面编译项目就可以直接运行gradlebuild
常用命令
注意:在window下可以直接运行 gradlew 如果是Linux 或者 mac 命令为 gradle gradlew 这里都简写成 ./gradle
任务命令
# 查看所有任务 ./gradlew tasks --all # 对某个module [moduleName] 的某个任务[TaskName] 运行 ./gradlew :moduleName:taskName
快速构建命令
# 查看构建版本 ./gradlew -v # 清除build文件夹 ./gradlew clean # 检查依赖并编译打包 ./gradlew build # 编译并安装debug包 ./gradlew installDebug # 编译并打印日志 ./gradlew build --info # 调试模式构建并打印日志 ./gradlew build --info --debug --stacktrace # 强制更新最新依赖,清除构建并构建 ./gradlew clean --refresh-dependencies build
注意build命令把debug、release环境的包都打出来的
如果需要指定构建使用如下命令
指定构建目标命令
# 编译并打Debug包 ./gradlew assembleDebug ./gradlew aD # 编译并打Release的包 ./gradlew assembleRelease ./gradlew aR
构建并安装调试命令
# 编译并打Debug包 ./gradlew assembleDebug # 编译app module 并打Debug包 ./gradlew install app:assembleDebug # 编译并打Release的包 ./gradlew assembleRelease # Release模式打包并安装 ./gradlew installRelease # 卸载Release模式包 ./gradlew uninstallRelease
assemble还可以和productFlavors结合使用,如果出现类似Task'install'isambiguousinrootproject这种错误,请查看配置的多个渠道然后修改命令为
./gradlewinstall[productFlavorsName]app:assembleDebug
来用命令构建调试
查看包依赖
./gradlew dependencies --info
查看详细依赖信息
使用离线模式
./gradlew aDR --offline
守护进程
./gradle build --daemon
并行编译模式
./gradle build --parallel --parallel-threads=N
按需编译模式
./gradle build --configure-on-demand
不使用snapshot依赖仓库
前提是离线可以使用时
./gradlew clean aDR
多渠道打包
assemble还可以和productFlavors结合使用
# Release模式打包并安装 ./gradlew installRelease # 卸载Release模式包 ./gradlew uninstallRelease
仓库设置
设置中心仓库
默认是jcenter、可以是mavenCentral
repositories { maven { url "http://maven.oschina.net/content/groups/public" } }
AndroidStudio提速
禁用插件
去掉一些没有用的插件
GoogleCloudTesting、GoogleCloudToolsForAndroidStudio、GooleLogin、GoogleServices、JavaFX、SDKUpdater、TestNG-J
androidstudio2.2.2新特性编译缓存
工程根目录gradle.properties文件里加上
android.enableBuildCache=true
这个设置可以让AndroidStudio会把依赖的jar或arr缓存到本地,并且把模块名称设置为hash值
这个开启后,可能导致includeJarFilter配置失效,AndroidStudio升级到2.3.0修复这个问题
每次编译生成的缓存在$HOME/.android/build-cache
如果缓存过多可以手动删除该目录进行清除
升级到AndroidStudio2.3后编译不兼容问题
升级到AndroidStudio2.3后,GradlePlugin也升级到2.3.0
对应推荐使用的Gradle版本是3.3
这时候会发现工程模块目录下{modulename}/build/intermediates/exploded-aar/
目录没了
它会在$HOME/.android/build-cache下生成一部分缓存文件,来代替exploded-aar
如果需要生成exploded-aar,可以配置项目目录下的gradle.properties,添加一行内容
android.enableBuildCache=false
然后重新构建项目即可在{modulename}/build/intermediates/看到exploded-aar目录