1# Copyright (C) 2009 The Android Open Source Project 2# 3# Licensed under the Apache License, Version 2.0 (the "License"); 4# you may not use this file except in compliance with the License. 5# You may obtain a copy of the License at 6# 7# http://www.apache.org/licenses/LICENSE-2.0 8# 9# Unless required by applicable law or agreed to in writing, software 10# distributed under the License is distributed on an "AS IS" BASIS, 11# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12# See the License for the specific language governing permissions and 13# limitations under the License. 14# 15 16# this script is used to record an application definition in the 17# NDK build system, before performing any build whatsoever. 18# 19# It is included repeatedly from build/core/main.mk and expects a 20# variable named '_application_mk' which points to a given Application.mk 21# file that will be included here. The latter must define a few variables 22# to describe the application to the build system, and the rest of the 23# code here will perform book-keeping and basic checks 24# 25 26$(call assert-defined, _application_mk _app) 27$(call ndk_log,Parsing $(_application_mk)) 28 29$(call clear-vars, $(NDK_APP_VARS)) 30 31# Check that NDK_DEBUG is properly defined. If it is 32# the only valid states are: undefined, 0, 1, false and true 33# 34# We set APP_DEBUG to <undefined>, 'true' or 'false'. 35# 36APP_DEBUG := $(strip $(NDK_DEBUG)) 37ifeq ($(APP_DEBUG),0) 38 APP_DEBUG:= false 39endif 40ifeq ($(APP_DEBUG),1) 41 APP_DEBUG := true 42endif 43ifdef APP_DEBUG 44 ifneq (,$(filter-out true false,$(APP_DEBUG))) 45 $(call __ndk_warning,NDK_DEBUG is defined to the unsupported value '$(NDK_DEBUG)', will be ignored!) 46 endif 47endif 48 49include $(_application_mk) 50 51$(call check-required-vars,$(NDK_APP_VARS_REQUIRED),$(_application_mk)) 52 53_map := NDK_APP.$(_app) 54 55# strip the 'lib' prefix in front of APP_MODULES modules 56APP_MODULES := $(call strip-lib-prefix,$(APP_MODULES)) 57 58APP_PROJECT_PATH := $(strip $(APP_PROJECT_PATH)) 59ifndef APP_PROJECT_PATH 60 APP_PROJECT_PATH := $(NDK_PROJECT_PATH) 61endif 62 63# check whether APP_PLATFORM is defined. If not, look for project.properties in 64# the $(APP_PROJECT_PATH) and extract the value with awk's help. If nothing is here, 65# revert to the default value (i.e. "android-3"). 66# 67APP_PLATFORM := $(strip $(APP_PLATFORM)) 68ifndef APP_PLATFORM 69 _local_props := $(strip $(wildcard $(APP_PROJECT_PATH)/project.properties)) 70 ifndef _local_props 71 # NOTE: project.properties was called default.properties before 72 _local_props := $(strip $(wildcard $(APP_PROJECT_PATH)/default.properties)) 73 endif 74 ifdef _local_props 75 APP_PLATFORM := $(strip $(shell $(HOST_AWK) -f $(BUILD_AWK)/extract-platform.awk $(call host-path,$(_local_props)))) 76 $(call ndk_log, Found APP_PLATFORM=$(APP_PLATFORM) in $(_local_props)) 77 else 78 APP_PLATFORM := android-3 79 $(call ndk_log, Defaulted to APP_PLATFORM=$(APP_PLATFORM)) 80 endif 81endif 82 83# SPECIAL CASES: 84# 1) android-6 and android-7 are the same thing as android-5 85# 2) android-10 .. 13 are the same thing as android-9 86# 3) android-15 .. 17 are the same thing as android-14 87# 4) android-18 and up are the same thing as android-18 88# 89APP_PLATFORM_LEVEL := $(strip $(subst android-,,$(APP_PLATFORM))) 90ifneq (,$(filter 6 7,$(APP_PLATFORM_LEVEL))) 91 APP_PLATFORM := android-5 92 $(call ndk_log, Adjusting APP_PLATFORM android-$(APP_PLATFORM_LEVEL) to $(APP_PLATFORM)) 93endif 94ifneq (,$(filter 10 11 12 13,$(APP_PLATFORM_LEVEL))) 95 APP_PLATFORM := android-9 96 $(call ndk_log, Adjusting APP_PLATFORM android-$(APP_PLATFORM_LEVEL) to $(APP_PLATFORM)) 97endif 98ifneq (,$(filter 15 16 17,$(APP_PLATFORM_LEVEL))) 99 APP_PLATFORM := android-14 100 $(call ndk_log, Adjusting APP_PLATFORM android-$(APP_PLATFORM_LEVEL) to $(APP_PLATFORM)) 101endif 102ifneq (,$(call gt,$(APP_PLATFORM_LEVEL),18)) 103 APP_PLATFORM := android-18 104 $(call ndk_log, Adjusting APP_PLATFORM android-$(APP_PLATFORM_LEVEL) to $(APP_PLATFORM)) 105endif 106 107# If APP_PIE isn't defined, set it to true for android-16 and above 108# 109APP_PIE := $(strip $(APP_PIE)) 110$(call ndk_log, APP_PIE is $(APP_PIE)) 111ifndef APP_PIE 112 ifneq (,$(call gte,$(APP_PLATFORM_LEVEL),16)) 113 APP_PIE := true 114 $(call ndk_log, Enabling -fPIE) 115 else 116 APP_PIE := false 117 endif 118endif 119 120# Check that the value of APP_PLATFORM corresponds to a known platform 121# If not, we're going to use the max supported platform value. 122# 123_bad_platform := $(strip $(filter-out $(NDK_ALL_PLATFORMS),$(APP_PLATFORM))) 124ifdef _bad_platform 125 $(call ndk_log,Application $(_app) targets unknown platform '$(_bad_platform)') 126 APP_PLATFORM := android-$(NDK_MAX_PLATFORM_LEVEL) 127 $(call ndk_log,Switching to $(APP_PLATFORM)) 128endif 129 130# Check platform level (after adjustment) against android:minSdkVersion in AndroidManifest.xml 131# 132APP_MANIFEST := $(strip $(wildcard $(APP_PROJECT_PATH)/AndroidManifest.xml)) 133APP_PLATFORM_LEVEL := $(strip $(subst android-,,$(APP_PLATFORM))) 134ifdef APP_MANIFEST 135 APP_MIN_PLATFORM_LEVEL := $(strip $(shell $(HOST_AWK) -f $(BUILD_AWK)/extract-minsdkversion.awk $(call host-path,$(APP_MANIFEST)))) 136 ifdef APP_MIN_PLATFORM_LEVEL 137 ifneq (,$(call gt,$(APP_PLATFORM_LEVEL),$(APP_MIN_PLATFORM_LEVEL))) 138 $(call __ndk_info,WARNING: APP_PLATFORM $(APP_PLATFORM) is larger than android:minSdkVersion $(APP_MIN_PLATFORM_LEVEL) in $(APP_MANIFEST)) 139 endif 140 endif 141endif 142 143# Check that the value of APP_ABI corresponds to known ABIs 144# 'all' is a special case that means 'all supported ABIs' 145# 146# It will be handled in setup-app.mk. We can't hope to change 147# the value of APP_ABI is the user enforces it on the command-line 148# with a call like: ndk-build APP_ABI=all 149# 150# Because GNU Make makes the APP_ABI variable read-only (any assignments 151# to it will be ignored) 152# 153APP_ABI := $(strip $(APP_ABI)) 154ifndef APP_ABI 155 # Default ABI is 'armeabi' 156 APP_ABI := armeabi 157endif 158ifneq ($(APP_ABI),all) 159 _bad_abis := $(strip $(filter-out $(NDK_ALL_ABIS),$(APP_ABIS))) 160 ifdef _bad_abis 161 $(call __ndk_info,Application $(_app) targets unknown ABI '$(_bad_abis)') 162 $(call __ndk_info,Please fix the APP_ABI definition in $(_application_mk)) 163 $(call __ndk_info,to use a set of the following values: $(NDK_ALL_ABIS)) 164 $(call __ndk_error,Aborting) 165 endif 166endif 167 168# If APP_BUILD_SCRIPT is defined, check that the file exists. 169# If undefined, look in $(APP_PROJECT_PATH)/jni/Android.mk 170# 171APP_BUILD_SCRIPT := $(strip $(APP_BUILD_SCRIPT)) 172ifdef APP_BUILD_SCRIPT 173 _build_script := $(strip $(wildcard $(APP_BUILD_SCRIPT))) 174 ifndef _build_script 175 $(call __ndk_info,Your APP_BUILD_SCRIPT points to an unknown file: $(APP_BUILD_SCRIPT)) 176 $(call __ndk_error,Aborting...) 177 endif 178 APP_BUILD_SCRIPT := $(_build_script) 179 $(call ndk_log, Using build script $(APP_BUILD_SCRIPT)) 180else 181 _build_script := $(strip $(wildcard $(APP_PROJECT_PATH)/jni/Android.mk)) 182 ifndef _build_script 183 $(call __ndk_info,There is no Android.mk under $(APP_PROJECT_PATH)/jni) 184 $(call __ndk_info,If this is intentional, please define APP_BUILD_SCRIPT to point) 185 $(call __ndk_info,to a valid NDK build script.) 186 $(call __ndk_error,Aborting...) 187 endif 188 APP_BUILD_SCRIPT := $(_build_script) 189 $(call ndk_log, Defaulted to APP_BUILD_SCRIPT=$(APP_BUILD_SCRIPT)) 190endif 191 192# Determine whether the application should be debuggable. 193# - If APP_DEBUG is set to 'true', then it always should. 194# - If APP_DEBUG is set to 'false', then it never should 195# - Otherwise, extract the android:debuggable attribute from the manifest. 196# 197ifdef APP_DEBUG 198 APP_DEBUGGABLE := $(APP_DEBUG) 199 ifeq ($(NDK_LOG),1) 200 ifeq ($(APP_DEBUG),true) 201 $(call ndk_log,Application '$(_app)' forced debuggable through NDK_DEBUG) 202 else 203 $(call ndk_log,Application '$(_app)' forced *not* debuggable through NDK_DEBUG) 204 endif 205 endif 206else 207 # NOTE: To make unit-testing simpler, handle the case where there is no manifest. 208 APP_DEBUGGABLE := false 209 ifdef APP_MANIFEST 210 APP_DEBUGGABLE := $(shell $(HOST_AWK) -f $(BUILD_AWK)/extract-debuggable.awk $(call host-path,$(APP_MANIFEST))) 211 endif 212 ifeq ($(NDK_LOG),1) 213 ifeq ($(APP_DEBUGGABLE),true) 214 $(call ndk_log,Application '$(_app)' *is* debuggable) 215 else 216 $(call ndk_log,Application '$(_app)' is not debuggable) 217 endif 218 endif 219endif 220 221# LOCAL_BUILD_MODE will be either release or debug 222# 223# If APP_OPTIM is defined in the Application.mk, just use this. 224# 225# Otherwise, set to 'debug' if android:debuggable is set to TRUE, 226# and to 'release' if not. 227# 228ifneq ($(APP_OPTIM),) 229 # check that APP_OPTIM, if defined, is either 'release' or 'debug' 230 $(if $(filter-out release debug,$(APP_OPTIM)),\ 231 $(call __ndk_info, The APP_OPTIM defined in $(_application_mk) must only be 'release' or 'debug')\ 232 $(call __ndk_error,Aborting)\ 233 ) 234 $(call ndk_log,Selecting optimization mode through Application.mk: $(APP_OPTIM)) 235else 236 ifeq ($(APP_DEBUGGABLE),true) 237 $(call ndk_log,Selecting debug optimization mode (app is debuggable)) 238 APP_OPTIM := debug 239 else 240 $(call ndk_log,Selecting release optimization mode (app is not debuggable)) 241 APP_OPTIM := release 242 endif 243endif 244 245APP_CFLAGS := $(strip $(APP_CFLAGS)) 246APP_LDFLAGS := $(strip $(APP_LDFLAGS)) 247 248# Check that APP_STL is defined. If not, use the default value (system) 249# otherwise, check that the name is correct. 250APP_STL := $(strip $(APP_STL)) 251ifndef APP_STL 252 APP_STL := system 253else 254 $(call ndk-stl-check,$(APP_STL)) 255endif 256 257$(if $(call get,$(_map),defined),\ 258 $(call __ndk_info,Weird, the application $(_app) is already defined by $(call get,$(_map),defined))\ 259 $(call __ndk_error,Aborting)\ 260) 261 262$(call set,$(_map),defined,$(_application_mk)) 263 264# Record all app-specific variable definitions 265$(foreach __name,$(NDK_APP_VARS),\ 266 $(call set,$(_map),$(__name),$($(__name)))\ 267) 268 269# Record the Application.mk for debugging 270$(call set,$(_map),Application.mk,$(_application_mk)) 271 272NDK_ALL_APPS += $(_app) 273