static_java_library.mk revision dd71c85a452af4269c947797b68027c2d663d4ef 
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# Standard rules for building a "static" java library.
18# Static java libraries are not installed, nor listed on any
19# classpaths.  They can, however, be included wholesale in
20# other java modules.
21
22LOCAL_UNINSTALLABLE_MODULE := true
23LOCAL_IS_STATIC_JAVA_LIBRARY := true
24LOCAL_MODULE_CLASS := JAVA_LIBRARIES
25
26#################################
27include $(BUILD_SYSTEM)/configure_local_jack.mk
28#################################
29
30intermediates.COMMON := $(call local-intermediates-dir,COMMON)
31
32my_res_package :=
33# A zip file that apps can link with aapt2
34# We need my_library_resources as dependency even if a library doesn't have resource.
35my_library_resources := $(intermediates.COMMON)/library-res.flata
36
37# Hack to build static Java library with Android resource
38# See bug 5714516
39all_resources :=
40need_compile_res :=
41# A static Java library needs to explicily set LOCAL_RESOURCE_DIR.
42ifdef LOCAL_RESOURCE_DIR
43need_compile_res := true
44
45all_resources := $(strip \
46    $(foreach dir, $(LOCAL_RESOURCE_DIR), \
47      $(addprefix $(dir)/, \
48        $(patsubst res/%,%, \
49          $(call find-subdir-assets,$(dir)) \
50        ) \
51      ) \
52    ))
53
54# By default we should remove the R/Manifest classes from a static Java library,
55# because they will be regenerated in the app that uses it.
56# But if the static Java library will be used by a library, then we may need to
57# keep the generated classes with "LOCAL_JAR_EXCLUDE_FILES := none".
58ifndef LOCAL_JAR_EXCLUDE_FILES
59LOCAL_JAR_EXCLUDE_FILES := $(ANDROID_RESOURCE_GENERATED_CLASSES)
60endif
61ifeq (none,$(LOCAL_JAR_EXCLUDE_FILES))
62LOCAL_JAR_EXCLUDE_FILES :=
63endif
64
65proguard_options_file :=
66
67ifneq ($(LOCAL_PROGUARD_ENABLED),custom)
68  proguard_options_file := $(intermediates.COMMON)/proguard_options
69endif
70
71LOCAL_PROGUARD_FLAGS := $(addprefix -include ,$(proguard_options_file)) $(LOCAL_PROGUARD_FLAGS)
72
73ifdef LOCAL_JACK_ENABLED
74ifndef LOCAL_JACK_PROGUARD_FLAGS
75    LOCAL_JACK_PROGUARD_FLAGS := $(LOCAL_PROGUARD_FLAGS)
76endif
77LOCAL_JACK_PROGUARD_FLAGS := $(addprefix -include ,$(proguard_options_file)) $(LOCAL_JACK_PROGUARD_FLAGS)
78endif # LOCAL_JACK_ENABLED
79
80R_file_stamp := $(intermediates.COMMON)/src/R.stamp
81LOCAL_INTERMEDIATE_TARGETS += $(R_file_stamp)
82
83ifdef USE_AAPT2
84# For library we treat all the resource equal with no overlay.
85my_res_resources := $(all_resources)
86my_overlay_resources :=
87# For libraries put everything in the COMMON intermediate directory.
88my_res_package := $(intermediates.COMMON)/package-res.apk
89
90LOCAL_INTERMEDIATE_TARGETS += $(my_res_package)
91endif  # USE_AAPT2
92endif  # LOCAL_RESOURCE_DIR
93
94all_res_assets := $(all_resources)
95
96include $(BUILD_SYSTEM)/java_library.mk
97
98ifeq (true,$(need_compile_res))
99include $(BUILD_SYSTEM)/android_manifest.mk
100
101LOCAL_SDK_RES_VERSION:=$(strip $(LOCAL_SDK_RES_VERSION))
102ifeq ($(LOCAL_SDK_RES_VERSION),)
103  LOCAL_SDK_RES_VERSION:=$(LOCAL_SDK_VERSION)
104endif
105
106framework_res_package_export :=
107framework_res_package_export_deps :=
108# Please refer to package.mk
109ifneq ($(LOCAL_NO_STANDARD_LIBRARIES),true)
110ifneq ($(filter-out current system_current test_current,$(LOCAL_SDK_RES_VERSION))$(if $(TARGET_BUILD_APPS),$(filter current system_current test_current,$(LOCAL_SDK_RES_VERSION))),)
111framework_res_package_export := \
112    $(HISTORICAL_SDK_VERSIONS_ROOT)/$(LOCAL_SDK_RES_VERSION)/android.jar
113framework_res_package_export_deps := $(framework_res_package_export)
114else
115framework_res_package_export := \
116    $(call intermediates-dir-for,APPS,framework-res,,COMMON)/package-export.apk
117framework_res_package_export_deps := \
118    $(dir $(framework_res_package_export))src/R.stamp
119endif
120endif
121
122# add --non-constant-id to prevent inlining constants.
123# AAR needs text symbol file R.txt.
124ifdef USE_AAPT2
125$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_AAPT_FLAGS := $(LOCAL_AAPT_FLAGS) --non-final-ids
126else
127$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_AAPT_FLAGS := $(LOCAL_AAPT_FLAGS) --non-constant-id --output-text-symbols $(LOCAL_INTERMEDIATE_SOURCE_DIR)
128endif
129$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_SOURCE_INTERMEDIATES_DIR := $(LOCAL_INTERMEDIATE_SOURCE_DIR)
130$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_ANDROID_MANIFEST := $(full_android_manifest)
131$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_RESOURCE_PUBLICS_OUTPUT := $(intermediates.COMMON)/public_resources.xml
132$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_RESOURCE_DIR := $(LOCAL_RESOURCE_DIR)
133$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_AAPT_INCLUDES := $(framework_res_package_export)
134ifneq (,$(filter-out current system_current test_current, $(LOCAL_SDK_VERSION)))
135$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_DEFAULT_APP_TARGET_SDK := $(LOCAL_SDK_VERSION)
136else
137$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_DEFAULT_APP_TARGET_SDK := $(DEFAULT_APP_TARGET_SDK)
138endif
139$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_ASSET_DIR :=
140$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_PROGUARD_OPTIONS_FILE := $(proguard_options_file)
141$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_MANIFEST_PACKAGE_NAME :=
142$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_MANIFEST_INSTRUMENTATION_FOR :=
143
144ifdef USE_AAPT2
145# For libraries don't use any product specific flags.
146my_aapt_characteristics :=
147# One more level with name res so we can zip up the flat resources that can be linked by apps.
148my_compiled_res_base_dir := $(intermediates.COMMON)/flat-res/res
149include $(BUILD_SYSTEM)/aapt2.mk
150$(my_res_package) : $(framework_res_package_export_deps)
151else
152$(R_file_stamp) : $(all_resources) $(full_android_manifest) $(AAPT) $(framework_res_package_export_deps)
153	@echo "target R.java/Manifest.java: $(PRIVATE_MODULE) ($@)"
154	$(create-resource-java-files)
155	$(hide) find $(PRIVATE_SOURCE_INTERMEDIATES_DIR) -name R.java | xargs cat > $@
156endif  # USE_AAPT2
157
158$(LOCAL_BUILT_MODULE): $(R_file_stamp)
159ifdef LOCAL_JACK_ENABLED
160$(noshrob_classes_jack): $(R_file_stamp)
161$(full_classes_jack): $(R_file_stamp)
162endif # LOCAL_JACK_ENABLED
163$(full_classes_compiled_jar): $(R_file_stamp)
164
165# Rule to build AAR, archive including classes.jar, resource, etc.
166built_aar := $(intermediates.COMMON)/javalib.aar
167$(built_aar): PRIVATE_MODULE := $(LOCAL_MODULE)
168$(built_aar): PRIVATE_ANDROID_MANIFEST := $(full_android_manifest)
169$(built_aar): PRIVATE_CLASSES_JAR := $(LOCAL_BUILT_MODULE)
170$(built_aar): PRIVATE_RESOURCE_DIR := $(LOCAL_RESOURCE_DIR)
171$(built_aar): PRIVATE_R_TXT := $(LOCAL_INTERMEDIATE_SOURCE_DIR)/R.txt
172$(built_aar) : $(LOCAL_BUILT_MODULE)
173	@echo "target AAR:  $(PRIVATE_MODULE) ($@)"
174	$(hide) rm -rf $(dir $@)aar && mkdir -p $(dir $@)aar/res
175	$(hide) cp $(PRIVATE_ANDROID_MANIFEST) $(dir $@)aar/AndroidManifest.xml
176	$(hide) cp $(PRIVATE_CLASSES_JAR) $(dir $@)aar/classes.jar
177	# Note: Use "cp -n" to honor the resource overlay rules, if multiple res dirs exist.
178	$(hide) $(foreach res,$(PRIVATE_RESOURCE_DIR),cp -Rfn $(res)/* $(dir $@)aar/res;)
179	$(hide) cp $(PRIVATE_R_TXT) $(dir $@)aar/R.txt
180	$(hide) jar -cMf $@ \
181	  -C $(dir $@)aar .
182
183# Register the aar file.
184ALL_MODULES.$(LOCAL_MODULE).AAR := $(built_aar)
185endif  # need_compile_res
186
187ifdef USE_AAPT2
188# If a static Java library has no resources, create empty package apps can depend on.
189$(my_library_resources): PRIVATE_RES_DIR := $(intermediates.COMMON)/flat-res/res
190$(my_library_resources) : $(my_res_package)
191	@echo "Package static library resources $@"
192	@rm -rf $@ && mkdir -p $(dir $@) $(PRIVATE_RES_DIR)
193	$(hide) cd $(dir $(PRIVATE_RES_DIR)) && zip -qrX $(abspath $@) $(notdir $(PRIVATE_RES_DIR))
194
195# Make sure my_library_resources is created when you run mm/mmm.
196$(LOCAL_BUILT_MODULE) : $(my_library_resources)
197endif  # USE_AAPT2
198
199# Reset internal variables.
200all_res_assets :=
201LOCAL_IS_STATIC_JAVA_LIBRARY :=
202