项目背景

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

比如现在2026年初，在 android 盒子的android版本数据依旧是 android 4.4及以上的版本，其中 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，将高版本的Java运行环境修改为你本地的Java8即可。

使用 AI 插件

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

免费的 AI 插件

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