Is there any way to get the API version that the phone is currently running?
12 Answers
As described in the Android documentation, the SDK level (integer) the phone is running is available in:
android.os.Build.VERSION.SDK_INT
The class corresponding to this int is in the android.os.Build.VERSION_CODES
class.
Code example:
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.LOLLIPOP){
// Do something for lollipop and above versions
} else{
// do something for phones running an SDK before lollipop
}
Edit: This SDK_INT is available since Donut (android 1.6 / API4) so make sure your application is not retro-compatible with Cupcake (android 1.5 / API3) when you use it or your application will crash (thanks to Programmer Bruce for the precision).
-
19If the code is running on 1.5, then referencing SDK_INT will throw an exception, since it was introduced with API 4. (Yes, you can run an APK compiled with API 4 code on 1.5. And yes, when that API 4 code is reached, it does throw an exception.) May 14, 2011 at 6:31
-
@ProgrammerBruce how to prevent the crash? Or how to not be retro-compatible?– CœurDec 28, 2018 at 2:24
-
2@Cœur I think building an app retro compatible to Android 1.5 is not really useful nowadays. Just set your project
minSdkVersion
to4
(Android 1.6) and go on.– ol_v_erJan 8, 2019 at 10:09 -
Why not use the String android.os.Build.VERSION.SDK instead? It works for all Android versions– PYKOct 30, 2019 at 1:13
-
@PYK This attribute android.os.Build.VERSION.SDK is deprecated, so it should not be used. developer.android.com/reference/android/os/…– ol_v_erNov 12, 2019 at 16:06
Very easy:
String manufacturer = Build.MANUFACTURER;
String model = Build.MODEL;
int version = Build.VERSION.SDK_INT;
String versionRelease = Build.VERSION.RELEASE;
Log.e("MyActivity", "manufacturer " + manufacturer
+ " \n model " + model
+ " \n version " + version
+ " \n versionRelease " + versionRelease
);
Output:
E/MyActivity: manufacturer ManufacturerX
model SM-T310
version 19
versionRelease 4.4.2
-
3Build.VERSION.RELEASE is what I was looking for. Thanks @CommonSenseCode– reixaMar 20, 2019 at 10:20
-
Build.VERSION.RELEASE;
That will give you the actual numbers of your version; aka 2.3.3 or 2.2. The problem with using Build.VERSION.SDK_INT is if you have a rooted phone or custom rom, you could have a non standard OS (aka my android is running 2.3.5) and that will return a null when using Build.VERSION.SDK_INT so Build.VERSION.RELEASE will work no matter using standard Android version or not !
To use it, you could just do this;
String androidOS = Build.VERSION.RELEASE;
-
9According to docs
int android.os.Build.VERSION.SDK_INT
andpublic static final int SDK_INT
andAdded in API level 4
how could int (not Integer) returnNULL
?NULL
is a state for an object so its Build or VERSION could benull
theoretically but in such case not onlySDK_INT
butRELEASE
as well will cause a NPE. SDK_INT could probably cause "No such method exception" or something like that but not null or NPE. If only custom ROM breaks the docs and the method declared aspublic static final Integer SDK_INT
. I'm just trying to determine an issue's nature to make a workaround.– StanSep 5, 2013 at 8:14 -
3Can anyone verify if this is in fact the case? Stan's comment makes it pretty clear that null is not possible. And custom Android ROM's / OS's surely have to originate from some build of version? So surely Build.VERSION.SDK_INT should reflect this?– btalbOct 15, 2014 at 9:20
-
3I've downvoted this since the claim isn't really backed up and the warning about
null
doesn't make sense.– SamDec 25, 2014 at 22:21 -
Rooted phone or Custom roms should never touch this number. They usually change the Build.VERSION.RELEASE though. Aug 5, 2016 at 2:16
-
There is a lot of known issues when it comes to Custom OS/Roms. The version I had on my older Android at the time (I want to say GS3) had that issue. There has been a lot of issues with hardcoded values or values there weren't just correct. Hard example, Wi-Fi Mac Addresses being hard coded. Oct 14, 2016 at 12:27
try this:
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.GINGERBREAD) {
// only for gingerbread and newer versions
}
Taking into account all said, here is the code I use for detecting if device has Froyo or newer Android OS (2.2+):
public static boolean froyoOrNewer() {
// SDK_INT is introduced in 1.6 (API Level 4) so code referencing that would fail
// Also we can't use SDK_INT since some modified ROMs play around with this value, RELEASE is most versatile variable
if (android.os.Build.VERSION.RELEASE.startsWith("1.") ||
android.os.Build.VERSION.RELEASE.startsWith("2.0") ||
android.os.Build.VERSION.RELEASE.startsWith("2.1"))
return false;
return true;
}
Obviously, you can modify that if condition to take into account 1.0 & 1.5 versions of Android in case you need generic checker. You will probably end up with something like this:
// returns true if current Android OS on device is >= verCode
public static boolean androidMinimum(int verCode) {
if (android.os.Build.VERSION.RELEASE.startsWith("1.0"))
return verCode == 1;
else if (android.os.Build.VERSION.RELEASE.startsWith("1.1")) {
return verCode <= 2;
} else if (android.os.Build.VERSION.RELEASE.startsWith("1.5")) {
return verCode <= 3;
} else {
return android.os.Build.VERSION.SDK_INT >= verCode;
}
}
Let me know if code is not working for you.
android.os.Build.VERSION.SDK should give you the value of the API Level. You can easily find the mapping from api level to android version in the android documentation. I believe, 8 is for 2.2, 7 for 2.1, and so on.
SDK.INT is supported for Android 1.6 and up
SDK is supported for all versions
So I do:
String sdk_version_number = android.os.Build.VERSION.SDK;
Credits to: CommonsWare over this answer
-
-
@limonik You're right, SDK exists since API level 1 but it was deprecated in API level 15– PYKOct 6, 2020 at 1:38
Got it. Its using the getApplicationInfo()
method of the Context
class.
-
3This will get you the minSdkVersion and targetSdkVersion of the APK, which describes which API versions the app supports. This is not the API version of the phone the app is currently running on. Nov 2, 2016 at 22:45
I generally prefer to add these codes in a function to get the Android version:
int whichAndroidVersion;
whichAndroidVersion= Build.VERSION.SDK_INT;
textView.setText("" + whichAndroidVersion); //If you don't use "" then app crashes.
For example, that code above will set the text into my textView as "29" now.
i prefer have the version as number to be handeled more easyway than i wrote this:
public static float getAPIVerison() {
Float f = null;
try {
StringBuilder strBuild = new StringBuilder();
strBuild.append(android.os.Build.VERSION.RELEASE.substring(0, 2));
f = new Float(strBuild.toString());
} catch (NumberFormatException e) {
Log.e("", "error retriving api version" + e.getMessage());
}
return f.floatValue();
}
I improved code i used
public static float getAPIVerison() {
float f=1f;
try {
StringBuilder strBuild = new StringBuilder();
strBuild.append(android.os.Build.VERSION.RELEASE.substring(0, 2));
f= Float.valueOf(strBuild.toString());
} catch (NumberFormatException e) {
Log.e("myApp", "error retriving api version" + e.getMessage());
}
return f;
}
Like this:
String versionRelease = BuildConfig.VERSION_NAME;
versionRelease :- 2.1.17
Please make sure your import package is correct ( import package your_application_package_name
, otherwise it will not work properly).