The Android Open Source Project | 88b6079 | 2009-03-03 19:28:42 -0800 | [diff] [blame] | 1 | # |
| 2 | # Copyright (C) 2008 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 | # |
| 18 | # Handle various build version information. |
| 19 | # |
| 20 | # Guarantees that the following are defined: |
| 21 | # PLATFORM_VERSION |
| 22 | # PLATFORM_SDK_VERSION |
Dianne Hackborn | 9bd5404 | 2009-05-15 18:01:20 -0700 | [diff] [blame] | 23 | # PLATFORM_VERSION_CODENAME |
| 24 | # DEFAULT_APP_TARGET_SDK |
The Android Open Source Project | 88b6079 | 2009-03-03 19:28:42 -0800 | [diff] [blame] | 25 | # BUILD_ID |
| 26 | # BUILD_NUMBER |
Dan Willemsen | ccc933e | 2015-08-11 15:25:12 -0700 | [diff] [blame] | 27 | # BUILD_DATETIME |
Adam Seaton | 8d4fac7 | 2016-07-29 11:52:35 -0700 | [diff] [blame] | 28 | # PLATFORM_SECURITY_PATCH |
The Android Open Source Project | 88b6079 | 2009-03-03 19:28:42 -0800 | [diff] [blame] | 29 | # |
| 30 | |
| 31 | # Look for an optional file containing overrides of the defaults, |
| 32 | # but don't cry if we don't find it. We could just use -include, but |
| 33 | # the build.prop target also wants INTERNAL_BUILD_ID_MAKEFILE to be set |
| 34 | # if the file exists. |
| 35 | # |
| 36 | INTERNAL_BUILD_ID_MAKEFILE := $(wildcard $(BUILD_SYSTEM)/build_id.mk) |
Colin Cross | 63fe36a | 2017-02-21 17:23:02 -0800 | [diff] [blame] | 37 | ifdef INTERNAL_BUILD_ID_MAKEFILE |
The Android Open Source Project | 88b6079 | 2009-03-03 19:28:42 -0800 | [diff] [blame] | 38 | include $(INTERNAL_BUILD_ID_MAKEFILE) |
| 39 | endif |
| 40 | |
Colin Cross | e13a588 | 2017-10-02 17:54:01 -0700 | [diff] [blame^] | 41 | DEFAULT_PLATFORM_VERSION := PPR1 |
| 42 | MIN_PLATFORM_VERSION := PPR1 |
| 43 | MAX_PLATFORM_VERSION := PPR1 |
Colin Cross | 8873713 | 2017-03-21 17:41:03 -0700 | [diff] [blame] | 44 | |
Colin Cross | c901659 | 2017-03-28 13:07:56 -0700 | [diff] [blame] | 45 | ALLOWED_VERSIONS := $(call allowed-platform-versions,\ |
| 46 | $(MIN_PLATFORM_VERSION),\ |
| 47 | $(MAX_PLATFORM_VERSION),\ |
| 48 | $(DEFAULT_PLATFORM_VERSION)) |
Colin Cross | d8bc190 | 2017-03-21 12:45:29 -0700 | [diff] [blame] | 49 | |
Colin Cross | c901659 | 2017-03-28 13:07:56 -0700 | [diff] [blame] | 50 | ifndef TARGET_PLATFORM_VERSION |
Colin Cross | 8873713 | 2017-03-21 17:41:03 -0700 | [diff] [blame] | 51 | TARGET_PLATFORM_VERSION := $(DEFAULT_PLATFORM_VERSION) |
Colin Cross | d3183bd | 2017-02-16 16:41:26 -0800 | [diff] [blame] | 52 | endif |
| 53 | |
Colin Cross | c901659 | 2017-03-28 13:07:56 -0700 | [diff] [blame] | 54 | ifeq (,$(filter $(ALLOWED_VERSIONS), $(TARGET_PLATFORM_VERSION))) |
| 55 | $(warning Invalid TARGET_PLATFORM_VERSION '$(TARGET_PLATFORM_VERSION)', must be one of) |
| 56 | $(error $(ALLOWED_VERSIONS)) |
Colin Cross | d3183bd | 2017-02-16 16:41:26 -0800 | [diff] [blame] | 57 | endif |
| 58 | |
Colin Cross | ca0afa3 | 2017-02-17 16:28:16 -0800 | [diff] [blame] | 59 | # Default versions for each TARGET_PLATFORM_VERSION |
Colin Cross | c901659 | 2017-03-28 13:07:56 -0700 | [diff] [blame] | 60 | # TODO: PLATFORM_VERSION, PLATFORM_SDK_VERSION, etc. should be conditional |
| 61 | # on this |
Colin Cross | ca0afa3 | 2017-02-17 16:28:16 -0800 | [diff] [blame] | 62 | |
| 63 | # This is the canonical definition of the platform version, |
| 64 | # which is the version that we reveal to the end user. |
| 65 | # Update this value when the platform version changes (rather |
| 66 | # than overriding it somewhere else). Can be an arbitrary string. |
| 67 | |
| 68 | # When you add a new PLATFORM_VERSION which will result in a new |
| 69 | # PLATFORM_SDK_VERSION please ensure you add a corresponding isAtLeast* |
| 70 | # method in the following java file: |
| 71 | # frameworks/support/compat/gingerbread/android/support/v4/os/BuildCompat.java |
| 72 | |
| 73 | # When you change PLATFORM_VERSION for a given PLATFORM_SDK_VERSION |
Ian Pedowitz | f28bf72 | 2017-08-03 17:38:26 -0700 | [diff] [blame] | 74 | # please add that PLATFORM_VERSION as well as clean up obsolete PLATFORM_VERSION's |
| 75 | # in the following text file: |
Colin Cross | ca0afa3 | 2017-02-17 16:28:16 -0800 | [diff] [blame] | 76 | # cts/tests/tests/os/assets/platform_versions.txt |
Colin Cross | e13a588 | 2017-10-02 17:54:01 -0700 | [diff] [blame^] | 77 | PLATFORM_VERSION.PPR1 := P |
Colin Cross | ca0afa3 | 2017-02-17 16:28:16 -0800 | [diff] [blame] | 78 | |
Ian Pedowitz | 0a06d8b | 2017-04-18 23:25:01 +0000 | [diff] [blame] | 79 | # These are the current development codenames, if the build is not a final |
| 80 | # release build. If this is a final release build, it is simply "REL". |
Colin Cross | e13a588 | 2017-10-02 17:54:01 -0700 | [diff] [blame^] | 81 | PLATFORM_VERSION_CODENAME.PPR1 := P |
Colin Cross | ca0afa3 | 2017-02-17 16:28:16 -0800 | [diff] [blame] | 82 | |
Colin Cross | 63fe36a | 2017-02-21 17:23:02 -0800 | [diff] [blame] | 83 | ifndef PLATFORM_VERSION |
Colin Cross | ca0afa3 | 2017-02-17 16:28:16 -0800 | [diff] [blame] | 84 | PLATFORM_VERSION := $(PLATFORM_VERSION.$(TARGET_PLATFORM_VERSION)) |
| 85 | ifndef PLATFORM_VERSION |
| 86 | # PLATFORM_VERSION falls back to TARGET_PLATFORM_VERSION |
| 87 | PLATFORM_VERSION := $(TARGET_PLATFORM_VERSION) |
| 88 | endif |
The Android Open Source Project | 88b6079 | 2009-03-03 19:28:42 -0800 | [diff] [blame] | 89 | endif |
| 90 | |
Colin Cross | 63fe36a | 2017-02-21 17:23:02 -0800 | [diff] [blame] | 91 | ifndef PLATFORM_SDK_VERSION |
The Android Open Source Project | 88b6079 | 2009-03-03 19:28:42 -0800 | [diff] [blame] | 92 | # This is the canonical definition of the SDK version, which defines |
Dianne Hackborn | 9537884 | 2009-05-08 12:06:17 -0700 | [diff] [blame] | 93 | # the set of APIs and functionality available in the platform. It |
| 94 | # is a single integer that increases monotonically as updates to |
| 95 | # the SDK are released. It should only be incremented when the APIs for |
| 96 | # the new release are frozen (so that developers don't write apps against |
| 97 | # intermediate builds). During development, this number remains at the |
| 98 | # SDK version the branch is based on and PLATFORM_VERSION_CODENAME holds |
| 99 | # the code-name of the new development work. |
Ian Pedowitz | 9a3d92f | 2016-11-03 17:09:25 -0700 | [diff] [blame] | 100 | |
| 101 | # When you change PLATFORM_SDK_VERSION please ensure you also update the |
| 102 | # corresponding methods for isAtLeast* in the following java file: |
Ian Pedowitz | fc0189f | 2016-11-23 11:59:25 -0800 | [diff] [blame] | 103 | # frameworks/support/compat/gingerbread/android/support/v4/os/BuildCompat.java |
| 104 | |
| 105 | # When you increment the PLATFORM_SDK_VERSION please ensure you also |
| 106 | # clear out the following text file of all older PLATFORM_VERSION's: |
| 107 | # cts/tests/tests/os/assets/platform_versions.txt |
Michael Wright | 5d8410b | 2017-08-23 13:54:04 -0700 | [diff] [blame] | 108 | PLATFORM_SDK_VERSION := 27 |
The Android Open Source Project | 88b6079 | 2009-03-03 19:28:42 -0800 | [diff] [blame] | 109 | endif |
| 110 | |
Colin Cross | 63fe36a | 2017-02-21 17:23:02 -0800 | [diff] [blame] | 111 | ifndef PLATFORM_JACK_MIN_SDK_VERSION |
Yohann Roussel | 740ec8f | 2016-03-09 17:19:58 +0100 | [diff] [blame] | 112 | # This is definition of the min SDK version given to Jack for the current |
| 113 | # platform. For released version it should be the same as |
| 114 | # PLATFORM_SDK_VERSION. During development, this number may be incremented |
Ian Pedowitz | 9c350d7 | 2017-05-04 00:09:37 +0000 | [diff] [blame] | 115 | # before PLATFORM_SDK_VERSION if the platform starts to add new java |
Yohann Roussel | 740ec8f | 2016-03-09 17:19:58 +0100 | [diff] [blame] | 116 | # language supports. |
Yohann Roussel | a6c122b | 2016-11-18 19:30:28 +0100 | [diff] [blame] | 117 | PLATFORM_JACK_MIN_SDK_VERSION := o-b1 |
Yohann Roussel | 740ec8f | 2016-03-09 17:19:58 +0100 | [diff] [blame] | 118 | endif |
| 119 | |
Colin Cross | 63fe36a | 2017-02-21 17:23:02 -0800 | [diff] [blame] | 120 | ifndef PLATFORM_VERSION_CODENAME |
Colin Cross | ca0afa3 | 2017-02-17 16:28:16 -0800 | [diff] [blame] | 121 | PLATFORM_VERSION_CODENAME := $(PLATFORM_VERSION_CODENAME.$(TARGET_PLATFORM_VERSION)) |
| 122 | ifndef PLATFORM_VERSION_CODENAME |
| 123 | # PLATFORM_VERSION_CODENAME falls back to TARGET_PLATFORM_VERSION |
| 124 | PLATFORM_VERSION_CODENAME := $(TARGET_PLATFORM_VERSION) |
| 125 | endif |
Dianne Hackborn | 6ee3c43 | 2014-04-24 16:19:14 -0700 | [diff] [blame] | 126 | |
Dan Albert | cd38b86 | 2017-07-28 12:34:08 -0700 | [diff] [blame] | 127 | # This is all of the *active* development codenames. There are future |
| 128 | # codenames not included in this list. This confusing name is needed because |
| 129 | # all_codenames has been baked into build.prop for ages. |
| 130 | # |
| 131 | # Should be either the same as PLATFORM_VERSION_CODENAME or a comma-separated |
| 132 | # list of additional codenames after PLATFORM_VERSION_CODENAME. |
Dan Albert | 839db81 | 2017-03-28 12:41:18 -0700 | [diff] [blame] | 133 | PLATFORM_VERSION_ALL_CODENAMES := |
| 134 | |
Dan Albert | cd38b86 | 2017-07-28 12:34:08 -0700 | [diff] [blame] | 135 | # Build a list of all active code names. Avoid duplicates, and stop when we |
Dan Albert | 839db81 | 2017-03-28 12:41:18 -0700 | [diff] [blame] | 136 | # reach a codename that matches PLATFORM_VERSION_CODENAME (anything beyond |
Dan Albert | cd38b86 | 2017-07-28 12:34:08 -0700 | [diff] [blame] | 137 | # that is not included in our build). |
Dan Albert | 839db81 | 2017-03-28 12:41:18 -0700 | [diff] [blame] | 138 | _versions_in_target := \ |
| 139 | $(call find_and_earlier,$(ALL_VERSIONS),$(TARGET_PLATFORM_VERSION)) |
| 140 | $(foreach version,$(_versions_in_target),\ |
| 141 | $(eval _codename := $(PLATFORM_VERSION_CODENAME.$(version)))\ |
| 142 | $(if $(filter $(_codename),$(PLATFORM_VERSION_ALL_CODENAMES)),,\ |
| 143 | $(eval PLATFORM_VERSION_ALL_CODENAMES += $(_codename)))) |
| 144 | |
Dan Albert | cd38b86 | 2017-07-28 12:34:08 -0700 | [diff] [blame] | 145 | # This is all of the inactive development codenames. Available to be targeted |
| 146 | # in this branch but in the future relative to our current target. |
| 147 | PLATFORM_VERSION_FUTURE_CODENAMES := |
| 148 | |
| 149 | # Build a list of all untargeted code names. Avoid duplicates. |
| 150 | _versions_not_in_target := \ |
| 151 | $(filter-out $(PLATFORM_VERSION_ALL_CODENAMES),$(ALL_VERSIONS)) |
| 152 | $(foreach version,$(_versions_not_in_target),\ |
| 153 | $(eval _codename := $(PLATFORM_VERSION_CODENAME.$(version)))\ |
| 154 | $(if $(filter $(_codename),$(PLATFORM_VERSION_FUTURE_CODENAMES)),,\ |
| 155 | $(eval PLATFORM_VERSION_FUTURE_CODENAMES += $(_codename)))) |
| 156 | |
Dan Albert | 839db81 | 2017-03-28 12:41:18 -0700 | [diff] [blame] | 157 | # And convert from space separated to comma separated. |
| 158 | PLATFORM_VERSION_ALL_CODENAMES := \ |
| 159 | $(subst $(space),$(comma),$(strip $(PLATFORM_VERSION_ALL_CODENAMES))) |
Dan Albert | cd38b86 | 2017-07-28 12:34:08 -0700 | [diff] [blame] | 160 | PLATFORM_VERSION_FUTURE_CODENAMES := \ |
| 161 | $(subst $(space),$(comma),$(strip $(PLATFORM_VERSION_FUTURE_CODENAMES))) |
Dan Albert | 839db81 | 2017-03-28 12:41:18 -0700 | [diff] [blame] | 162 | |
Dianne Hackborn | 9537884 | 2009-05-08 12:06:17 -0700 | [diff] [blame] | 163 | endif |
| 164 | |
Colin Cross | 63fe36a | 2017-02-21 17:23:02 -0800 | [diff] [blame] | 165 | ifeq (REL,$(PLATFORM_VERSION_CODENAME)) |
Adam Powell | bdd5e8e | 2015-05-21 13:49:05 -0700 | [diff] [blame] | 166 | PLATFORM_PREVIEW_SDK_VERSION := 0 |
| 167 | else |
Colin Cross | 63fe36a | 2017-02-21 17:23:02 -0800 | [diff] [blame] | 168 | ifndef PLATFORM_PREVIEW_SDK_VERSION |
Adam Powell | bdd5e8e | 2015-05-21 13:49:05 -0700 | [diff] [blame] | 169 | # This is the definition of a preview SDK version over and above the current |
| 170 | # platform SDK version. Unlike the platform SDK version, a higher value |
| 171 | # for preview SDK version does NOT mean that all prior preview APIs are |
| 172 | # included. Packages reading this value to determine compatibility with |
| 173 | # known APIs should check that this value is precisely equal to the preview |
| 174 | # SDK version the package was built for, otherwise it should fall back to |
| 175 | # assuming the device can only support APIs as of the previous official |
| 176 | # public release. |
| 177 | # This value will always be 0 for release builds. |
Ian Pedowitz | 62a835d | 2017-08-23 18:23:31 -0700 | [diff] [blame] | 178 | PLATFORM_PREVIEW_SDK_VERSION := 0 |
Adam Powell | bdd5e8e | 2015-05-21 13:49:05 -0700 | [diff] [blame] | 179 | endif |
| 180 | endif |
| 181 | |
Colin Cross | 63fe36a | 2017-02-21 17:23:02 -0800 | [diff] [blame] | 182 | ifndef DEFAULT_APP_TARGET_SDK |
Dianne Hackborn | 9bd5404 | 2009-05-15 18:01:20 -0700 | [diff] [blame] | 183 | # This is the default minSdkVersion and targetSdkVersion to use for |
| 184 | # all .apks created by the build system. It can be overridden by explicitly |
| 185 | # setting these in the .apk's AndroidManifest.xml. It is either the code |
| 186 | # name of the development build or, if this is a release build, the official |
| 187 | # SDK version of this release. |
Colin Cross | 63fe36a | 2017-02-21 17:23:02 -0800 | [diff] [blame] | 188 | ifeq (REL,$(PLATFORM_VERSION_CODENAME)) |
Dianne Hackborn | 9bd5404 | 2009-05-15 18:01:20 -0700 | [diff] [blame] | 189 | DEFAULT_APP_TARGET_SDK := $(PLATFORM_SDK_VERSION) |
| 190 | else |
| 191 | DEFAULT_APP_TARGET_SDK := $(PLATFORM_VERSION_CODENAME) |
| 192 | endif |
| 193 | endif |
| 194 | |
Colin Cross | 63fe36a | 2017-02-21 17:23:02 -0800 | [diff] [blame] | 195 | ifndef PLATFORM_SECURITY_PATCH |
Adam Seaton | c63e429 | 2016-08-25 19:46:06 -0700 | [diff] [blame] | 196 | # Used to indicate the security patch that has been applied to the device. |
| 197 | # It must signify that the build includes all security patches issued up through the designated Android Public Security Bulletin. |
| 198 | # It must be of the form "YYYY-MM-DD" on production devices. |
| 199 | # It must match one of the Android Security Patch Level strings of the Public Security Bulletins. |
| 200 | # If there is no $PLATFORM_SECURITY_PATCH set, keep it empty. |
Adam Seaton | d24487a | 2017-09-13 10:51:18 -0700 | [diff] [blame] | 201 | PLATFORM_SECURITY_PATCH := 2017-11-05 |
Dianne Hackborn | e593e5c | 2015-08-12 16:11:20 -0700 | [diff] [blame] | 202 | endif |
| 203 | |
Colin Cross | 63fe36a | 2017-02-21 17:23:02 -0800 | [diff] [blame] | 204 | ifndef PLATFORM_BASE_OS |
Dianne Hackborn | e593e5c | 2015-08-12 16:11:20 -0700 | [diff] [blame] | 205 | # Used to indicate the base os applied to the device. |
| 206 | # Can be an arbitrary string, but must be a single word. |
| 207 | # |
| 208 | # If there is no $PLATFORM_BASE_OS set, keep it empty. |
| 209 | PLATFORM_BASE_OS := |
| 210 | endif |
| 211 | |
Colin Cross | 63fe36a | 2017-02-21 17:23:02 -0800 | [diff] [blame] | 212 | ifndef BUILD_ID |
The Android Open Source Project | 88b6079 | 2009-03-03 19:28:42 -0800 | [diff] [blame] | 213 | # Used to signify special builds. E.g., branches and/or releases, |
| 214 | # like "M5-RC7". Can be an arbitrary string, but must be a single |
| 215 | # word and a valid file name. |
| 216 | # |
| 217 | # If there is no BUILD_ID set, make it obvious. |
| 218 | BUILD_ID := UNKNOWN |
| 219 | endif |
| 220 | |
Colin Cross | 63fe36a | 2017-02-21 17:23:02 -0800 | [diff] [blame] | 221 | ifndef BUILD_DATETIME |
Dan Willemsen | ccc933e | 2015-08-11 15:25:12 -0700 | [diff] [blame] | 222 | # Used to reproduce builds by setting the same time. Must be the number |
| 223 | # of seconds since the Epoch. |
| 224 | BUILD_DATETIME := $(shell date +%s) |
| 225 | endif |
| 226 | |
Dan Willemsen | ce7f8dd | 2017-07-25 00:57:38 -0700 | [diff] [blame] | 227 | ifneq (,$(findstring Darwin,$(UNAME))) |
Dan Willemsen | ccc933e | 2015-08-11 15:25:12 -0700 | [diff] [blame] | 228 | DATE := date -r $(BUILD_DATETIME) |
| 229 | else |
| 230 | DATE := date -d @$(BUILD_DATETIME) |
| 231 | endif |
| 232 | |
Colin Cross | 63fe36a | 2017-02-21 17:23:02 -0800 | [diff] [blame] | 233 | ifndef BUILD_NUMBER |
The Android Open Source Project | 88b6079 | 2009-03-03 19:28:42 -0800 | [diff] [blame] | 234 | # BUILD_NUMBER should be set to the source control value that |
| 235 | # represents the current state of the source code. E.g., a |
| 236 | # perforce changelist number or a git hash. Can be an arbitrary string |
| 237 | # (to allow for source control that uses something other than numbers), |
| 238 | # but must be a single word and a valid file name. |
| 239 | # |
| 240 | # If no BUILD_NUMBER is set, create a useful "I am an engineering build |
| 241 | # from this date/time" value. Make it start with a non-digit so that |
| 242 | # anyone trying to parse it as an integer will probably get "0". |
weiqiao | c9219c2 | 2015-12-15 15:57:22 +0800 | [diff] [blame] | 243 | BUILD_NUMBER := eng.$(shell echo $${USER:0:6}).$(shell $(DATE) +%Y%m%d.%H%M%S) |
The Android Open Source Project | 88b6079 | 2009-03-03 19:28:42 -0800 | [diff] [blame] | 244 | endif |