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 |
Dianne Hackborn | e593e5c | 2015-08-12 16:11:20 -0700 | [diff] [blame] | 28 | # 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) |
| 37 | ifneq "" "$(INTERNAL_BUILD_ID_MAKEFILE)" |
| 38 | include $(INTERNAL_BUILD_ID_MAKEFILE) |
| 39 | endif |
| 40 | |
| 41 | ifeq "" "$(PLATFORM_VERSION)" |
| 42 | # This is the canonical definition of the platform version, |
| 43 | # which is the version that we reveal to the end user. |
| 44 | # Update this value when the platform version changes (rather |
| 45 | # than overriding it somewhere else). Can be an arbitrary string. |
Ian Pedowitz | 1406578 | 2015-11-10 07:28:53 -0800 | [diff] [blame] | 46 | PLATFORM_VERSION := N |
The Android Open Source Project | 88b6079 | 2009-03-03 19:28:42 -0800 | [diff] [blame] | 47 | endif |
| 48 | |
| 49 | ifeq "" "$(PLATFORM_SDK_VERSION)" |
| 50 | # This is the canonical definition of the SDK version, which defines |
Dianne Hackborn | 9537884 | 2009-05-08 12:06:17 -0700 | [diff] [blame] | 51 | # the set of APIs and functionality available in the platform. It |
| 52 | # is a single integer that increases monotonically as updates to |
| 53 | # the SDK are released. It should only be incremented when the APIs for |
| 54 | # the new release are frozen (so that developers don't write apps against |
| 55 | # intermediate builds). During development, this number remains at the |
| 56 | # SDK version the branch is based on and PLATFORM_VERSION_CODENAME holds |
| 57 | # the code-name of the new development work. |
Dianne Hackborn | a425516 | 2015-06-26 15:54:10 -0700 | [diff] [blame] | 58 | PLATFORM_SDK_VERSION := 23 |
The Android Open Source Project | 88b6079 | 2009-03-03 19:28:42 -0800 | [diff] [blame] | 59 | endif |
| 60 | |
Dianne Hackborn | 9537884 | 2009-05-08 12:06:17 -0700 | [diff] [blame] | 61 | ifeq "" "$(PLATFORM_VERSION_CODENAME)" |
| 62 | # This is the current development code-name, if the build is not a final |
| 63 | # release build. If this is a final release build, it is simply "REL". |
Ian Pedowitz | 1406578 | 2015-11-10 07:28:53 -0800 | [diff] [blame] | 64 | PLATFORM_VERSION_CODENAME := N |
Dianne Hackborn | 6ee3c43 | 2014-04-24 16:19:14 -0700 | [diff] [blame] | 65 | |
| 66 | # This is all of the development codenames that are active. Should be either |
| 67 | # the same as PLATFORM_VERSION_CODENAME or a comma-separated list of additional |
| 68 | # codenames after PLATFORM_VERSION_CODENAME. |
Ian Pedowitz | 1406578 | 2015-11-10 07:28:53 -0800 | [diff] [blame] | 69 | PLATFORM_VERSION_ALL_CODENAMES := $(PLATFORM_VERSION_CODENAME) |
Dianne Hackborn | 9537884 | 2009-05-08 12:06:17 -0700 | [diff] [blame] | 70 | endif |
| 71 | |
Adam Powell | bdd5e8e | 2015-05-21 13:49:05 -0700 | [diff] [blame] | 72 | ifeq "REL" "$(PLATFORM_VERSION_CODENAME)" |
| 73 | PLATFORM_PREVIEW_SDK_VERSION := 0 |
| 74 | else |
| 75 | ifeq "" "$(PLATFORM_PREVIEW_SDK_VERSION)" |
| 76 | # This is the definition of a preview SDK version over and above the current |
| 77 | # platform SDK version. Unlike the platform SDK version, a higher value |
| 78 | # for preview SDK version does NOT mean that all prior preview APIs are |
| 79 | # included. Packages reading this value to determine compatibility with |
| 80 | # known APIs should check that this value is precisely equal to the preview |
| 81 | # SDK version the package was built for, otherwise it should fall back to |
| 82 | # assuming the device can only support APIs as of the previous official |
| 83 | # public release. |
| 84 | # This value will always be 0 for release builds. |
Ian Pedowitz | e5df613 | 2016-03-11 22:13:36 -0800 | [diff] [blame] | 85 | PLATFORM_PREVIEW_SDK_VERSION := 2 |
Adam Powell | bdd5e8e | 2015-05-21 13:49:05 -0700 | [diff] [blame] | 86 | endif |
| 87 | endif |
| 88 | |
Dianne Hackborn | 9bd5404 | 2009-05-15 18:01:20 -0700 | [diff] [blame] | 89 | ifeq "" "$(DEFAULT_APP_TARGET_SDK)" |
| 90 | # This is the default minSdkVersion and targetSdkVersion to use for |
| 91 | # all .apks created by the build system. It can be overridden by explicitly |
| 92 | # setting these in the .apk's AndroidManifest.xml. It is either the code |
| 93 | # name of the development build or, if this is a release build, the official |
| 94 | # SDK version of this release. |
| 95 | ifeq "REL" "$(PLATFORM_VERSION_CODENAME)" |
| 96 | DEFAULT_APP_TARGET_SDK := $(PLATFORM_SDK_VERSION) |
| 97 | else |
| 98 | DEFAULT_APP_TARGET_SDK := $(PLATFORM_VERSION_CODENAME) |
| 99 | endif |
| 100 | endif |
| 101 | |
Dianne Hackborn | e593e5c | 2015-08-12 16:11:20 -0700 | [diff] [blame] | 102 | ifeq "" "$(PLATFORM_SECURITY_PATCH)" |
| 103 | # Used to indicate the security patch that has been applied to the device. |
| 104 | # Can be an arbitrary string, but must be a single word. |
| 105 | # |
| 106 | # If there is no $PLATFORM_SECURITY_PATCH set, keep it empty. |
Zach Jang | e182d2a | 2016-02-19 13:50:29 -0800 | [diff] [blame] | 107 | PLATFORM_SECURITY_PATCH := 2016-04-01 |
Dianne Hackborn | e593e5c | 2015-08-12 16:11:20 -0700 | [diff] [blame] | 108 | endif |
| 109 | |
| 110 | ifeq "" "$(PLATFORM_BASE_OS)" |
| 111 | # Used to indicate the base os applied to the device. |
| 112 | # Can be an arbitrary string, but must be a single word. |
| 113 | # |
| 114 | # If there is no $PLATFORM_BASE_OS set, keep it empty. |
| 115 | PLATFORM_BASE_OS := |
| 116 | endif |
| 117 | |
The Android Open Source Project | 88b6079 | 2009-03-03 19:28:42 -0800 | [diff] [blame] | 118 | ifeq "" "$(BUILD_ID)" |
| 119 | # Used to signify special builds. E.g., branches and/or releases, |
| 120 | # like "M5-RC7". Can be an arbitrary string, but must be a single |
| 121 | # word and a valid file name. |
| 122 | # |
| 123 | # If there is no BUILD_ID set, make it obvious. |
| 124 | BUILD_ID := UNKNOWN |
| 125 | endif |
| 126 | |
Dan Willemsen | ccc933e | 2015-08-11 15:25:12 -0700 | [diff] [blame] | 127 | ifeq "" "$(BUILD_DATETIME)" |
| 128 | # Used to reproduce builds by setting the same time. Must be the number |
| 129 | # of seconds since the Epoch. |
| 130 | BUILD_DATETIME := $(shell date +%s) |
| 131 | endif |
| 132 | |
| 133 | ifneq (,$(findstring Darwin,$(shell uname -sm))) |
| 134 | DATE := date -r $(BUILD_DATETIME) |
| 135 | else |
| 136 | DATE := date -d @$(BUILD_DATETIME) |
| 137 | endif |
| 138 | |
The Android Open Source Project | 88b6079 | 2009-03-03 19:28:42 -0800 | [diff] [blame] | 139 | ifeq "" "$(BUILD_NUMBER)" |
| 140 | # BUILD_NUMBER should be set to the source control value that |
| 141 | # represents the current state of the source code. E.g., a |
| 142 | # perforce changelist number or a git hash. Can be an arbitrary string |
| 143 | # (to allow for source control that uses something other than numbers), |
| 144 | # but must be a single word and a valid file name. |
| 145 | # |
| 146 | # If no BUILD_NUMBER is set, create a useful "I am an engineering build |
| 147 | # from this date/time" value. Make it start with a non-digit so that |
| 148 | # anyone trying to parse it as an integer will probably get "0". |
weiqiao | c9219c2 | 2015-12-15 15:57:22 +0800 | [diff] [blame] | 149 | 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] | 150 | endif |