Get Android API level of phone currently running my application [duplicate]

Asked 22/10, 2010 at 4:38 Answered 22/10, 2010 at 9:11

229

Possible Duplicate:
Programmatically obtain the Android API level of a device?

How do I get the Api level of the phone curently running my application? I am sure its simple but I can not find it as all my searches bring up tons of junk.

Bushman answered 22/10, 2010 at 4:38 Comment(1)

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {...} – Gurney 29/12, 2018 at 3:3

441

Check android.os.Build.VERSION, which is a static class that holds various pieces of information about the Android OS a system is running.

If you care about all versions possible (back to original Android version), as in minSdkVersion is set to anything less than 4, then you will have to use android.os.Build.VERSION.SDK, which is a String that can be converted to the integer of the release.

If you are on at least API version 4 (Android 1.6 Donut), the current suggested way of getting the API level would be to check the value of android.os.Build.VERSION.SDK_INT, which is an integer.

In either case, the integer you get maps to an enum value from all those defined in android.os.Build.VERSION_CODES:

SDK_INT value        Build.VERSION_CODES        Human Version Name       
    1                  BASE                      Android 1.0 (no codename)
    2                  BASE_1_1                  Android 1.1 Petit Four
    3                  CUPCAKE                   Android 1.5 Cupcake
    4                  DONUT                     Android 1.6 Donut
    5                  ECLAIR                    Android 2.0 Eclair
    6                  ECLAIR_0_1                Android 2.0.1 Eclair                  
    7                  ECLAIR_MR1                Android 2.1 Eclair
    8                  FROYO                     Android 2.2 Froyo
    9                  GINGERBREAD               Android 2.3 Gingerbread
   10                  GINGERBREAD_MR1           Android 2.3.3 Gingerbread
   11                  HONEYCOMB                 Android 3.0 Honeycomb
   12                  HONEYCOMB_MR1             Android 3.1 Honeycomb
   13                  HONEYCOMB_MR2             Android 3.2 Honeycomb
   14                  ICE_CREAM_SANDWICH        Android 4.0 Ice Cream Sandwich
   15                  ICE_CREAM_SANDWICH_MR1    Android 4.0.3 Ice Cream Sandwich
   16                  JELLY_BEAN                Android 4.1 Jellybean
   17                  JELLY_BEAN_MR1            Android 4.2 Jellybean
   18                  JELLY_BEAN_MR2            Android 4.3 Jellybean
   19                  KITKAT                    Android 4.4 KitKat
   20                  KITKAT_WATCH              Android 4.4 KitKat Watch
   21                  LOLLIPOP                  Android 5.0 Lollipop
   22                  LOLLIPOP_MR1              Android 5.1 Lollipop
   23                  M                         Android 6.0 Marshmallow
   24                  N                         Android 7.0 Nougat
   25                  N_MR1                     Android 7.1.1 Nougat
   26                  O                         Android 8.0 Oreo
   27                  O_MR1                     Android 8 Oreo MR1
   28                  P                         Android 9 Pie
   29                  Q                         Android 10
  10000                CUR_DEVELOPMENT           Current Development Version

Note that some time between Android N and O, the Android SDK began aliasing CUR_DEVELOPMENT and the developer preview of the next major Android version to be the same SDK_INT value (10000).

Sherronsherry answered 22/10, 2010 at 4:40 Comment(6)

android.os.Build.VERSION.SDK is deprecated in lollipop which means "You can still use this, but don't count on it, because we will probably replace it with something else (or remove it entirely) in future software releases." – Tombouctou 16/4, 2015 at 14:7

@Duraiamuthan.H - I already mention that if you're using API version 4 or newer, you should switch to using android.os.Build.VERSION.SDK_INT. – Sherronsherry 16/4, 2015 at 15:23

Isn't the update 5.1.1 missing? – Vandervelde 4/11, 2015 at 19:12

@Vandervelde Android 5.1.1 doesn't have its own API level, it is just a patch version atop version 22 (Lollipop MR1). – Sherronsherry 4/11, 2015 at 19:23

Oh okay. But how could I possibly distinguish between 5.1 and 5.1.1? Because unfortunately they "patched" functionallity away. – Vandervelde 4/11, 2015 at 19:46

@Vandervelde If you need the specific release, then you use android.os.Build.VERSION.Release which specifies the exact release you're dealing with. – Sherronsherry 4/11, 2015 at 20:24

143

Integer.valueOf(android.os.Build.VERSION.SDK);

Values are:

Platform Version   API Level
Android 9.0        28
Android 8.1        27
Android 8.0        26
Android 7.1        25
Android 7.0        24
Android 6.0        23
Android 5.1        22
Android 5.0        21
Android 4.4W       20
Android 4.4        19
Android 4.3        18
Android 4.2        17
Android 4.1        16
Android 4.0.3      15
Android 4.0        14
Android 3.2        13
Android 3.1        12
Android 3.0        11
Android 2.3.3      10
Android 2.3        9
Android 2.2        8
Android 2.1        7
Android 2.0.1      6
Android 2.0        5
Android 1.6        4
Android 1.5        3
Android 1.1        2
Android 1.0        1

CAUTION: don't use android.os.Build.VERSION.SDK_INT if <uses-sdk android:minSdkVersion="3" />.

You will get exception on all devices with Android 1.5 and lower because Build.VERSION.SDK_INT is since SDK 4 (Donut 1.6).

Actinia answered 22/10, 2010 at 9:11 Comment(5)

There is another trick, you can use it anyway and use reflection to see if SDK_INT exists. If it does not then version is <= 3 and, at least for my purposes, that was good enough. – Ploughboy 27/10, 2011 at 7:57

Works perfectly. Meanwhile there are a "few" new ones: developer.android.com/reference/android/os/… – Kiyohara 2/10, 2012 at 13:18

@Duraiamuthan.H you are totally right. I don't know anybody who still support devices with API 3 so android.os.Build.VERSION.SDK_INT the best option to check version IMO. – Actinia 22/4, 2015 at 7:16

@Actinia - You are correct.I thought so. – Tombouctou 22/4, 2015 at 8:15

android.os.Build.VERSION.SDK_INT

Here you can find the possible values: VERSION_CODES.

Highline answered 22/10, 2010 at 4:41 Comment(2)

This solution is not so good because this constant is since API Level 4. – Lambda 5/10, 2011 at 0:32

@Lambda Android no longer maintains data on devices below API level 15 because it's such a small percentage of devices. Unless you're explicitly targeting very old devices, this solution is fine. – Crashaw 25/1, 2021 at 14:51

-14

try this :Float.valueOf(android.os.Build.VERSION.RELEASE) <= 2.1

Tormentor answered 22/10, 2010 at 5:23 Comment(1)

This value is not defined to be a float, for example "2.1-update1" – Linskey 13/10, 2012 at 12:39

Recommended topics

Hot tags