David 'Digit' Turner | 23d2439 | 2010-12-06 12:05:11 +0100 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (C) 2008 The Android Open Source Project |
| 3 | * All rights reserved. |
| 4 | * |
| 5 | * Redistribution and use in source and binary forms, with or without |
| 6 | * modification, are permitted provided that the following conditions |
| 7 | * are met: |
| 8 | * * Redistributions of source code must retain the above copyright |
| 9 | * notice, this list of conditions and the following disclaimer. |
| 10 | * * Redistributions in binary form must reproduce the above copyright |
| 11 | * notice, this list of conditions and the following disclaimer in |
| 12 | * the documentation and/or other materials provided with the |
| 13 | * distribution. |
| 14 | * |
| 15 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| 16 | * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| 17 | * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS |
| 18 | * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE |
| 19 | * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, |
| 20 | * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |
| 21 | * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS |
| 22 | * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED |
| 23 | * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, |
| 24 | * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT |
| 25 | * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
| 26 | * SUCH DAMAGE. |
| 27 | */ |
Elliott Hughes | 4aa2e6a | 2014-05-07 12:37:44 -0700 | [diff] [blame] | 28 | |
Elliott Hughes | ce934e3 | 2018-09-06 13:26:08 -0700 | [diff] [blame] | 29 | #pragma once |
| 30 | |
| 31 | /** |
| 32 | * @file android/api-level.h |
| 33 | * @brief Functions and constants for dealing with multiple API levels. |
| 34 | */ |
David 'Digit' Turner | 23d2439 | 2010-12-06 12:05:11 +0100 | [diff] [blame] | 35 | |
Elliott Hughes | 203e13d | 2016-07-22 14:56:18 -0700 | [diff] [blame] | 36 | #include <sys/cdefs.h> |
| 37 | |
Elliott Hughes | c0f4656 | 2018-11-09 15:38:52 -0800 | [diff] [blame] | 38 | __BEGIN_DECLS |
| 39 | |
Dan Albert | 495ec92 | 2016-09-21 01:08:44 -0700 | [diff] [blame] | 40 | #ifndef __ANDROID_API_FUTURE__ |
Elliott Hughes | ce934e3 | 2018-09-06 13:26:08 -0700 | [diff] [blame] | 41 | /** |
| 42 | * Magic version number for an Android OS build which has |
| 43 | * not yet turned into an official release, |
| 44 | * for comparisons against __ANDROID_API__. |
| 45 | */ |
Dan Albert | 495ec92 | 2016-09-21 01:08:44 -0700 | [diff] [blame] | 46 | #define __ANDROID_API_FUTURE__ 10000 |
| 47 | #endif |
| 48 | |
Josh Gao | 99739d4 | 2016-04-13 17:16:47 -0700 | [diff] [blame] | 49 | #ifndef __ANDROID_API__ |
Elliott Hughes | ce934e3 | 2018-09-06 13:26:08 -0700 | [diff] [blame] | 50 | /** |
| 51 | * `__ANDROID_API__` is the API level being targeted. For the OS, |
| 52 | * this is `__ANDROID_API_FUTURE__`. For the NDK, this is set by the |
| 53 | * compiler/build system based on the API level you claimed to target. |
| 54 | */ |
Dan Albert | 495ec92 | 2016-09-21 01:08:44 -0700 | [diff] [blame] | 55 | #define __ANDROID_API__ __ANDROID_API_FUTURE__ |
Josh Gao | 99739d4 | 2016-04-13 17:16:47 -0700 | [diff] [blame] | 56 | #endif |
David 'Digit' Turner | 23d2439 | 2010-12-06 12:05:11 +0100 | [diff] [blame] | 57 | |
Elliott Hughes | ce934e3 | 2018-09-06 13:26:08 -0700 | [diff] [blame] | 58 | /** Names the Gingerbread API level (9), for comparisons against __ANDROID_API__. */ |
Elliott Hughes | 5bc78c8 | 2016-11-16 11:35:43 -0800 | [diff] [blame] | 59 | #define __ANDROID_API_G__ 9 |
Elliott Hughes | 5bc78c8 | 2016-11-16 11:35:43 -0800 | [diff] [blame] | 60 | |
Elliott Hughes | ce934e3 | 2018-09-06 13:26:08 -0700 | [diff] [blame] | 61 | /** Names the Ice-Cream Sandwich API level (14), for comparisons against __ANDROID_API__. */ |
| 62 | #define __ANDROID_API_I__ 14 |
| 63 | |
| 64 | /** Names the Jellybean API level (16), for comparisons against __ANDROID_API__. */ |
| 65 | #define __ANDROID_API_J__ 16 |
| 66 | |
| 67 | /** Names the Jellybean MR1 API level (17), for comparisons against __ANDROID_API__. */ |
| 68 | #define __ANDROID_API_J_MR1__ 17 |
| 69 | |
| 70 | /** Names the Jellybean MR2 API level (18), for comparisons against __ANDROID_API__. */ |
| 71 | #define __ANDROID_API_J_MR2__ 18 |
| 72 | |
| 73 | /** Names the KitKat API level (19), for comparisons against __ANDROID_API__. */ |
| 74 | #define __ANDROID_API_K__ 19 |
| 75 | |
| 76 | /** Names the Lollipop API level (21), for comparisons against __ANDROID_API__. */ |
| 77 | #define __ANDROID_API_L__ 21 |
| 78 | |
| 79 | /** Names the Lollipop MR1 API level (22), for comparisons against __ANDROID_API__. */ |
| 80 | #define __ANDROID_API_L_MR1__ 22 |
| 81 | |
| 82 | /** Names the Marshmallow API level (23), for comparisons against __ANDROID_API__. */ |
| 83 | #define __ANDROID_API_M__ 23 |
| 84 | |
| 85 | /** Names the Nougat API level (24), for comparisons against __ANDROID_API__. */ |
| 86 | #define __ANDROID_API_N__ 24 |
| 87 | |
| 88 | /** Names the Nougat MR1 API level (25), for comparisons against __ANDROID_API__. */ |
| 89 | #define __ANDROID_API_N_MR1__ 25 |
| 90 | |
| 91 | /** Names the Oreo API level (26), for comparisons against __ANDROID_API__. */ |
| 92 | #define __ANDROID_API_O__ 26 |
| 93 | |
| 94 | /** Names the Oreo MR1 API level (27), for comparisons against __ANDROID_API__. */ |
| 95 | #define __ANDROID_API_O_MR1__ 27 |
| 96 | |
| 97 | /** Names the Pie API level (28), for comparisons against __ANDROID_API__. */ |
| 98 | #define __ANDROID_API_P__ 28 |
| 99 | |
| 100 | /** Names the "Q" API level (29), for comparisons against __ANDROID_API__. */ |
| 101 | #define __ANDROID_API_Q__ 29 |
Elliott Hughes | c0f4656 | 2018-11-09 15:38:52 -0800 | [diff] [blame] | 102 | |
Elliott Hughes | 4206711 | 2019-04-18 14:27:24 -0700 | [diff] [blame^] | 103 | /** Names the "R" API level (30), for comparisons against __ANDROID_API__. */ |
| 104 | #define __ANDROID_API_R__ 30 |
| 105 | |
Elliott Hughes | c0f4656 | 2018-11-09 15:38:52 -0800 | [diff] [blame] | 106 | /** |
| 107 | * Returns the `targetSdkVersion` of the caller, or `__ANDROID_API_FUTURE__` |
| 108 | * if there is no known target SDK version (for code not running in the |
| 109 | * context of an app). |
| 110 | * |
| 111 | * The returned values correspond to the named constants in `<android/api-level.h>`, |
| 112 | * and is equivalent to the AndroidManifest.xml `targetSdkVersion`. |
| 113 | * |
| 114 | * See also android_get_device_api_level(). |
| 115 | * |
| 116 | * Available since API level 24. |
| 117 | */ |
| 118 | int android_get_application_target_sdk_version() __INTRODUCED_IN(24); |
| 119 | |
| 120 | #if __ANDROID_API__ < __ANDROID_API_Q__ |
| 121 | |
Elliott Hughes | 0f57d56 | 2018-11-15 15:07:13 -0800 | [diff] [blame] | 122 | // android_get_device_api_level is a static inline before API level 29. |
Elliott Hughes | c0f4656 | 2018-11-09 15:38:52 -0800 | [diff] [blame] | 123 | #define __BIONIC_GET_DEVICE_API_LEVEL_INLINE static __inline |
| 124 | #include <bits/get_device_api_level_inlines.h> |
| 125 | #undef __BIONIC_GET_DEVICE_API_LEVEL_INLINE |
| 126 | |
| 127 | #else |
| 128 | |
| 129 | /** |
| 130 | * Returns the API level of the device we're actually running on, or -1 on failure. |
| 131 | * The returned values correspond to the named constants in `<android/api-level.h>`, |
| 132 | * and is equivalent to the Java `Build.VERSION.SDK_INT` API. |
| 133 | * |
| 134 | * See also android_get_application_target_sdk_version(). |
| 135 | */ |
| 136 | int android_get_device_api_level() __INTRODUCED_IN(29); |
| 137 | |
| 138 | #endif |
| 139 | |
| 140 | __END_DECLS |