WPS二次开发专题:Gradle版本、AGP插件与Java版本的对应关系

作者持续关注WPS二次开发专题系列,持续为大家带来更多有价值的WPS开发技术细节,如果能够帮助到您,请帮忙来个一键三连,更多问题请联系我(QQ:250325397)

背景

最近有体验SDK的同学反馈接入SDK出现报错,最终定位到原因为接入的宿主app项目的gradle版本过低导致,SDK兼容支持了android11的特性,需要对应的gradle插件为支持android11的版本。

现象

解决方案

将gradle版本升级至支持android11的插件版本即可,对此google官方的引文如下

4. 0.1(2020 年 7 月)

本次要更新支持与 Android 11 中软件包可见性的新默认设置和功能兼容。

在以前的 Android 版本中,可以查看设备上安装的所有应用的列表。从 Android 11(API 级别 30)开始,默认情况下,应用只能访问经过过滤的已安装软件包列表。如需查看系统上更广泛的应用列表,您现在需要在应用或库的 Android 清单中添加 <queries> 元素。

Android Gradle 插件 4.1 及更高版本已与新的 <queries> 声明兼容;不过,较低的版本不兼容。如果您添加 <queries> 元素或者开始依赖于支持以 Android 11 为目标平台的库或 SDK,在构建应用时可能会遇到清单合并错误。

为了解决此问题,我们将针对 AGP 3.3 及更高版本发布一组补丁程序。如果您使用的是旧版 AGP,请升级到以下某个版本:

|-----------------------------|------------------|
| 如果您使用的是以下AGP 版本 | 请升级到 |
| 4.0.* | 4.0.1 |
| 3.6.* | 3.6.4 |
| 3.5.* | 3.5.4 |
| 3.4.* | 3.4.3 |
| 3.3.* | 3.3.3 |

关于WPS 二次开发SDK可以查看前面的系列文章介绍哦!

申请方式如下:

通过向WPS官方发送邮件申请,审批通过后即可获取集成相关资料,详细参见

邮件模板:
发起人:有需要申请接入WPS移动端的企业或者个人
邮件主题: XXX公司XXX项目---WPS Android端 SDK二次开发集成申请
邮件发送: m_open_sdk@wps.cn
邮件内容:
请明确包含申请项目背景规模、集成应用第三方APP包名, 具体需求 、集成周期等

更多需求可以通过 WPS 二次开发群(QQ:250325397)进行咨询

更多知识扩展

gradle是什么

  • Gradle是一个基于Apache Ant和Apache Maven概念的项目自动化构建开源工具。它使用一种基Groovy的特定领域语言(DSL)来声明项目设置,抛弃了基于XML的各种繁琐配置

  • 配置文件位置:项目根目录->gradle 文件夹->wrapper->gradle-wrapper.properties

    #Mon May 08 14:27:02 CST 2023
    distributionBase=GRADLE_USER_HOME
    distributionUrl=https://services.gradle.org/distributions/gradle-7.3.3-bin.zip
    distributionPath=wrapper/dists
    zipStorePath=wrapper/dists
    zipStoreBase=GRADLE_USER_HOME

AGP(AndroidStudio Gradle Plugin)插件是什么

  • AndroidStudio用于开发Android项目的gradle插件,它一边调用 Gradle本身的代码和批处理工具来构建项目,一边调用Android SDK的编译、打包功能。由于需要调用andriod,sdk的编译打包功能,所以该插件需要关连 Android SDK Build Tools Version
  • 为何需要?由于gralde不指是为android提供构建的也为其它c++等提供构建。所以需要针对安卓的插件。
  • Gradle插件会有版本号,一般和androidStudio的版本一致。每个版本号又对应有一个或一些 Gradle发行版本
  • 配置位置:File->Project Structrue

Android SDK Build Tools Version是什么

  • Build Tools Version为AGP提供的版本构建工具,一般由AS自动生成

  • 位置:module-> build.gradle

    android {
    buildToolsVersion "29.0.2"
    ...
    }

Gradle及插件版本支持映射

|------------------|-----------------------------|-----------------------|
| 插件版本 | 所需的最低 Gradle 版本 | 支持的java版本 |
| 8.4(Alpha 版) | 8.6-rc-1 | |
| 8.3 | 8.4 | <= 21 |
| 8.2 | 8.2 | <= 20 |
| 8.1 | 8.0 | |
| 8.0 | 8.0 | |
| 7.4 | 7.5 | <= 18 |
| 7.3 | 7.4 | |
| 7.2 | 7.3.3 | <= 17 |
| 7.1 | 7.2 | |
| 7.0 | 7.0 | <= 16 |
| 4.2.0+ | 6.7.1 | <= 15 |
| 4.1.0+ | 6.5+ | <= 14 |
| 4.0.0+ | 6.1.1+ | <= 13 |
| 3.6.0 - 3.6.4 | 5.6.4+ | |
| 3.5.0 - 3.5.4 | 5.4.1+ | <= 12 |
| 3.4.0 - 3.4.3 | 5.1.1+ | <= 11 |
| 3.3.0 - 3.3.3 | 4.10.1+ | |
| 3.2.0 - 3.2.1 | 4.6+ | <= 10 |
| 3.1.0+ | 4.4+ | |
| 3.0.0+ | 4.1+ | <= 9 |
| 2.3.0+ | 3.3+ | |
| 2.1.3 - 2.2.3 | 2.14.1 - 3.5 | |
| 2.0.0 - 2.1.2 | 2.10 - 2.13 | <= 8 |
| 1.5.0 | 2.2.1 - 2.13 | |
| 1.2.0 - 1.3.1 | 2.2.1 - 2.9 | |
| 1.0.0 - 1.1.3 | 2.2.1 - 2.3 | |

参考地址:

Android Gradle插件

Android Gradle 插件历史版本介绍

Gradle版本发布

相关推荐
千里马学框架2 天前
一起学 Android 14:ShellTransition 屏幕旋转过程深度剖析
android·智能手机·性能优化·framework·性能·屏幕旋转·rotation
美狐美颜SDK开放平台2 天前
开发直播APP时如何接入视频美颜SDK?开发流程与注意事项
android·人工智能·计算机视觉·音视频·直播美颜sdk
AFinalStone2 天前
Android7 SystemUI源码解析(七)Keyguard锁屏模块深度解析
android·systemui
致远ccc2 天前
Google Play 上架前如何测试 App?多国家 Android 环境测试
android·app测试·googleplay·多国家应用测试
ttyyttemo2 天前
Kotlin 协程中的 Job 结构化并发与取消
android
sun0077002 天前
tbox 4g/5g切换,导致wan ip 改变,导致车机旧网络不可用。需要重启车机才行
android
其实防守也摸鱼2 天前
内网穿透与反向代理:原理、工具与实战指南
android·大数据·运维·安全·网络安全·自动化·渗透
AFinalStone2 天前
Android7 SystemUI 源码解析(四)NavigationBar 导航栏与 SystemBars
android·systemui
JMchen2 天前
属性动画原理与高级动画实现
android·kotlin·canvas
AFinalStone2 天前
Android7 SystemUI 源码解析(二)启动流程深度解析
android·systemui