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 # check whether APP_PLATFORM is defined. If not, look for default.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 # 67 # NOTE: APP_PLATFORM is an experimental feature for now. 68 # 69 APP_PLATFORM := $(strip $(APP_PLATFORM)) 70 ifndef APP_PLATFORM 71 _local_props := $(strip $(wildcard $(APP_PROJECT_PATH)/default.properties)) 72 ifdef _local_props 73 APP_PLATFORM := $(strip $(shell $(HOST_AWK) -f $(BUILD_AWK)/extract-platform.awk < $(_local_props))) 74 $(call ndk_log, Found APP_PLATFORM=$(APP_PLATFORM) in $(_local_props)) 75 else 76 APP_PLATFORM := android-3 77 $(call ndk_log, Defaulted to APP_PLATFORM=$(APP_PLATFORM)) 78 endif 79 endif 80 81 # SPECIAL CASE: android-6 and android-7 are the same thing than android-5 82 # with regards to the NDK. Adjust accordingly! 83 ifneq (,$(filter android-6 android-7,$(APP_PLATFORM))) 84 APP_PLATFORM := android-5 85 $(call ndk_log, Adjusting APP_PLATFORM to $(APP_PLATFORM)) 86 endif 87 88 # Check that the value of APP_PLATFORM corresponds to a known platform 89 # If not, we're going to use the max supported platform value. 90 # 91 _bad_platform := $(strip $(filter-out $(NDK_ALL_PLATFORMS),$(APP_PLATFORM))) 92 ifdef _bad_platform 93 $(call ndk_log,Application $(_name) targets unknown platform '$(_bad_platform)') 94 APP_PLATFORM := android-$(NDK_MAX_PLATFORM_LEVEL) 95 $(call ndk_log,Switching to $(APP_PLATFORM)) 96 endif 97 98 # Check that the value of APP_ABI corresponds to known ABIs 99 # 100 _bad_abis := $(strip $(filter-out $(NDK_ALL_ABIS),$(APP_ABI))) 101 ifdef _bad_abis 102 $(call __ndk_info,Application $(_name) targets unknown ABI '$(_bad_abis)') 103 $(call __ndk_info,Please fix the APP_ABI definition in $(_application_mk)) 104 $(call __ndk_info,to use a set of the following values: $(NDK_ALL_ABIS)) 105 $(call __ndk_error,Aborting) 106 endif 107 108 # If APP_BUILD_SCRIPT is defined, check that the file exists. 109 # If undefined, look in $(APP_PROJECT_PATH)/jni/Android.mk 110 # 111 APP_BUILD_SCRIPT := $(strip $(APP_BUILD_SCRIPT)) 112 ifdef APP_BUILD_SCRIPT 113 _build_script := $(strip $(wildcard $(APP_BUILD_SCRIPT))) 114 ifndef _build_script 115 $(call __ndk_info,Your APP_BUILD_SCRIPT points to an unknown file: $(APP_BUILD_SCRIPT)) 116 $(call __ndk_error,Aborting...) 117 endif 118 APP_BUILD_SCRIPT := $(_build_script) 119 $(call ndk_log, Using build script $(APP_BUILD_SCRIPT)) 120 else 121 _build_script := $(strip $(wildcard $(APP_PROJECT_PATH)/jni/Android.mk)) 122 ifndef _build_script 123 $(call __ndk_info,There is no Android.mk under $(APP_PROJECT_PATH)/jni) 124 $(call __ndk_info,If this is intentional, please define APP_BUILD_SCRIPT to point) 125 $(call __ndk_info,to a valid NDK build script.) 126 $(call __ndk_error,Aborting...) 127 endif 128 APP_BUILD_SCRIPT := $(_build_script) 129 $(call ndk_log, Defaulted to APP_BUILD_SCRIPT=$(APP_BUILD_SCRIPT)) 130 endif 131 132 # Determine whether the application should be debuggable. 133 # - If APP_DEBUG is set to 'true', then it always should. 134 # - If APP_DEBUG is set to 'false', then it never should 135 # - Otherwise, extract the android:debuggable attribute from the manifest. 136 # 137 ifdef APP_DEBUG 138 APP_DEBUGGABLE := $(APP_DEBUG) 139 ifdef NDK_LOG 140 ifeq ($(APP_DEBUG),true) 141 $(call ndk_log,Application '$(_app)' forced debuggable through NDK_DEBUG) 142 else 143 $(call ndk_log,Application '$(_app)' forced *not* debuggable through NDK_DEBUG) 144 endif 145 endif 146 else 147 # NOTE: To make unit-testing simpler, handle the case where there is no manifest. 148 APP_DEBUGGABLE := false 149 APP_MANIFEST := $(strip $(wildcard $(APP_PROJECT_PATH)/AndroidManifest.xml)) 150 ifdef APP_MANIFEST 151 APP_DEBUGGABLE := $(shell $(HOST_AWK) -f $(BUILD_AWK)/extract-debuggable.awk $(APP_MANIFEST)) 152 endif 153 ifdef NDK_LOG 154 ifeq ($(APP_DEBUGGABLE),true) 155 $(call ndk_log,Application '$(_app)' *is* debuggable) 156 else 157 $(call ndk_log,Application '$(_app)' is not debuggable) 158 endif 159 endif 160 endif 161 162 # LOCAL_BUILD_MODE will be either release or debug 163 # 164 # If APP_OPTIM is defined in the Application.mk, just use this. 165 # 166 # Otherwise, set to 'debug' if android:debuggable is set to TRUE, 167 # and to 'release' if not. 168 # 169 ifneq ($(APP_OPTIM),) 170 # check that APP_OPTIM, if defined, is either 'release' or 'debug' 171 $(if $(filter-out release debug,$(APP_OPTIM)),\ 172 $(call __ndk_info, The APP_OPTIM defined in $(_application_mk) must only be 'release' or 'debug')\ 173 $(call __ndk_error,Aborting)\ 174 ) 175 $(call ndk_log,Selecting optimization mode through Application.mk: $(APP_OPTIM)) 176 else 177 ifeq ($(APP_DEBUGGABLE),true) 178 $(call ndk_log,Selecting debug optimization mode (app is debuggable)) 179 APP_OPTIM := debug 180 else 181 $(call ndk_log,Selecting release optimization mode (app is not debuggable)) 182 APP_OPTIM := release 183 endif 184 endif 185 186 # set release/debug build flags. We always use the -g flag because 187 # we generate symbol versions of the binaries that are later stripped 188 # when they are copied to the final project's libs/<abi> directory. 189 # 190 ifeq ($(APP_OPTIM),debug) 191 APP_CFLAGS := -O0 -g $(APP_CFLAGS) 192 else 193 APP_CFLAGS := -O2 -DNDEBUG -g $(APP_CFLAGS) 194 endif 195 196 $(if $(call get,$(_map),defined),\ 197 $(call __ndk_info,Weird, the application $(_name) is already defined by $(call get,$(_map),defined))\ 198 $(call __ndk_error,Aborting)\ 199 ) 200 201 $(call set,$(_map),defined,$(_application_mk)) 202 203 # Record all app-specific variable definitions 204 $(foreach __name,$(NDK_APP_VARS),\ 205 $(call set,$(_map),$(__name),$($(__name)))\ 206 ) 207 208 # Record the Application.mk for debugging 209 $(call set,$(_map),Application.mk,$(_application_mk)) 210 211 NDK_ALL_APPS += $(_name) 212