Gradle、 Gradle Android Plugin 、 Build Tools之间关系

最新推荐文章于 2024-06-29 14:35:38 发布
最新推荐文章于 2024-06-29 14:35:38 发布
阅读量119 收藏
点赞数
CC 4.0 BY-SA版权
文章标签： java 移动开发
原文链接：https://yq.aliyun.com/articles/496437
本文提供了一套完整的Gradle配置方案，确保项目可以顺利编译。涵盖了Gradle版本、插件版本、构建工具版本及SDK版本等关键配置，并附有官方文档链接。

gradle一堆坑，原理自己找别的文章吧，看着这个配置就不会有坑了。

先看Gradle，再看 Android Plugin，参考以下图，一定能编译通过。

https://developer.android.com/studio/releases/gradle-plugin.html

首先、让Gradle先同步一下

点击Tools > Android > Sync Project with Gradle Files 

然后、修改对应配置文件

1、GradleVersion：gradle-wrapper.properties文件中 

  "distributionUrl=https\://services.gradle.org/distributions/gradle-3.3-all.zip"

2、Plugin Version： 项目下的build.gradle 中

  "classpath 'com.android.tools.build:gradle:2.3.0'"

3、Build Tools：模块build.gradle 中 

    " buildToolsVersion '25.0.2'"

4、sdk版本号

  模块build.gradle 中 

    "compileSdkVersion 23"

修改参考内容如下：

截了几个图，大家可以参考一下，具体还是看官网吧，英文不是很难。



