开发 Android 应用时,minSdk、targetSdk 和 compileSdk 最终都会落到 API Level。系统名称、甜点代号和 API Level 并不总是能直接互推;需要排查兼容性或选择 SDK 时,一张准确的对照表会方便许多。

本文以首次公开发布日为准,整理截至 2026-09-21 的 Android 平台版本。表中的 SDK 标识对应 Android 官方 Build.VERSION_CODES 常量;它与对外版本名称、历史资料中的内部代号并不是同一个概念。

对照表

Android 版本 版本名称 API Level SDK 标识 首次公开发布时间
Android 版本Android 1.0 版本名称Base API Level1 SDK 标识BASE 首次公开发布时间2008-09-23
Android 版本Android 1.1 版本名称Base 1.1 API Level2 SDK 标识BASE_1_1 首次公开发布时间2009-02-09
Android 版本Android 1.5 版本名称Cupcake API Level3 SDK 标识CUPCAKE 首次公开发布时间2009-04-27
Android 版本Android 1.6 版本名称Donut API Level4 SDK 标识DONUT 首次公开发布时间2009-09-15
Android 版本Android 2.0 版本名称Eclair API Level5 SDK 标识ECLAIR 首次公开发布时间2009-10-27
Android 版本Android 2.0.1 版本名称Eclair API Level6 SDK 标识ECLAIR_0_1 首次公开发布时间2009-12-03
Android 版本Android 2.1 版本名称Eclair API Level7 SDK 标识ECLAIR_MR1 首次公开发布时间2010-01-11
Android 版本Android 2.2 版本名称Froyo API Level8 SDK 标识FROYO 首次公开发布时间2010-05-20
Android 版本Android 2.3 版本名称Gingerbread API Level9 SDK 标识GINGERBREAD 首次公开发布时间2010-12-06
Android 版本Android 2.3.3 版本名称Gingerbread API Level10 SDK 标识GINGERBREAD_MR1 首次公开发布时间2011-02-09
Android 版本Android 3.0 版本名称Honeycomb API Level11 SDK 标识HONEYCOMB 首次公开发布时间2011-02-22
Android 版本Android 3.1 版本名称Honeycomb API Level12 SDK 标识HONEYCOMB_MR1 首次公开发布时间2011-05-10
Android 版本Android 3.2 版本名称Honeycomb API Level13 SDK 标识HONEYCOMB_MR2 首次公开发布时间2011-07-15
Android 版本Android 4.0 版本名称Ice Cream Sandwich API Level14 SDK 标识ICE_CREAM_SANDWICH 首次公开发布时间2011-10-18
Android 版本Android 4.0.3 版本名称Ice Cream Sandwich API Level15 SDK 标识ICE_CREAM_SANDWICH_MR1 首次公开发布时间2011-12-16
Android 版本Android 4.1 版本名称Jelly Bean API Level16 SDK 标识JELLY_BEAN 首次公开发布时间2012-07-09
Android 版本Android 4.2 版本名称Jelly Bean API Level17 SDK 标识JELLY_BEAN_MR1 首次公开发布时间2012-11-13
Android 版本Android 4.3 版本名称Jelly Bean API Level18 SDK 标识JELLY_BEAN_MR2 首次公开发布时间2013-07-24
Android 版本Android 4.4 版本名称KitKat API Level19 SDK 标识KITKAT 首次公开发布时间2013-10-31
Android 版本Android 4.4W 版本名称KitKat Wear API Level20 SDK 标识KITKAT_WATCH 首次公开发布时间2014-06-25
Android 版本Android 5.0 版本名称Lollipop API Level21 SDK 标识LOLLIPOP 首次公开发布时间2014-11-04
Android 版本Android 5.1 版本名称Lollipop API Level22 SDK 标识LOLLIPOP_MR1 首次公开发布时间2015-03-02
Android 版本Android 6.0 版本名称Marshmallow API Level23 SDK 标识M 首次公开发布时间2015-09-29
Android 版本Android 7.0 版本名称Nougat API Level24 SDK 标识N 首次公开发布时间2016-08-22
Android 版本Android 7.1.1 版本名称Nougat API Level25 SDK 标识N_MR1 首次公开发布时间2016-10-04
Android 版本Android 8.0 版本名称Oreo API Level26 SDK 标识O 首次公开发布时间2017-08-21
Android 版本Android 8.1 版本名称Oreo API Level27 SDK 标识O_MR1 首次公开发布时间2017-12-05
Android 版本Android 9 版本名称Pie API Level28 SDK 标识P 首次公开发布时间2018-08-06
Android 版本Android 10 版本名称Android 10 API Level29 SDK 标识Q 首次公开发布时间2019-09-03
Android 版本Android 11 版本名称Android 11 API Level30 SDK 标识R 首次公开发布时间2020-09-08
Android 版本Android 12 版本名称Android 12 API Level31 SDK 标识S 首次公开发布时间2021-10-04
Android 版本Android 12L(12.1) 版本名称Android 12L API Level32 SDK 标识S_V2 首次公开发布时间2022-03-07
Android 版本Android 13 版本名称Android 13 API Level33 SDK 标识TIRAMISU 首次公开发布时间2022-08-15
Android 版本Android 14 版本名称Android 14 API Level34 SDK 标识UPSIDE_DOWN_CAKE 首次公开发布时间2023-10-04
Android 版本Android 15 版本名称Android 15 API Level35 SDK 标识VANILLA_ICE_CREAM 首次公开发布时间2024-09-03
Android 版本Android 16 版本名称Android 16 API Level36 SDK 标识BAKLAVA 首次公开发布时间2025-06-10
Android 版本Android 16 QPR2 版本名称Android 16 QPR2 API Level36.1 SDK 标识BAKLAVA(minor API 1) 首次公开发布时间2025-12-02
Android 版本Android 17 版本名称Android 17 API Level37 SDK 标识CINNAMON_BUN 首次公开发布时间2026-06-16

几个容易混淆的地方

  • Base 是官方 SDK 标识。 Android 1.0 和 Android 1.1 分别对应 BASE、BASE_1_1;不要把这两个常量与版本对外名称或历史内部代号混为一谈。
  • 版本名称与 SDK 标识不一定相同。 例如 Android 8.0 的版本名称是 Oreo,对应的 SDK 标识是 O;Android 10 起,Google 对外改用数字命名,但 SDK 标识仍保留字母或甜点名称。
  • Android 16 有 36.1 这个小版本 API。 Android 16 QPR2 在 API 36 基础上新增了 minor API level 1。使用该 SDK 时,Android Gradle Plugin 的配置形式为 release(36) { minorApiLevel = 1 },不是一个新的整数 compileSdk 值。
  • Android 12L 仍属于 Android 12。 它在设备“关于手机”页面通常显示为 Android 12,发布镜像与 API 对应关系中常记为 12.1 / API 32。

在项目中如何使用

  • minSdk:应用能够安装和运行的最低 API Level。
  • targetSdk:应用声明已适配的 API Level,会影响系统对部分兼容性行为的处理。
  • compileSdk:编译时使用的 SDK API Level;通常应尽量跟进稳定的最新版本。

运行时兼容性判断应使用 Build.VERSION.SDK_INT 与 Build.VERSION_CODES,而不是解析 Android 版本字符串。API Level 是面向开发者的稳定契约,而厂商系统的版本显示可能包含额外定制。

参考资料