项目背景

由于过低的 android studio版本（包含：AGP和配套的Gradle） 会在版本不断迭代过程中逐步不被支持，因此相应的项目也需要不断的升级版本。但是，对于一些项目场景来说，客户的硬件设备只要不坏基本上没有任何升级的动力。因此涉及到 android 盒子 项目，则需要考虑客户主要使用版本覆盖率。（即项目最低兼容的miniSdkVersion需要能够覆盖市场的90%以上，越接近100%就越好）。但是也不能因为此原因，而拒绝新技术的引进。因此，这类项目通常会小步安全迭代升级，而不是具有高风险的大跨步式的升级。

比如现在2026年初，根据互联网上的 android 盒子版本分布数据，其中 android 4.4 依旧占据了 35% 的市场份额，因此盒子的 app 必须最低兼容到该版本。 这个就硬性的限制了技术栈的兼容性，从而导致某些技术参数不能够过高，否则极易产生兼容问题。

古老的android项目配置

  • AGP(Android Gradle Plugin) 版本: 3.6.2
  • Gradle 版本: 5.6.4
  • NDK abiFilters: armeabi

首次升级

  • AGP: 4.2.2
  • Gradle: 6.7.1
  • NDK abiFilters: armeabi-v7a,x86

升级准则

  • 完美支持Java8语法，且尚未开始支持Java9及以上版本
  • 统一 andorid studio 到 4.2.2
  • build.gradle 等构建脚本最小化改动且兼容
  • 构建应用apk等正常

使用最新的android studio

在上述升级的基础上，使用最新的 android studio (例如: 2025.2.3) 版本。 打开本项目时，android studio 会提示 AGP 版本过低，忽略或者选择本项目不再提示即可。 需要注意的是：

最新的 android studio 可能会默认使用更高版本的 java 来运行 gradle，因此你需要在 IDE 的 Settings 找到 Gradle的运行JDK（Gradle JDK），将高版本的Java运行环境修改为你本地的(Java8h或Java11，不要使用更高版本的Java)，直到使用 android studio 的gradle构建不报错即可。

使用 AI 插件

一旦你升级 android studio 到最新版(例如: 2025.2.3)，那么你就可以使用一些AI插件来助力你这个古老项目，提质增效。

免费的 AI 插件

  • Qoder (阿里出品)，推荐且有命令行工具
  • Trae (字节出品)，可使用Claude Code等国外AI