集成Jetpack Compose所需的最低Kotlin与Gradle版本要求
Jetpack Compose 接入最低版本要求
你当前使用的Kotlin 1.3、Gradle 3.5完全不满足Jetpack Compose的运行要求,不存在兼容该版本组合的Compose可用版本,硬门槛要求如下:
- Android Gradle Plugin(AGP)最低要求:
7.0.0,对应匹配的Gradle Wrapper最低版本为7.0.2,这一层没有向下兼容的绕过方案,必须升级 - Kotlin最低版本:和Compose版本严格一一绑定,首个正式稳定版Compose 1.0.0对应的Kotlin最低兼容版本为
1.5.21;早期的Compose开发预览版最低仅支持Kotlin 1.4,且预览版存在大量兼容性bug、API频繁变动,完全不适合长期维护的生产项目使用
不需要将所有依赖、构建配置直接升级到最新版本,可以锁定在满足Compose运行要求的最低版本线,大幅降低升级适配成本:
- 若选择接入Compose 1.0.x稳定版,直接锁死版本组合为Kotlin 1.5.21 + AGP 7.0.4 + Gradle 7.0.2即可,无需追更高版本
- 项目原有基于View体系的代码不需要全量修改,Compose支持和传统View代码混写共存,可逐步迭代替换
- Compose 1.0.x最低支持
minSdk 21,如果项目当前minSdk低于21,还需要先调整minSdk配置
适配注意事项
- Kotlin版本与Compose编译器版本强绑定,跨版本搭配会直接触发编译失败,不存在手动修改配置绕过版本校验的可行方案
- AGP版本与Gradle版本为严格对应关系,AGP 7.0.x无法在Gradle 7.0以下版本运行,不要尝试跳过Gradle升级直接接入
- 升级构建版本时,先在单独的feature分支验证老代码的兼容性,确认构建无异常后再合入主线,避免影响现有迭代流程
内容的提问来源于stack exchange,提问作者Mars
相关产品推荐
相关产品推荐