android 创建 plugin
yuanbing1988的博客
05-09 1126
Android studio 创建 Android plugin 小记 1:首先创建一个Android项目 2:创建了一个module，我这边创建的是library，取名叫做plugins，删除了里面所有的内容，只剩下build.gradle，还是就是gitignore和imi文件， 3:新建了src/main下面的文件，最后新建了一个Myplugin文件，刚开始时候Androidstu...
Android Gradle 自定义Plugin实现_android plugin
2501_90228903的博客
01-16 1154
而 Gradle 改良了过去 Maven、Ant 带给开发者的问题，至今也成为 Android Studio 内置的封装布署工具。
com.android.tools.build:gradle:3.2.0
10-17
.gradle\caches\modules-2\files-2.1\com.android.tools.build\gradle缓存文件，包含pom，jar，source
android_gradle_build,android-gradle-build-tool
weixin_35651191的博客
05-27 232
Android Gradle Build Tool说明一个工具脚本，帮助 Android 打包，支持 application 项目与 library 项目。功能列表：根据项目版本文件，自动更改和升级版本。更改打包后产物的名称。收集 Android 打包产物(apk、 aar、proguard 文件等)。渠道打包(美团式)。以上所有的功能，默认的，只在执行 assemble 任务时才会执行。同时，本...
Gradle Build Tools
The Road Less Traveled
07-15 321
Ubuntu18 Gradle Build Tools Gradle Install & config install $ mkdir -p /app/gradle $ unzip -d /app/gradle gradle-4.8.1-bin.zip $ ls /app/gradle/gradle-4.8.1 LICENSE NOTICE bin getti...
Android Studio、Gradle、Build Tools版本详细版本对照表
08-05
内容包括：1.Android StudioRelease所有正式版本；2.Build Tools（会自动下载到Android SDK目录的build tools文件夹里面） 所有版本号；3.Android Studio版本、Gradle版本、Build Tools版本详细对照，让大家不再因为版本问题而纠结，你只需要知道哪个Android Studio版本用对应Gradle以及Build Tools就可以了。
android-maven-gradle-plugin:弃。 现在由android build插件支持
04-01
随着`android-maven-gradle-plugin`的弃用，开发者应迁移到`android.build.plugins`，这不仅可以确保与最新的Android Studio和Android SDK保持兼容，还能充分利用Google提供的各种优化和新特性。对于那些需要与Maven...
从Android Gradle项目生成Java文档的Gradle插件。-Android开发
05-26
设置app / build.gradle或library / build.gra gradle-android-javadoc-plugin Gradle插件，该插件可从Android Gradle项目生成Java文档。 设置app / build.gradle或library / build.gradle构建脚本{存储库{maven...
Android Gradle学习（二）- build.gradle结构
2301_78976656的博客
06-29 1173
看下编译生成的BuildConfig.java，可以通过匹配渠道做不同的操作，比如初始化不一样的推送（小米或华为），显示收费或者免费等等。另外，也可以手动配置资源路径，例如在项目根目录创建common/main，sourceSets可以配置此目录。还可以根据不同渠道引入不同依赖sdk。有一种场景，maven依赖和aar依赖同时包含了同一个库，编译时就会冲突，处理方式有两种。，这样在打包的时候就可以自动选择不同环境url，不需要手动去修改代码或配置切换。渠道和buildType可以分别配置不同的资源，例如。
[AS/Android Studio] Gradle Plugin Version 和 Gradle Version 的版本对应关系
米歪-miwisay
02-03 7849
Android Gradle插件与Gradle版本对应关系及常见问题解决 摘要：本文详细列出了Android Gradle插件版本与所需Gradle版本的对应关系表，帮助开发者正确匹配版本。对于更新时出现的版本冲突问题，文章提供了具体解决方案：通过修改build.gradle文件中的插件版本或gradle-wrapper.properties中的分发URL来指定正确版本。特别说明了7.0及8.0等主要版本的变更要点，包括JDK 11要求、构建缓存优化等新特性。同时强调应避免使用动态依赖项(如'2.+')，推
fgp小型开发项目.zip
02-13
github自由软件项目
fg793p.exe尹鸿软件，固态硬盘的win10系统如何上网？
01-12
fg793p.exe尹鸿软件，固态硬盘的win10系统如何上网？fg793p.exe尹鸿软件，固态硬盘的win10系统如何上网？
网络连接+jump+fg797p+知识获取
10-08
亲测可用
FG防火墙IMG文件
10-26
网上花很多积分下载回来的，分享给大家看看，有需的请下载。
中华软件开发编写教程电子数据连接中心程序软件开发文档制作
06-03
中华软件开发编写教程电子数据连接中心程序软件开发文档制作 fg781p fg782p fg781p.exe fg782p.exe
如何避免gradle插件下载：Gradle、Android Plugin、Build Tools
weixin_34205076的博客
03-31 264
问题描述 日常编译新项目时，类我型的萌新或是无Android经验的同事多次会遇到： 本地开发环境已经搭建好，项目拉下来就是运行不了，自动拉闸，大写懵逼！ 还会很无辜地来一句"我啥也没动"。 比如如下的错误(感谢汪哥赞助此图)： 剧情经过 (对剧情不感兴趣的可直接跳至小结) 把/app目录下build.gradle文件的buildTool版本改为的"buildToolsVersion "25.0...
fgadmin.exe
ProcessInfo的专栏
12-03 1957
  进程知识库 fgadmin - fgadmin.exe - 进程信息进程文件： fgadmin 或者 fgadmin.exe进程名称： Netgear Print Server  描述：fgadmin.exe是Netgear网络打印机配置和诊断程序。 出品者： Netgear属于：
fg
dq788的专栏
06-22 2564
sgdfgd
github使用教程
colar_lady的博客
10-24 1015
1.什么叫git?什么叫github?l两者之间的差别？      1.1.根据自己百度和之前使用svn,vss的经验的描述：              git：和vss,svn一样都是一个分布式的版本控制系统，通过链接和相应的权限认证之后，将自己本地的代码push到远程的仓库中，或者将远程的项目版本download到本地。在多人协作开发项目中起到至关重要的作用。             g
SDK Build Tools version 30.0.2 < 34.0.0. Note: Android Gradle Plugin can update SDK Build Tools automaticaly to a higher version than specified in build.gradle file.是什么问题
最新发布
06-17
<think>首先，用户的问题是关于AndroidGradlePlugin自动更新SDKBuildTools到比build.gradle中指定版本更高的原因和解决方案。用户指定了版本30.0.2。我需要参考提供的引用：-引用[1]：提到新Gradle插件定义了最低SDKBuildTools版本，例如在AndroidGradlePlugin3.0.1上，最低版本是26.0.2。-引用[2]：解释AndroidSDKBuild-Tools是必需的组件，如果使用AndroidPluginforGradle3.0.0或更高版本，项目会自动使用插件指定的默认版本。如果需要其他版本，可以在build.gradle中使用buildToolsVersion指定。-引用[3]：建议保持BuildTools更新，使用AndroidSDK管理器下载最新版本。同样，插件3.0.0+会自动使用默认版本，可以用buildToolsVersion指定。-引用[4]：介绍build.gradle文件的作用，包括控制编译版本和配置。-引用[5]：提到Cordova编译错误，可能与BuildTools版本不兼容有关。用户的问题核心是：为什么插件会自动更新到更高版本，即使build.gradle中指定了特定版本（如30.0.2），以及如何解决相关问题。从引用中提取关键点：-在AndroidGradlePlugin3.0.0及以上版本中，项目会自动使用插件指定的默认BuildTools版本。-如果用户指定buildToolsVersion，它应该覆盖默认值，但用户报告说插件更新到更高版本。-这可能是因为插件强制使用其兼容的版本，或者用户配置有误。原因分析：-根据引用[2]和[3]，插件有默认的BuildTools版本。如果用户没有指定buildToolsVersion，它会使用默认值；如果指定了，它应该使用指定的值。但用户指定了30.0.2，却更新到更高版本。-可能的原因：插件可能有最低版本要求。引用[1]提到插件定义了最低版本（如26.0.2），所以如果用户指定较低版本，插件可能忽略并提升到最低要求版本。-用户指定的是30.0.2，这是一个较新版本；插件可能默认使用更高版本，如31.x或32.x，因为插件更新后要求更高版本。-解决方案：在build.gradle中明确指定buildToolsVersion，并确保版本与插件兼容。引用[2]和[3]建议使用buildToolsVersion指定所需版本。-另一个解决方案：更新插件或SDK工具，确保兼容性。引用[3]说应保持BuildTools更新。-引用[5]提到编译错误，如找不到BuildTools，可能由于版本不匹配。结构化回答：1.**原因解释**：AndroidGradlePlugin(AGP)从3.0.0版本开始，引入了自动管理BuildTools版本的功能。AGP会根据自身版本指定一个默认的BuildTools版本。如果用户在build.gradle中没有指定buildToolsVersion，AGP会使用其默认版本；如果指定了，AGP会尝试使用指定版本。但有时AGP可能强制使用更高版本，原因包括：-AGP有最低BuildTools版本要求，以确保兼容性和安全性。-如果用户指定的版本低于AGP要求的最低版本，AGP会自动提升到最低版本或更高。-在用户案例中，指定了30.0.2，但AGP可能默认使用更新版本（如31.0.0或更高），因为AGP版本较新，要求更高BuildTools。2.**解决方案**：-明确指定buildToolsVersion：在模块的build.gradle文件中，添加或确认buildToolsVersion行，例如：```groovyandroid{buildToolsVersion"30.0.2"//其他配置}```确保版本号正确且与AGP兼容。-检查AGP版本：确认项目使用的AGP版本。在项目级的build.gradle中，检查dependencies中的classpath行。例如：```groovydependencies{classpath'com.android.tools.build:gradle:7.4.2'//示例版本}```不同AGP版本兼容不同BuildTools版本。参考官方文档确保兼容性。-更新SDKTools：使用AndroidSDKManager安装所需的BuildTools版本。如果AGP要求更高版本，考虑更新到兼容版本。-强制使用指定版本：如果AGP自动更新，尝试在gradle.properties中添加配置来禁用自动更新，但这可能不推荐，因为可能导致兼容性问题。-处理错误：如果遇到编译错误（如引用[5]中的错误），确保指定版本已安装。使用SDKManager安装所需版本。参考引用自然添加：-根据引用[2]，AGP3.0.0+会自动使用默认BuildTools版本[^2]。-引用[3]建议保持BuildTools更新[^3]。回答结构：-先解释原因。-然后提供解决方案步骤。-使用清晰、中文回答。-最后生成相关问题。系统指令要求生成相关问题，所以我需要在回答末尾添加相关问题。格式要求：-行内数学表达式用$...$，但这里可能不涉及数学，所以跳过。-独立公式用$$...$$，但这里没有公式。-LaTeX语法正确，但无数学。-中文回答。-引用标识自然添加。最终回答结构：1.原因部分。2.解决方案部分，可能包括代码块。3.相关问题。</think>### Android Gradle Plugin 自动更新 SDK Build Tools 的原因及解决方案 用户的问题聚焦于为什么 Android Gradle Plugin (AGP) 会自动将 SDK Build Tools 更新到高于 `build.gradle` 文件中指定版本（如 30.0.2）的原因，以及如何解决由此产生的兼容性问题。下面我将基于 Android 构建系统的机制和相关引用，逐步解释原因并提供实用解决方案。回答确保真实可靠，参考了官方文档和常见开发实践。 #### 原因分析 Android Gradle Plugin (AGP) 从 3.0.0 版本开始，引入了自动管理 SDK Build Tools 的功能，以简化构建配置并确保兼容性。以下是自动更新到更高版本的主要原因： 1. **AGP 的默认版本要求**： AGP 会根据自身版本内置一个“默认”或“最低兼容”的 Build Tools 版本。如果用户未在 `build.gradle` 中指定 `buildToolsVersion`，AGP 会自动使用其默认版本（如 AGP 7.0+ 默认使用 Build Tools 30.0.2 或更高）。即使您指定了版本（如 30.0.2），如果 AGP 的默认版本要求更高（例如，AGP 7.4.2 可能要求 Build Tools 31.x 或 32.x），插件可能会忽略您的指定并强制升级到兼容版本。这是因为 AGP 优先考虑构建稳定性和安全更新[^2][^3]。 2. **最低版本强制机制**： AGP 定义了 Build Tools 的最低版本要求，以避免兼容性问题。例如，AGP 3.0.1 要求 Build Tools 至少为 26.0.2[^1]。如果您指定的版本（如 30.0.2）低于 AGP 要求的“实际最低版本”（例如，AGP 8.0 可能要求 Build Tools 33.0.0+），AGP 会自动提升到更高版本。这类似于引用[3]中提到的“您应始终让 Build Tools 组件保持最新状态”的原则，以确保工具链一致[^3]。 3. **构建环境的影响**： 如果您的 Android SDK 中安装了更高版本的 Build Tools（例如，通过 Android SDK Manager 自动更新），AGP 可能优先使用最新可用版本，而不是 `build.gradle` 中的指定值。这可能导致版本冲突，尤其是在多模块项目或使用 Cordova 等第三方工具时（如引用[5]中的编译错误）[^5]。 总之，自动更新的核心是 AGP 的“智能管理”机制：它旨在减少开发者手动维护负担，但有时会导致版本不匹配，引发编译错误（如 `Could not resolve com.android.tools.build:gradle` 或 `No usable Android build tools found`）[^5]。 #### 解决方案 要解决 AGP 自动更新 Build Tools 的问题，核心是“显式指定版本”并“确保环境兼容”。以下是逐步解决方案，基于最佳实践： 1. **在 `build.gradle` 中强制指定 Build Tools 版本**： 在模块级的 `build.gradle` 文件中，明确添加或修改 `buildToolsVersion` 属性，并确保其值精确匹配所需版本（如 30.0.2）。同时，检查 `compileSdkVersion` 是否兼容（一般应与 Build Tools 版本一致）。示例代码： ```groovy android { compileSdkVersion 30 // 确保与 Build Tools 版本兼容 buildToolsVersion "30.0.2" // 显式指定版本，防止自动更新 // 其他配置... } ``` 这覆盖了 AGP 的默认行为，强制使用指定版本[^2][^4]。保存文件后，执行 `./gradlew clean` 清除缓存，然后重新构建。 2. **检查并匹配 AGP 版本**： AGP 版本与 Build Tools 版本必须兼容。在项目级的 `build.gradle` 文件中，确认 AGP 版本： ```groovy dependencies { classpath 'com.android.tools.build:gradle:7.4.2' // 示例 AGP 版本 } ``` - 如果 AGP 版本较新（如 7.x+），其默认 Build Tools 版本可能高于 30.0.2。参考 [官方兼容性表](https://developer.android.com/studio/releases/gradle-plugin#compatibility) 确保 `buildToolsVersion` 在支持范围内（例如，AGP 7.4.2 兼容 Build Tools 30.0.2 到 33.x）。 - 如果必须使用特定 Build Tools 30.0.2，考虑降级 AGP 到兼容版本（如 AGP 4.2.2），但需权衡新功能损失。 3. **管理 Android SDK 工具**： - **安装指定版本**：使用 Android SDK Manager（在 Android Studio 中通过 Tools > SDK Manager）安装所需 Build Tools 30.0.2。确保它存在于 SDK 路径中（如 `$ANDROID_HOME/build-tools/30.0.2`）。 - **禁用自动更新**：在 `gradle.properties` 文件中添加以下行，防止 AGP 自动下载新版本： ``` android.builder.sdkDownload=false ``` 但这可能影响长期维护，建议仅在必要时使用[^3]。 4. **处理常见错误**： 如果遇到编译错误（如引用[5]中的 `No usable Android build tools found`）： - 运行 `./gradlew --stop` 停止守护进程，然后 `./gradlew clean assembleDebug --stacktrace` 检查详细错误。 - 确保所有模块的 `build.gradle` 使用一致版本，避免冲突。 - 对于 Cordova 项目，更新 `config.xml` 或插件以匹配 Android 配置[^5]。 **最佳实践建议**： - 定期更新 AGP 和 Build Tools 以获取安全修复，但通过 `buildToolsVersion` 锁定版本用于生产环境[^3][^4]。 - 测试构建时，使用 Android Studio 的 “File > Sync Project with Gradle Files” 同步配置。 如果问题持续，提供 `gradlew build` 的错误日志，我可以进一步分析。 #### 相关问题 基于此主题，以下是您可能感兴趣的相关问题： 1. 如何检查 Android Gradle Plugin 和 Build Tools 的兼容性矩阵？ 2. 在构建失败时，如何诊断和解决 SDK Build Tools 版本冲突？ 3. Android Gradle Plugin 的自动更新机制有哪些优缺点？ [^1]: 新版本的 Gradle 插件定义了最低的 SDK Build Tools 版本，例如在 Android Gradle Plugin 3.0.1 上，Build Tools 的最低版本是 26.0.2。 [^2]: Android Plugin for Gradle 3.0.0 或更高版本会自动使用插件指定的默认 Build Tools 版本，如需自定义，需在 build.gradle 中使用 buildToolsVersion 指定。 [^3]: 应始终保持 Build Tools 更新，但可通过 buildToolsVersion 显式指定版本以确保兼容性。 [^4]: build.gradle 文件用于控制项目的构建设置，包括 Build Tools 版本。 [^5]: 版本不匹配可能导致编译错误，如 "No usable Android build tools found"，需确保指定版本已安装并兼容。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值