Home | History | Annotate | Download | only in core
      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
     23 #     PLATFORM_VERSION_CODENAME
     24 #     DEFAULT_APP_TARGET_SDK
     25 #     BUILD_ID
     26 #     BUILD_NUMBER
     27 #
     28 
     29 # Look for an optional file containing overrides of the defaults,
     30 # but don't cry if we don't find it.  We could just use -include, but
     31 # the build.prop target also wants INTERNAL_BUILD_ID_MAKEFILE to be set
     32 # if the file exists.
     33 #
     34 INTERNAL_BUILD_ID_MAKEFILE := $(wildcard $(BUILD_SYSTEM)/build_id.mk)
     35 ifneq "" "$(INTERNAL_BUILD_ID_MAKEFILE)"
     36   include $(INTERNAL_BUILD_ID_MAKEFILE)
     37 endif
     38 
     39 ifeq "" "$(PLATFORM_VERSION)"
     40   # This is the canonical definition of the platform version,
     41   # which is the version that we reveal to the end user.
     42   # Update this value when the platform version changes (rather
     43   # than overriding it somewhere else).  Can be an arbitrary string.
     44   PLATFORM_VERSION := 4.4.4
     45 endif
     46 
     47 ifeq "" "$(PLATFORM_SDK_VERSION)"
     48   # This is the canonical definition of the SDK version, which defines
     49   # the set of APIs and functionality available in the platform.  It
     50   # is a single integer that increases monotonically as updates to
     51   # the SDK are released.  It should only be incremented when the APIs for
     52   # the new release are frozen (so that developers don't write apps against
     53   # intermediate builds).  During development, this number remains at the
     54   # SDK version the branch is based on and PLATFORM_VERSION_CODENAME holds
     55   # the code-name of the new development work.
     56   PLATFORM_SDK_VERSION := 19
     57 endif
     58 
     59 ifeq "" "$(PLATFORM_VERSION_CODENAME)"
     60   # This is the current development code-name, if the build is not a final
     61   # release build.  If this is a final release build, it is simply "REL".
     62   PLATFORM_VERSION_CODENAME := REL
     63 endif
     64 
     65 ifeq "" "$(DEFAULT_APP_TARGET_SDK)"
     66   # This is the default minSdkVersion and targetSdkVersion to use for
     67   # all .apks created by the build system.  It can be overridden by explicitly
     68   # setting these in the .apk's AndroidManifest.xml.  It is either the code
     69   # name of the development build or, if this is a release build, the official
     70   # SDK version of this release.
     71   ifeq "REL" "$(PLATFORM_VERSION_CODENAME)"
     72     DEFAULT_APP_TARGET_SDK := $(PLATFORM_SDK_VERSION)
     73   else
     74     DEFAULT_APP_TARGET_SDK := $(PLATFORM_VERSION_CODENAME)
     75   endif
     76 endif
     77 
     78 ifeq "" "$(BUILD_ID)"
     79   # Used to signify special builds.  E.g., branches and/or releases,
     80   # like "M5-RC7".  Can be an arbitrary string, but must be a single
     81   # word and a valid file name.
     82   #
     83   # If there is no BUILD_ID set, make it obvious.
     84   BUILD_ID := UNKNOWN
     85 endif
     86 
     87 ifeq "" "$(BUILD_NUMBER)"
     88   # BUILD_NUMBER should be set to the source control value that
     89   # represents the current state of the source code.  E.g., a
     90   # perforce changelist number or a git hash.  Can be an arbitrary string
     91   # (to allow for source control that uses something other than numbers),
     92   # but must be a single word and a valid file name.
     93   #
     94   # If no BUILD_NUMBER is set, create a useful "I am an engineering build
     95   # from this date/time" value.  Make it start with a non-digit so that
     96   # anyone trying to parse it as an integer will probably get "0".
     97   BUILD_NUMBER := eng.$(USER).$(shell date +%Y%m%d.%H%M%S)
     98 endif
     99