aboutsummaryrefslogtreecommitdiff
path: root/java/com/android/modules/utils/build/SdkLevel.java
blob: 45c8c4a045f56a7bfbc55f51a88ccd5d9266a447 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
/*
 * Copyright (C) 2020 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.android.modules.utils.build;

import static android.os.Build.VERSION.CODENAME;
import static android.os.Build.VERSION.SDK_INT;
import static android.os.Build.VERSION_CODES.CUR_DEVELOPMENT;

import androidx.annotation.ChecksSdkIntAtLeast;
import androidx.annotation.NonNull;

/**
 * Utility class to check SDK level on a device.
 *
 * @hide
 */
public final class SdkLevel {

    private SdkLevel() {
    }

    /** Checks if the device is running on a release version of Android R or newer. */
    @ChecksSdkIntAtLeast(api = 30 /* Build.VERSION_CODES.R */)
    public static boolean isAtLeastR() {
        return SDK_INT >= 30;
    }

    /** Checks if the device is running on a release version of Android S or newer. */
    @ChecksSdkIntAtLeast(api = 31 /* Build.VERSION_CODES.S */)
    public static boolean isAtLeastS() {
        return SDK_INT >= 31;
    }

    /** Checks if the device is running on a release version of Android S_V2 or newer */
    @ChecksSdkIntAtLeast(api = 32 /* BUILD.VERSION_CODES.Sv2 */)
    public static boolean isAtLeastSv2() {
        return SDK_INT >= 32;
    }

    /** Checks if the device is running on a release version of Android Tiramisu or newer */
    @ChecksSdkIntAtLeast(api = 33 /* BUILD_VERSION_CODES.Tiramisu */)
    public static boolean isAtLeastT() {
        return SDK_INT >= 33;
    }

    /**
     * Checks if the device is running on a pre-release or release version of Android
     * UpsideDownCake or newer
     */
    @ChecksSdkIntAtLeast(codename = "UpsideDownCake")
    public static boolean isAtLeastU() {
        return isAtLeastPreReleaseCodename("UpsideDownCake");
    }

    private static boolean isAtLeastPreReleaseCodename(@NonNull String codename) {
        // Special case "REL", which means the build is not a pre-release build.
        if ("REL".equals(CODENAME)) {
            return false;
        }

        // Otherwise lexically compare them. Return true if the build codename is equal to or
        // greater than the requested codename.
        return CODENAME.compareTo(codename) >= 0;
    }
}