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 # 36 APP_DEBUG := $(strip $(NDK_DEBUG)) 37 ifeq ($(APP_DEBUG),0) 38 APP_DEBUG:= false 39 endif 40 ifeq ($(APP_DEBUG),1) 41 APP_DEBUG := true 42 endif 43 ifdef 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 47 endif 48 49 include $(_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 56 APP_MODULES := $(call strip-lib-prefix,$(APP_MODULES)) 57 58 APP_PROJECT_PATH := $(strip $(APP_PROJECT_PATH)) 59 ifndef APP_PROJECT_PATH 60 APP_PROJECT_PATH := $(NDK_PROJECT_PATH) 61 endif 62 63 ifeq (null,$(APP_PROJECT_PATH)) 64 65 ifndef APP_PLATFORM 66 APP_PLATFORM := android-3 67 $(call ndk_log, Defaulted to APP_PLATFORM=$(APP_PLATFORM)) 68 endif 69 70 else 71 72 # check whether APP_PLATFORM is defined. If not, look for project.properties in 73 # the $(APP_PROJECT_PATH) and extract the value with awk's help. If nothing is here, 74 # revert to the default value (i.e. "android-3"). 75 # 76 APP_PLATFORM := $(strip $(APP_PLATFORM)) 77 ifndef APP_PLATFORM 78 _local_props := $(strip $(wildcard $(APP_PROJECT_PATH)/project.properties)) 79 ifndef _local_props 80 # NOTE: project.properties was called default.properties before 81 _local_props := $(strip $(wildcard $(APP_PROJECT_PATH)/default.properties)) 82 endif 83 ifdef _local_props 84 APP_PLATFORM := $(strip $(shell $(HOST_AWK) -f $(BUILD_AWK)/extract-platform.awk $(call host-path,$(_local_props)))) 85 $(call ndk_log, Found APP_PLATFORM=$(APP_PLATFORM) in $(_local_props)) 86 else 87 APP_PLATFORM := android-3 88 $(call ndk_log, Defaulted to APP_PLATFORM=$(APP_PLATFORM)) 89 endif 90 endif 91 92 ifeq ($(APP_PLATFORM),android-L) 93 $(call __ndk_warning,WARNING: android-L is renamed as android-21) 94 override APP_PLATFORM := android-21 95 endif 96 97 endif # APP_PROJECT_PATH == null 98 99 # SPECIAL CASES: 100 # 1) android-6 and android-7 are the same thing as android-5 101 # 2) android-10 and android-11 are the same thing as android-9 102 # 3) android-20 is the same thing as android-19 103 # 4) android-21 and up are the same thing as android-21 104 # ADDITIONAL CASES for remote server where total number of files is limited 105 # 5) android-13 is the same thing as android-12 106 # 6) android-15 is the same thing as android-14 107 # 7) android-17 is the same thing as android-16 108 APP_PLATFORM_LEVEL := $(strip $(subst android-,,$(APP_PLATFORM))) 109 ifneq (,$(filter 6 7,$(APP_PLATFORM_LEVEL))) 110 override APP_PLATFORM := android-5 111 endif 112 ifneq (,$(filter 10 11,$(APP_PLATFORM_LEVEL))) 113 override APP_PLATFORM := android-9 114 endif 115 ifneq (,$(filter 20,$(APP_PLATFORM_LEVEL))) 116 override APP_PLATFORM := android-19 117 endif 118 ifneq (,$(call gt,$(APP_PLATFORM_LEVEL),21)) 119 override APP_PLATFORM := android-21 120 endif 121 122 ifneq ($(strip $(subst android-,,$(APP_PLATFORM))),$(APP_PLATFORM_LEVEL)) 123 $(call ndk_log, Adjusting APP_PLATFORM android-$(APP_PLATFORM_LEVEL) to $(APP_PLATFORM)) 124 endif 125 126 # If APP_PIE isn't defined, set it to true for android-$(NDK_FIRST_PIE_PLATFORM_LEVEL) and above 127 # 128 APP_PIE := $(strip $(APP_PIE)) 129 $(call ndk_log, APP_PIE is $(APP_PIE)) 130 ifndef APP_PIE 131 ifneq (,$(call gte,$(APP_PLATFORM_LEVEL),$(NDK_FIRST_PIE_PLATFORM_LEVEL))) 132 APP_PIE := true 133 $(call ndk_log, Enabling -fPIE) 134 else 135 APP_PIE := false 136 endif 137 endif 138 139 # Check that the value of APP_PLATFORM corresponds to a known platform 140 # If not, we're going to use the max supported platform value. 141 # 142 _bad_platform := $(strip $(filter-out $(NDK_ALL_PLATFORMS),$(APP_PLATFORM))) 143 ifdef _bad_platform 144 $(call ndk_log,Application $(_app) targets unknown platform '$(_bad_platform)') 145 override APP_PLATFORM := android-$(NDK_MAX_PLATFORM_LEVEL) 146 $(call ndk_log,Switching to $(APP_PLATFORM)) 147 endif 148 149 ifneq (null,$(APP_PROJECT_PATH)) 150 151 # Check platform level (after adjustment) against android:minSdkVersion in AndroidManifest.xml 152 # 153 APP_MANIFEST := $(strip $(wildcard $(APP_PROJECT_PATH)/AndroidManifest.xml)) 154 APP_PLATFORM_LEVEL := $(strip $(subst android-,,$(APP_PLATFORM))) 155 ifdef APP_MANIFEST 156 APP_MIN_PLATFORM_LEVEL := $(strip $(shell $(HOST_AWK) -f $(BUILD_AWK)/extract-minsdkversion.awk $(call host-path,$(APP_MANIFEST)))) 157 ifdef APP_MIN_PLATFORM_LEVEL 158 ifneq (,$(call gt,$(APP_PLATFORM_LEVEL),$(APP_MIN_PLATFORM_LEVEL))) 159 $(call __ndk_info,WARNING: APP_PLATFORM $(APP_PLATFORM) is larger than android:minSdkVersion $(APP_MIN_PLATFORM_LEVEL) in $(APP_MANIFEST)) 160 endif 161 endif 162 endif 163 164 endif # APP_PROJECT_PATH == null 165 166 # Check that the value of APP_ABI corresponds to known ABIs 167 # 'all' is a special case that means 'all supported ABIs' 168 # 169 # It will be handled in setup-app.mk. We can't hope to change 170 # the value of APP_ABI is the user enforces it on the command-line 171 # with a call like: ndk-build APP_ABI=all 172 # 173 # Because GNU Make makes the APP_ABI variable read-only (any assignments 174 # to it will be ignored) 175 # 176 APP_ABI := $(subst $(comma),$(space),$(strip $(APP_ABI))) 177 ifndef APP_ABI 178 # Default ABI is 'armeabi' 179 APP_ABI := armeabi 180 endif 181 ifneq ($(APP_ABI),all) 182 _bad_abis := $(strip $(filter-out $(NDK_ALL_ABIS),$(APP_ABIS))) 183 ifdef _bad_abis 184 $(call __ndk_info,Application $(_app) targets unknown ABI '$(_bad_abis)') 185 $(call __ndk_info,Please fix the APP_ABI definition in $(_application_mk)) 186 $(call __ndk_info,to use a set of the following values: $(NDK_ALL_ABIS)) 187 $(call __ndk_error,Aborting) 188 endif 189 endif 190 191 # If APP_BUILD_SCRIPT is defined, check that the file exists. 192 # If undefined, look in $(APP_PROJECT_PATH)/jni/Android.mk 193 # 194 APP_BUILD_SCRIPT := $(strip $(APP_BUILD_SCRIPT)) 195 ifdef APP_BUILD_SCRIPT 196 _build_script := $(strip $(wildcard $(APP_BUILD_SCRIPT))) 197 ifndef _build_script 198 $(call __ndk_info,Your APP_BUILD_SCRIPT points to an unknown file: $(APP_BUILD_SCRIPT)) 199 $(call __ndk_error,Aborting...) 200 endif 201 APP_BUILD_SCRIPT := $(_build_script) 202 $(call ndk_log, Using build script $(APP_BUILD_SCRIPT)) 203 else 204 ifeq (null,$(APP_PROJECT_PATH)) 205 $(call __ndk_info,NDK_PROJECT_PATH==null. Please explicitly set APP_BUILD_SCRIPT.) 206 $(call __ndk_error,Aborting.) 207 endif 208 209 _build_script := $(strip $(wildcard $(APP_PROJECT_PATH)/jni/Android.mk)) 210 ifndef _build_script 211 $(call __ndk_info,There is no Android.mk under $(APP_PROJECT_PATH)/jni) 212 $(call __ndk_info,If this is intentional, please define APP_BUILD_SCRIPT to point) 213 $(call __ndk_info,to a valid NDK build script.) 214 $(call __ndk_error,Aborting...) 215 endif 216 APP_BUILD_SCRIPT := $(_build_script) 217 $(call ndk_log, Defaulted to APP_BUILD_SCRIPT=$(APP_BUILD_SCRIPT)) 218 endif 219 220 # Determine whether the application should be debuggable. 221 # - If APP_DEBUG is set to 'true', then it always should. 222 # - If APP_DEBUG is set to 'false', then it never should 223 # - Otherwise, extract the android:debuggable attribute from the manifest. 224 # 225 ifdef APP_DEBUG 226 APP_DEBUGGABLE := $(APP_DEBUG) 227 ifeq ($(NDK_LOG),1) 228 ifeq ($(APP_DEBUG),true) 229 $(call ndk_log,Application '$(_app)' forced debuggable through NDK_DEBUG) 230 else 231 $(call ndk_log,Application '$(_app)' forced *not* debuggable through NDK_DEBUG) 232 endif 233 endif 234 else 235 # NOTE: To make unit-testing simpler, handle the case where there is no manifest. 236 APP_DEBUGGABLE := false 237 ifdef APP_MANIFEST 238 APP_DEBUGGABLE := $(shell $(HOST_AWK) -f $(BUILD_AWK)/extract-debuggable.awk $(call host-path,$(APP_MANIFEST))) 239 endif 240 ifeq ($(NDK_LOG),1) 241 ifeq ($(APP_DEBUGGABLE),true) 242 $(call ndk_log,Application '$(_app)' *is* debuggable) 243 else 244 $(call ndk_log,Application '$(_app)' is not debuggable) 245 endif 246 endif 247 endif 248 249 # LOCAL_BUILD_MODE will be either release or debug 250 # 251 # If APP_OPTIM is defined in the Application.mk, just use this. 252 # 253 # Otherwise, set to 'debug' if android:debuggable is set to TRUE, 254 # and to 'release' if not. 255 # 256 ifneq ($(APP_OPTIM),) 257 # check that APP_OPTIM, if defined, is either 'release' or 'debug' 258 $(if $(filter-out release debug,$(APP_OPTIM)),\ 259 $(call __ndk_info, The APP_OPTIM defined in $(_application_mk) must only be 'release' or 'debug')\ 260 $(call __ndk_error,Aborting)\ 261 ) 262 $(call ndk_log,Selecting optimization mode through Application.mk: $(APP_OPTIM)) 263 else 264 ifeq ($(APP_DEBUGGABLE),true) 265 $(call ndk_log,Selecting debug optimization mode (app is debuggable)) 266 APP_OPTIM := debug 267 else 268 $(call ndk_log,Selecting release optimization mode (app is not debuggable)) 269 APP_OPTIM := release 270 endif 271 endif 272 273 APP_CFLAGS := $(strip $(APP_CFLAGS)) 274 APP_CONLYFLAGS := $(strip $(APP_CONLYFLAGS)) 275 APP_CPPFLAGS := $(strip $(APP_CPPFLAGS)) 276 APP_CXXFLAGS := $(strip $(APP_CXXFLAGS)) 277 APP_RENDERSCRIPT_FLAGS := $(strip $(APP_RENDERSCRIPT_FLAGS)) 278 APP_ASMFLAGS := $(strip $(APP_ASMFLAGS)) 279 APP_LDFLAGS := $(strip $(APP_LDFLAGS)) 280 281 # Check that APP_STL is defined. If not, use the default value (system) 282 # otherwise, check that the name is correct. 283 APP_STL := $(strip $(APP_STL)) 284 ifndef APP_STL 285 APP_STL := system 286 else 287 $(call ndk-stl-check,$(APP_STL)) 288 endif 289 290 $(if $(call get,$(_map),defined),\ 291 $(call __ndk_info,Weird, the application $(_app) is already defined by $(call get,$(_map),defined))\ 292 $(call __ndk_error,Aborting)\ 293 ) 294 295 $(call set,$(_map),defined,$(_application_mk)) 296 297 # Record all app-specific variable definitions 298 $(foreach __name,$(NDK_APP_VARS),\ 299 $(call set,$(_map),$(__name),$($(__name)))\ 300 ) 301 302 # Record the Application.mk for debugging 303 $(call set,$(_map),Application.mk,$(_application_mk)) 304 305 NDK_ALL_APPS += $(_app) 306
