# Copyright (C) 2009 The Android Open Source Project # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # # this script is used to record an application definition in the # NDK build system, before performing any build whatsoever. # # It is included repeatedly from build/core/main.mk and expects a # variable named '_application_mk' which points to a given Application.mk # file that will be included here. The latter must define a few variables # to describe the application to the build system, and the rest of the # code here will perform book-keeping and basic checks # $(call assert-defined, _application_mk _app) $(call ndk_log,Parsing $(_application_mk)) $(call clear-vars, $(NDK_APP_VARS)) # Check that NDK_DEBUG is properly defined. If it is # the only valid states are: undefined, 0, 1, false and true # # We set APP_DEBUG to <undefined>, 'true' or 'false'. # APP_DEBUG := $(strip $(NDK_DEBUG)) ifeq ($(APP_DEBUG),0) APP_DEBUG:= false endif ifeq ($(APP_DEBUG),1) APP_DEBUG := true endif ifdef APP_DEBUG ifneq (,$(filter-out true false,$(APP_DEBUG))) $(call __ndk_warning,NDK_DEBUG is defined to the unsupported value '$(NDK_DEBUG)', will be ignored!) endif endif include $(_application_mk) $(call check-required-vars,$(NDK_APP_VARS_REQUIRED),$(_application_mk)) _map := NDK_APP.$(_app) # strip the 'lib' prefix in front of APP_MODULES modules APP_MODULES := $(call strip-lib-prefix,$(APP_MODULES)) APP_PROJECT_PATH := $(strip $(APP_PROJECT_PATH)) ifndef APP_PROJECT_PATH APP_PROJECT_PATH := $(NDK_PROJECT_PATH) endif ifeq (null,$(APP_PROJECT_PATH)) ifndef APP_PLATFORM APP_PLATFORM := android-3 $(call ndk_log, Defaulted to APP_PLATFORM=$(APP_PLATFORM)) endif else # check whether APP_PLATFORM is defined. If not, look for project.properties in # the $(APP_PROJECT_PATH) and extract the value with awk's help. If nothing is here, # revert to the default value (i.e. "android-3"). # APP_PLATFORM := $(strip $(APP_PLATFORM)) ifndef APP_PLATFORM _local_props := $(strip $(wildcard $(APP_PROJECT_PATH)/project.properties)) ifndef _local_props # NOTE: project.properties was called default.properties before _local_props := $(strip $(wildcard $(APP_PROJECT_PATH)/default.properties)) endif ifdef _local_props APP_PLATFORM := $(strip $(shell $(HOST_AWK) -f $(BUILD_AWK)/extract-platform.awk $(call host-path,$(_local_props)))) $(call ndk_log, Found APP_PLATFORM=$(APP_PLATFORM) in $(_local_props)) else APP_PLATFORM := android-3 $(call ndk_log, Defaulted to APP_PLATFORM=$(APP_PLATFORM)) endif endif endif # APP_PROJECT_PATH == null # SPECIAL CASES: # 1) android-6 and android-7 are the same thing as android-5 # 2) android-10 and android-11 are the same thing as android-9 # 3) android-20 and up are the same thing as android-19 # APP_PLATFORM_LEVEL := $(strip $(subst android-,,$(APP_PLATFORM))) ifneq ($(APP_PLATFORM_LEVEL),$(NDK_PREVIEW_LEVEL)) ifneq (,$(filter 6 7,$(APP_PLATFORM_LEVEL))) override APP_PLATFORM := android-5 endif ifneq (,$(filter 10 11,$(APP_PLATFORM_LEVEL))) override APP_PLATFORM := android-9 endif ifneq (,$(call gt,$(APP_PLATFORM_LEVEL),19)) override APP_PLATFORM := android-19 endif ifneq ($(strip $(subst android-,,$(APP_PLATFORM))),$(APP_PLATFORM_LEVEL)) $(call ndk_log, Adjusting APP_PLATFORM android-$(APP_PLATFORM_LEVEL) to $(APP_PLATFORM)) endif # If APP_PIE isn't defined, set it to true for android-$(NDK_PIE_PLATFORM_LEVEL) and above # APP_PIE := $(strip $(APP_PIE)) $(call ndk_log, APP_PIE is $(APP_PIE)) ifndef APP_PIE ifneq (,$(call gte,$(APP_PLATFORM_LEVEL),$(NDK_PIE_PLATFORM_LEVEL))) APP_PIE := true $(call ndk_log, Enabling -fPIE) else APP_PIE := false endif endif # Check that the value of APP_PLATFORM corresponds to a known platform # If not, we're going to use the max supported platform value. # _bad_platform := $(strip $(filter-out $(NDK_ALL_PLATFORMS),$(APP_PLATFORM))) ifdef _bad_platform $(call ndk_log,Application $(_app) targets unknown platform '$(_bad_platform)') override APP_PLATFORM := android-$(NDK_MAX_PLATFORM_LEVEL) $(call ndk_log,Switching to $(APP_PLATFORM)) endif ifneq (null,$(APP_PROJECT_PATH)) ifneq ($(APP_PLATFORM),android-$(NDK_PREVIEW_LEVEL)) # Check platform level (after adjustment) against android:minSdkVersion in AndroidManifest.xml # APP_MANIFEST := $(strip $(wildcard $(APP_PROJECT_PATH)/AndroidManifest.xml)) APP_PLATFORM_LEVEL := $(strip $(subst android-,,$(APP_PLATFORM))) ifdef APP_MANIFEST APP_MIN_PLATFORM_LEVEL := $(strip $(shell $(HOST_AWK) -f $(BUILD_AWK)/extract-minsdkversion.awk $(call host-path,$(APP_MANIFEST)))) ifdef APP_MIN_PLATFORM_LEVEL ifneq (,$(call gt,$(APP_PLATFORM_LEVEL),$(APP_MIN_PLATFORM_LEVEL))) $(call __ndk_info,WARNING: APP_PLATFORM $(APP_PLATFORM) is larger than android:minSdkVersion $(APP_MIN_PLATFORM_LEVEL) in $(APP_MANIFEST)) endif endif endif endif endif # APP_PROJECT_PATH == null else # $(APP_PLATFORM_LEVEL) = $(NDK_PREVIEW_LEVEL) APP_PIE := true endif # $(APP_PLATFORM_LEVEL) != $(NDK_PREVIEW_LEVEL) # Check that the value of APP_ABI corresponds to known ABIs # 'all' is a special case that means 'all supported ABIs' # # It will be handled in setup-app.mk. We can't hope to change # the value of APP_ABI is the user enforces it on the command-line # with a call like: ndk-build APP_ABI=all # # Because GNU Make makes the APP_ABI variable read-only (any assignments # to it will be ignored) # APP_ABI := $(subst $(comma),$(space),$(strip $(APP_ABI))) ifndef APP_ABI # Default ABI is 'armeabi' APP_ABI := armeabi endif ifneq ($(APP_ABI),all) _bad_abis := $(strip $(filter-out $(NDK_ALL_ABIS),$(APP_ABIS))) ifdef _bad_abis $(call __ndk_info,Application $(_app) targets unknown ABI '$(_bad_abis)') $(call __ndk_info,Please fix the APP_ABI definition in $(_application_mk)) $(call __ndk_info,to use a set of the following values: $(NDK_ALL_ABIS)) $(call __ndk_error,Aborting) endif endif # If APP_BUILD_SCRIPT is defined, check that the file exists. # If undefined, look in $(APP_PROJECT_PATH)/jni/Android.mk # APP_BUILD_SCRIPT := $(strip $(APP_BUILD_SCRIPT)) ifdef APP_BUILD_SCRIPT _build_script := $(strip $(wildcard $(APP_BUILD_SCRIPT))) ifndef _build_script $(call __ndk_info,Your APP_BUILD_SCRIPT points to an unknown file: $(APP_BUILD_SCRIPT)) $(call __ndk_error,Aborting...) endif APP_BUILD_SCRIPT := $(_build_script) $(call ndk_log, Using build script $(APP_BUILD_SCRIPT)) else ifeq (null,$(APP_PROJECT_PATH)) $(call __ndk_info,NDK_PROJECT_PATH==null. Please explicitly set APP_BUILD_SCRIPT.) $(call __ndk_error,Aborting.) endif _build_script := $(strip $(wildcard $(APP_PROJECT_PATH)/jni/Android.mk)) ifndef _build_script $(call __ndk_info,There is no Android.mk under $(APP_PROJECT_PATH)/jni) $(call __ndk_info,If this is intentional, please define APP_BUILD_SCRIPT to point) $(call __ndk_info,to a valid NDK build script.) $(call __ndk_error,Aborting...) endif APP_BUILD_SCRIPT := $(_build_script) $(call ndk_log, Defaulted to APP_BUILD_SCRIPT=$(APP_BUILD_SCRIPT)) endif # Determine whether the application should be debuggable. # - If APP_DEBUG is set to 'true', then it always should. # - If APP_DEBUG is set to 'false', then it never should # - Otherwise, extract the android:debuggable attribute from the manifest. # ifdef APP_DEBUG APP_DEBUGGABLE := $(APP_DEBUG) ifeq ($(NDK_LOG),1) ifeq ($(APP_DEBUG),true) $(call ndk_log,Application '$(_app)' forced debuggable through NDK_DEBUG) else $(call ndk_log,Application '$(_app)' forced *not* debuggable through NDK_DEBUG) endif endif else # NOTE: To make unit-testing simpler, handle the case where there is no manifest. APP_DEBUGGABLE := false ifdef APP_MANIFEST APP_DEBUGGABLE := $(shell $(HOST_AWK) -f $(BUILD_AWK)/extract-debuggable.awk $(call host-path,$(APP_MANIFEST))) endif ifeq ($(NDK_LOG),1) ifeq ($(APP_DEBUGGABLE),true) $(call ndk_log,Application '$(_app)' *is* debuggable) else $(call ndk_log,Application '$(_app)' is not debuggable) endif endif endif # LOCAL_BUILD_MODE will be either release or debug # # If APP_OPTIM is defined in the Application.mk, just use this. # # Otherwise, set to 'debug' if android:debuggable is set to TRUE, # and to 'release' if not. # ifneq ($(APP_OPTIM),) # check that APP_OPTIM, if defined, is either 'release' or 'debug' $(if $(filter-out release debug,$(APP_OPTIM)),\ $(call __ndk_info, The APP_OPTIM defined in $(_application_mk) must only be 'release' or 'debug')\ $(call __ndk_error,Aborting)\ ) $(call ndk_log,Selecting optimization mode through Application.mk: $(APP_OPTIM)) else ifeq ($(APP_DEBUGGABLE),true) $(call ndk_log,Selecting debug optimization mode (app is debuggable)) APP_OPTIM := debug else $(call ndk_log,Selecting release optimization mode (app is not debuggable)) APP_OPTIM := release endif endif APP_CFLAGS := $(strip $(APP_CFLAGS)) APP_CONLYFLAGS := $(strip $(APP_CONLYFLAGS)) APP_CPPFLAGS := $(strip $(APP_CPPFLAGS)) APP_CXXFLAGS := $(strip $(APP_CXXFLAGS)) APP_RENDERSCRIPT_FLAGS := $(strip $(APP_RENDERSCRIPT_FLAGS)) APP_ASMFLAGS := $(strip $(APP_ASMFLAGS)) APP_LDFLAGS := $(strip $(APP_LDFLAGS)) # Check that APP_STL is defined. If not, use the default value (system) # otherwise, check that the name is correct. APP_STL := $(strip $(APP_STL)) ifndef APP_STL APP_STL := system else $(call ndk-stl-check,$(APP_STL)) endif $(if $(call get,$(_map),defined),\ $(call __ndk_info,Weird, the application $(_app) is already defined by $(call get,$(_map),defined))\ $(call __ndk_error,Aborting)\ ) $(call set,$(_map),defined,$(_application_mk)) # Record all app-specific variable definitions $(foreach __name,$(NDK_APP_VARS),\ $(call set,$(_map),$(__name),$($(__name)))\ ) # Record the Application.mk for debugging $(call set,$(_map),Application.mk,$(_application_mk)) NDK_ALL_APPS += $(_app)