1 /* 2 * Copyright (C) 2017 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package com.android.compatibility.common.util; 18 19 import android.os.Build; 20 import android.os.SystemProperties; 21 22 import java.lang.reflect.Field; 23 24 /** 25 * Device-side compatibility utility class for reading device API level. 26 */ 27 public class ApiLevelUtil { 28 // os.Build.VERSION.DEVICE_INITIAL_SDK_INT can be used here, but it was called 29 // os.Build.VERSION.FIRST_SDK_INT in Android R and below. Using DEVICE_INITIAL_SDK_INT 30 // will mean that the tests built in Android S and above can't be run on Android R and below. 31 private static final int FIRST_API_LEVEL = 32 SystemProperties.getInt("ro.product.first_api_level", 0); 33 isBefore(int version)34 public static boolean isBefore(int version) { 35 return Build.VERSION.SDK_INT < version; 36 } 37 isBefore(String version)38 public static boolean isBefore(String version) { 39 return Build.VERSION.SDK_INT < resolveVersionString(version); 40 } 41 isAfter(int version)42 public static boolean isAfter(int version) { 43 return Build.VERSION.SDK_INT > version; 44 } 45 isAfter(String version)46 public static boolean isAfter(String version) { 47 return Build.VERSION.SDK_INT > resolveVersionString(version); 48 } 49 isAtLeast(int version)50 public static boolean isAtLeast(int version) { 51 return Build.VERSION.SDK_INT >= version; 52 } 53 isAtLeast(String version)54 public static boolean isAtLeast(String version) { 55 return Build.VERSION.SDK_INT >= resolveVersionString(version); 56 } 57 isAtMost(int version)58 public static boolean isAtMost(int version) { 59 return Build.VERSION.SDK_INT <= version; 60 } 61 isAtMost(String version)62 public static boolean isAtMost(String version) { 63 return Build.VERSION.SDK_INT <= resolveVersionString(version); 64 } 65 getApiLevel()66 public static int getApiLevel() { 67 return Build.VERSION.SDK_INT; 68 } 69 isFirstApiBefore(int version)70 public static boolean isFirstApiBefore(int version) { 71 return FIRST_API_LEVEL < version; 72 } 73 isFirstApiBefore(String version)74 public static boolean isFirstApiBefore(String version) { 75 return FIRST_API_LEVEL < resolveVersionString(version); 76 } 77 isFirstApiAfter(int version)78 public static boolean isFirstApiAfter(int version) { 79 return FIRST_API_LEVEL > version; 80 } 81 isFirstApiAfter(String version)82 public static boolean isFirstApiAfter(String version) { 83 return FIRST_API_LEVEL > resolveVersionString(version); 84 } 85 isFirstApiAtLeast(int version)86 public static boolean isFirstApiAtLeast(int version) { 87 return FIRST_API_LEVEL >= version; 88 } 89 isFirstApiAtLeast(String version)90 public static boolean isFirstApiAtLeast(String version) { 91 return FIRST_API_LEVEL >= resolveVersionString(version); 92 } 93 isFirstApiAtMost(int version)94 public static boolean isFirstApiAtMost(int version) { 95 return FIRST_API_LEVEL <= version; 96 } 97 isFirstApiAtMost(String version)98 public static boolean isFirstApiAtMost(String version) { 99 return FIRST_API_LEVEL <= resolveVersionString(version); 100 } 101 getFirstApiLevel()102 public static int getFirstApiLevel() { 103 return FIRST_API_LEVEL; 104 } 105 codenameEquals(String name)106 public static boolean codenameEquals(String name) { 107 return Build.VERSION.CODENAME.equalsIgnoreCase(name.trim()); 108 } 109 codenameStartsWith(String prefix)110 public static boolean codenameStartsWith(String prefix) { 111 return Build.VERSION.CODENAME.startsWith(prefix); 112 } 113 getCodename()114 public static String getCodename() { 115 return Build.VERSION.CODENAME; 116 } 117 resolveVersionString(String versionString)118 protected static int resolveVersionString(String versionString) { 119 // Attempt 1: Parse version string as an integer, e.g. "23" for M 120 try { 121 return Integer.parseInt(versionString); 122 } catch (NumberFormatException e) { /* ignore for alternate approaches below */ } 123 // Attempt 2: Find matching field in VersionCodes utility class, return value 124 try { 125 Field versionField = VersionCodes.class.getField(versionString.toUpperCase()); 126 return versionField.getInt(null); // no instance for VERSION_CODES, use null 127 } catch (IllegalAccessException | NoSuchFieldException e) { /* ignore */ } 128 // Attempt 3: Find field within android.os.Build.VERSION_CODES 129 try { 130 Field versionField = Build.VERSION_CODES.class.getField(versionString.toUpperCase()); 131 return versionField.getInt(null); // no instance for VERSION_CODES, use null 132 } catch (IllegalAccessException | NoSuchFieldException e) { 133 throw new RuntimeException( 134 String.format("Failed to parse version string %s", versionString), e); 135 } 136 } 137 } 138