blob: d52b220fc6d0de9da1b7cef03df109430b4d07e4 [file] [log] [blame]
Bart Searsa8cc0582015-05-07 03:23:20 +00001#
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#
16LOCAL_PATH := $(call my-dir)
17
Colin Crosscf3a0b52017-11-16 00:15:28 -080018# Load framework-specific path mappings used later in the build.
19include $(LOCAL_PATH)/pathmap.mk
Bart Searsa8cc0582015-05-07 03:23:20 +000020
21# Build the master framework library.
22# The framework contains too many method references (>64K) for poor old DEX.
23# So we first build the framework as a monolithic static library then split it
24# up into smaller pieces.
25# ============================================================
26
27# embedded builds use nothing in frameworks/base
28ifneq ($(ANDROID_BUILD_EMBEDDED),true)
29
Bart Searsa8cc0582015-05-07 03:23:20 +000030# Copy AIDL files to be preprocessed and included in the SDK,
31# specified relative to the root of the build tree.
32# ============================================================
33include $(CLEAR_VARS)
34
Colin Cross77ebd082017-12-15 17:30:33 -080035aidl_parcelables :=
36define stubs-to-aidl-parcelables
37 gen := $(TARGET_OUT_COMMON_INTERMEDIATES)/$1.aidl
38 aidl_parcelables += $$(gen)
Colin Crossfdbe7d12018-02-09 11:24:14 -080039 $$(gen): $(call java-lib-header-files,$1) $(HOST_OUT_EXECUTABLES)/sdkparcelables
Colin Cross77ebd082017-12-15 17:30:33 -080040 @echo Extract SDK parcelables: $$@
41 rm -f $$@
42 $(HOST_OUT_EXECUTABLES)/sdkparcelables $$< $$@
43endef
44
45$(foreach stubs,android_stubs_current android_test_stubs_current android_system_stubs_current,\
46 $(eval $(call stubs-to-aidl-parcelables,$(stubs))))
47
Bart Searsa8cc0582015-05-07 03:23:20 +000048gen := $(TARGET_OUT_COMMON_INTERMEDIATES)/framework.aidl
Colin Cross77ebd082017-12-15 17:30:33 -080049.KATI_RESTAT: $(gen)
50$(gen): $(aidl_parcelables)
51 @echo Combining SDK parcelables: $@
52 rm -f $@.tmp
53 cat $^ | sort -u > $@.tmp
54 $(call commit-change-for-toc,$@)
Bart Searsa8cc0582015-05-07 03:23:20 +000055
56# the documentation
57# ============================================================
58
59# TODO: deal with com/google/android/googleapps
60packages_to_document := \
Colin Crosscf3a0b52017-11-16 00:15:28 -080061 android \
62 javax/microedition/khronos \
63 org/apache/http/conn \
64 org/apache/http/params \
Bart Searsa8cc0582015-05-07 03:23:20 +000065
66# include definition of libcore_to_document
67include libcore/Docs.mk
68
Bart Searsa8cc0582015-05-07 03:23:20 +000069non_base_dirs := \
Colin Crosscf3a0b52017-11-16 00:15:28 -080070 ../opt/telephony/src/java/android/telephony \
71 ../opt/telephony/src/java/android/telephony/gsm \
72 ../opt/net/voip/src/java/android/net/rtp \
73 ../opt/net/voip/src/java/android/net/sip \
Bart Searsa8cc0582015-05-07 03:23:20 +000074
Colin Crosscf3a0b52017-11-16 00:15:28 -080075# Find all files in specific directories (relative to frameworks/base)
76# to document and check apis
77files_to_check_apis := \
78 $(call find-other-java-files, \
Colin Crosscf3a0b52017-11-16 00:15:28 -080079 $(non_base_dirs) \
80 )
Bart Searsa8cc0582015-05-07 03:23:20 +000081
Colin Crosscf3a0b52017-11-16 00:15:28 -080082# Find all files in specific packages that were used to compile
83# framework.jar to document and check apis
84files_to_check_apis += \
85 $(addprefix ../../,\
86 $(filter \
87 $(foreach dir,$(FRAMEWORKS_BASE_JAVA_SRC_DIRS),\
88 $(foreach package,$(packages_to_document),\
89 $(dir)/$(package)/%.java)),\
90 $(SOONG_FRAMEWORK_SRCS)))
91
92# Find all generated files that were used to compile framework.jar
Colin Crossbd200ce2017-12-04 13:45:19 -080093files_to_check_apis_generated := \
94 $(filter $(OUT_DIR)/%,\
95 $(SOONG_FRAMEWORK_SRCS))
George Mountf6be9932015-12-03 07:39:55 -080096
Bart Searsa8cc0582015-05-07 03:23:20 +000097# These are relative to frameworks/base
98# FRAMEWORKS_BASE_SUBDIRS comes from build/core/pathmap.mk
Colin Crosscf3a0b52017-11-16 00:15:28 -080099files_to_document := \
100 $(files_to_check_apis) \
101 $(call find-other-java-files,\
Paul Duffin187a48d2017-12-13 14:34:31 +0000102 test-base/src \
Paul Duffin9f6282d2017-12-15 15:49:08 +0000103 test-mock/src \
Colin Crosscf3a0b52017-11-16 00:15:28 -0800104 test-runner/src)
George Mountf6be9932015-12-03 07:39:55 -0800105
Bart Searsa8cc0582015-05-07 03:23:20 +0000106# These are relative to frameworks/base
107html_dirs := \
108 $(FRAMEWORKS_BASE_SUBDIRS) \
Colin Crosscf3a0b52017-11-16 00:15:28 -0800109 $(non_base_dirs) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000110
111# Common sources for doc check and api check
112common_src_files := \
113 $(call find-other-html-files, $(html_dirs)) \
Colin Crosscf3a0b52017-11-16 00:15:28 -0800114 $(addprefix ../../, $(libcore_to_document)) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000115
116# These are relative to frameworks/base
117framework_docs_LOCAL_SRC_FILES := \
Colin Crosscf3a0b52017-11-16 00:15:28 -0800118 $(files_to_document) \
119 $(common_src_files) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000120
121# These are relative to frameworks/base
122framework_docs_LOCAL_API_CHECK_SRC_FILES := \
Colin Crosscf3a0b52017-11-16 00:15:28 -0800123 $(files_to_check_apis) \
124 $(common_src_files) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000125
126# This is used by ide.mk as the list of source files that are
127# always included.
128INTERNAL_SDK_SOURCE_DIRS := $(addprefix $(LOCAL_PATH)/,$(dirs_to_document))
129
130framework_docs_LOCAL_DROIDDOC_SOURCE_PATH := \
131 $(FRAMEWORKS_BASE_JAVA_SRC_DIRS)
132
Colin Crosscf3a0b52017-11-16 00:15:28 -0800133framework_docs_LOCAL_SRCJARS := $(SOONG_FRAMEWORK_SRCJARS)
134
Colin Crossbd200ce2017-12-04 13:45:19 -0800135framework_docs_LOCAL_GENERATED_SOURCES := \
136 $(libcore_to_document_generated) \
137 $(files_to_check_apis_generated) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000138
139framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES := \
Piotr Jastrzebskicfa292e2015-02-17 16:58:52 +0000140 core-oj \
Bart Searsa8cc0582015-05-07 03:23:20 +0000141 core-libart \
142 conscrypt \
143 bouncycastle \
144 okhttp \
145 ext \
146 framework \
Paul Duffinc08090f2017-06-29 14:58:43 +0100147 voip-common \
Bart Searsa8cc0582015-05-07 03:23:20 +0000148
Alan Viverette9ca513e2017-04-05 10:21:58 -0400149# Platform docs can refer to Support Library APIs, but we don't actually build
150# them as part of the docs target, so we need to include them on the classpath.
Bart Searsa8cc0582015-05-07 03:23:20 +0000151framework_docs_LOCAL_JAVA_LIBRARIES := \
152 $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) \
153 $(FRAMEWORKS_SUPPORT_JAVA_LIBRARIES)
154
155framework_docs_LOCAL_MODULE_CLASS := JAVA_LIBRARIES
156framework_docs_LOCAL_DROIDDOC_HTML_DIR := docs/html
157# The since flag (-since N.xml API_LEVEL) is used to add API Level information
158# to the reference documentation. Must be in order of oldest to newest.
159#
160# Conscrypt (com.android.org.conscrypt) is an implementation detail and should
161# not be referenced in the documentation.
162framework_docs_LOCAL_DROIDDOC_OPTIONS := \
Jeff Sharkey0f3f60b2017-04-24 18:06:20 -0600163 -android \
Bart Searsa8cc0582015-05-07 03:23:20 +0000164 -knowntags ./frameworks/base/docs/knowntags.txt \
Narayan Kamath2c4f2842015-07-27 14:02:11 +0100165 -knowntags ./libcore/known_oj_tags.txt \
Jeff Sharkeybfc4fcd2017-06-05 17:38:17 -0600166 -manifest ./frameworks/base/core/res/AndroidManifest.xml \
Tobias Thiererdda16e82018-03-05 22:55:32 +0000167 -hidePackage com.android.internal \
168 -hidePackage com.android.internal.util \
Neil Fuller57157fb2017-11-24 15:58:38 +0000169 -hidePackage com.android.okhttp \
Bart Searsa8cc0582015-05-07 03:23:20 +0000170 -hidePackage com.android.org.conscrypt \
Neil Fuller371c08c2017-11-27 10:32:07 +0000171 -hidePackage com.android.server \
Bart Searsa8cc0582015-05-07 03:23:20 +0000172 -since $(SRC_API_DIR)/1.xml 1 \
173 -since $(SRC_API_DIR)/2.xml 2 \
174 -since $(SRC_API_DIR)/3.xml 3 \
175 -since $(SRC_API_DIR)/4.xml 4 \
176 -since $(SRC_API_DIR)/5.xml 5 \
177 -since $(SRC_API_DIR)/6.xml 6 \
178 -since $(SRC_API_DIR)/7.xml 7 \
179 -since $(SRC_API_DIR)/8.xml 8 \
180 -since $(SRC_API_DIR)/9.xml 9 \
181 -since $(SRC_API_DIR)/10.xml 10 \
182 -since $(SRC_API_DIR)/11.xml 11 \
183 -since $(SRC_API_DIR)/12.xml 12 \
184 -since $(SRC_API_DIR)/13.xml 13 \
185 -since $(SRC_API_DIR)/14.txt 14 \
186 -since $(SRC_API_DIR)/15.txt 15 \
187 -since $(SRC_API_DIR)/16.txt 16 \
188 -since $(SRC_API_DIR)/17.txt 17 \
189 -since $(SRC_API_DIR)/18.txt 18 \
190 -since $(SRC_API_DIR)/19.txt 19 \
191 -since $(SRC_API_DIR)/20.txt 20 \
192 -since $(SRC_API_DIR)/21.txt 21 \
193 -since $(SRC_API_DIR)/22.txt 22 \
Joe Fernandez1827e322015-08-12 19:45:22 -0700194 -since $(SRC_API_DIR)/23.txt 23 \
Dirk Dougherty5f60f7c2016-06-14 16:26:28 -0700195 -since $(SRC_API_DIR)/24.txt 24 \
Dirk Dougherty3376f582016-10-14 10:27:08 -0700196 -since $(SRC_API_DIR)/25.txt 25 \
Dirk Doughertyfdad0ba2017-06-09 14:43:32 -0700197 -since $(SRC_API_DIR)/26.txt 26 \
Andrew Solovaya6019b22017-10-06 14:27:20 -0700198 -since $(SRC_API_DIR)/27.txt 27 \
Anton Hansson092d9b82018-04-19 14:04:32 +0100199 -since $(SRC_API_DIR)/28.txt 28 \
Jeff Sharkeyc204c222017-11-27 15:02:10 -0700200 -werror -lerror -hide 111 -hide 113 -hide 125 -hide 126 -hide 127 -hide 128 \
Jeff Sharkey0f3f60b2017-04-24 18:06:20 -0600201 -overview $(LOCAL_PATH)/core/java/overview.html \
Bart Searsa8cc0582015-05-07 03:23:20 +0000202
203framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR:= \
204 $(call intermediates-dir-for,JAVA_LIBRARIES,framework,,COMMON)
205
206framework_docs_LOCAL_ADDITIONAL_JAVA_DIR:= \
Alan Viverette9ca513e2017-04-05 10:21:58 -0400207 $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
Bart Searsa8cc0582015-05-07 03:23:20 +0000208
209framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES := \
Narayan Kamathc21739a2015-07-14 13:39:23 +0100210 frameworks/base/docs/knowntags.txt \
Colin Cross72d359f2017-10-27 10:46:53 -0700211 $(libcore_to_document_generated)
Bart Searsa8cc0582015-05-07 03:23:20 +0000212
213samples_dir := development/samples/browseable
214
215# Whitelist of valid groups, used for default TOC grouping. Each sample must
216# belong to one (and only one) group. Assign samples to groups by setting
217# a sample.group var to one of these groups in the sample's _index.jd.
218sample_groups := -samplegroup Admin \
219 -samplegroup Background \
220 -samplegroup Connectivity \
221 -samplegroup Content \
222 -samplegroup Input \
223 -samplegroup Media \
224 -samplegroup Notification \
225 -samplegroup RenderScript \
226 -samplegroup Security \
227 -samplegroup Sensors \
Trevor Johns4cbe3592015-05-27 14:50:51 -0700228 -samplegroup System \
Bart Searsa8cc0582015-05-07 03:23:20 +0000229 -samplegroup Testing \
230 -samplegroup UI \
231 -samplegroup Views \
232 -samplegroup Wearable
233
234## SDK version identifiers used in the published docs
235 # major[.minor] version for current SDK. (full releases only)
smain@google.comdde8deb2016-08-29 18:36:50 -0700236framework_docs_SDK_VERSION:=7.0
Bart Searsa8cc0582015-05-07 03:23:20 +0000237 # release version (ie "Release x") (full releases only)
238framework_docs_SDK_REL_ID:=1
239
240framework_docs_LOCAL_DROIDDOC_OPTIONS += \
Billy Lamberta75dbc8f2017-03-03 13:09:15 -0800241 -hdf dac true \
Scott Mainf8cdfc82017-03-21 13:43:31 -0700242 -hdf sdk.codename O \
243 -hdf sdk.preview.version 1 \
Bart Searsa8cc0582015-05-07 03:23:20 +0000244 -hdf sdk.version $(framework_docs_SDK_VERSION) \
245 -hdf sdk.rel.id $(framework_docs_SDK_REL_ID) \
Scott Mainf8cdfc82017-03-21 13:43:31 -0700246 -hdf sdk.preview 0 \
247 -resourcesdir $(LOCAL_PATH)/docs/html/reference/images/ \
248 -resourcesoutdir reference/android/images/
Bart Searsa8cc0582015-05-07 03:23:20 +0000249
Alan Viverette9ca513e2017-04-05 10:21:58 -0400250# Federate Support Library references against local API file.
251framework_docs_LOCAL_DROIDDOC_OPTIONS += \
252 -federate SupportLib https://developer.android.com \
253 -federationapi SupportLib prebuilts/sdk/current/support-api.txt
254
Alan Viverette67b51d42018-03-28 17:10:20 -0400255# Federate AndroidX references against local API file.
256framework_docs_LOCAL_DROIDDOC_OPTIONS += \
257 -federate AndroidX https://developer.android.com \
258 -federationapi AndroidX prebuilts/sdk/current/androidx-api.txt
259
Nan Zhangbd9eda52018-06-05 19:01:32 -0700260framework_metalava_docs_LOCAL_DROIDDOC_OPTIONS := \
261 --manifest ./frameworks/base/core/res/AndroidManifest.xml \
262 --hide-package com.android.okhttp \
263 --hide-package com.android.org.conscrypt --hide-package com.android.server \
264 --hide RequiresPermission \
265 --hide MissingPermission --hide BroadcastBehavior \
266 --hide HiddenSuperclass --hide DeprecationMismatch --hide UnavailableSymbol \
267 --hide SdkConstant --hide HiddenTypeParameter --hide Todo --hide Typo
268
Jeff Sharkeyd2bf31c2017-11-29 13:14:27 -0700269# ==== Public API diff ===========================
Alan Viverette6b7354c2017-07-13 17:10:14 -0400270include $(CLEAR_VARS)
271
272LOCAL_SRC_FILES := $(framework_docs_LOCAL_API_CHECK_SRC_FILES)
Colin Crossbd200ce2017-12-04 13:45:19 -0800273LOCAL_GENERATED_SOURCES := $(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Crosscf3a0b52017-11-16 00:15:28 -0800274LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Alan Viverette6b7354c2017-07-13 17:10:14 -0400275LOCAL_JAVA_LIBRARIES := $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
276LOCAL_MODULE_CLASS := $(framework_docs_LOCAL_MODULE_CLASS)
277LOCAL_ADDITIONAL_JAVA_DIR := $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
278LOCAL_ADDITIONAL_DEPENDENCIES := \
279 $(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) \
280 $(INTERNAL_PLATFORM_API_FILE)
281
282LOCAL_MODULE := offline-sdk-referenceonly
283
284last_released_sdk_version := $(lastword $(call numerically_sort, \
285 $(filter-out current, \
286 $(patsubst $(SRC_API_DIR)/%.txt,%, $(wildcard $(SRC_API_DIR)/*.txt)) \
287 )\
288 ))
289
290LOCAL_APIDIFF_OLDAPI := $(LOCAL_PATH)/../../$(SRC_API_DIR)/$(last_released_sdk_version)
291LOCAL_APIDIFF_NEWAPI := $(LOCAL_PATH)/../../$(basename $(INTERNAL_PLATFORM_API_FILE))
292
293include $(BUILD_APIDIFF)
294
Jeff Sharkeyc8dc2542017-12-08 14:52:37 -0700295# Hack to get diffs included in docs output
296out_zip := $(OUT_DOCS)/$(LOCAL_MODULE)-docs.zip
297$(out_zip): $(full_target)
298
Jeff Sharkeyd2bf31c2017-11-29 13:14:27 -0700299# ==== System API diff ===========================
300include $(CLEAR_VARS)
301
302LOCAL_SRC_FILES := $(framework_docs_LOCAL_API_CHECK_SRC_FILES)
Colin Crossbd200ce2017-12-04 13:45:19 -0800303LOCAL_GENERATED_SOURCES := $(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Crosscf3a0b52017-11-16 00:15:28 -0800304LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Jeff Sharkeyd2bf31c2017-11-29 13:14:27 -0700305LOCAL_JAVA_LIBRARIES := $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
306LOCAL_MODULE_CLASS := $(framework_docs_LOCAL_MODULE_CLASS)
307LOCAL_ADDITIONAL_JAVA_DIR := $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
308LOCAL_ADDITIONAL_DEPENDENCIES := \
309 $(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) \
310 $(INTERNAL_PLATFORM_SYSTEM_API_FILE)
311
312LOCAL_MODULE := offline-system-sdk-referenceonly
313
314last_released_sdk_version := $(lastword $(call numerically_sort, \
315 $(filter-out current, \
316 $(patsubst $(SRC_SYSTEM_API_DIR)/%.txt,%, $(wildcard $(SRC_SYSTEM_API_DIR)/*.txt)) \
317 )\
318 ))
319
320LOCAL_APIDIFF_OLDAPI := $(LOCAL_PATH)/../../$(SRC_SYSTEM_API_DIR)/$(last_released_sdk_version)
321LOCAL_APIDIFF_NEWAPI := $(LOCAL_PATH)/../../$(basename $(INTERNAL_PLATFORM_SYSTEM_API_FILE))
322
323include $(BUILD_APIDIFF)
324
Jeff Sharkeyc8dc2542017-12-08 14:52:37 -0700325# Hack to get diffs included in docs output
326out_zip := $(OUT_DOCS)/$(LOCAL_MODULE)-docs.zip
327$(out_zip): $(full_target)
328
Bart Searsa8cc0582015-05-07 03:23:20 +0000329# ==== the api stubs and current.xml ===========================
330include $(CLEAR_VARS)
331
332LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
Colin Crossbd200ce2017-12-04 13:45:19 -0800333LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Crosscf3a0b52017-11-16 00:15:28 -0800334LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000335LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
336LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
337LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
338LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
339LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
340LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
341
342LOCAL_MODULE := api-stubs
343
Ying Wang0f92a2e2015-07-16 14:20:22 -0700344LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_stubs_current_intermediates/src
345
Bart Searsa8cc0582015-05-07 03:23:20 +0000346LOCAL_DROIDDOC_OPTIONS:=\
347 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700348 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000349 -api $(INTERNAL_PLATFORM_API_FILE) \
350 -removedApi $(INTERNAL_PLATFORM_REMOVED_API_FILE) \
351 -nodocs
352
Scott Main15b85172017-02-21 14:30:58 -0800353LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000354
355LOCAL_UNINSTALLABLE_MODULE := true
356
357include $(BUILD_DROIDDOC)
358
David Brazdila793f3f2018-01-16 15:03:20 +0000359$(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_API_FILE) \
David Brazdil68e1c1d2018-03-08 14:32:27 +0000360 $(INTERNAL_PLATFORM_REMOVED_API_FILE)
Bart Searsa8cc0582015-05-07 03:23:20 +0000361$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_API_FILE))
362
Nan Zhangbd9eda52018-06-05 19:01:32 -0700363# ==== the metalava api stubs and current.xml ===========================
364include $(CLEAR_VARS)
365
366LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
367LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
368LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
369LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
370LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
371LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
372LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
373LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
374
375LOCAL_MODULE := metalava-api-stubs
376LOCAL_DROIDDOC_USE_METALAVA := true
377
378LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/metalava_android_stubs_current_intermediates/src
379
380INTERNAL_PLATFORM_METALAVA_PUBLIC_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava_public_api.txt
381INTERNAL_PLATFORM_METALAVA_PUBLIC_REMOVED_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava_removed.txt
382
383LOCAL_DROIDDOC_OPTIONS:=\
384 $(framework_metalava_docs_LOCAL_DROIDDOC_OPTIONS) \
385 --api $(INTERNAL_PLATFORM_METALAVA_PUBLIC_API_FILE) \
386 --removed-api $(INTERNAL_PLATFORM_METALAVA_PUBLIC_REMOVED_API_FILE) \
387 -nodocs
388
389LOCAL_UNINSTALLABLE_MODULE := true
390
391include $(BUILD_DROIDDOC)
392
393$(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_METALAVA_PUBLIC_API_FILE) \
394 $(INTERNAL_PLATFORM_METALAVA_PUBLIC_REMOVED_API_FILE)
395$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_METALAVA_PUBLIC_API_FILE))
396
Bart Searsa8cc0582015-05-07 03:23:20 +0000397# ==== the system api stubs ===================================
398include $(CLEAR_VARS)
399
400LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
Colin Crossbd200ce2017-12-04 13:45:19 -0800401LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Crosscf3a0b52017-11-16 00:15:28 -0800402LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000403LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
404LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
405LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
406LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
407LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
408LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
409
410LOCAL_MODULE := system-api-stubs
411
Ying Wang0f92a2e2015-07-16 14:20:22 -0700412LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_system_stubs_current_intermediates/src
413
Bart Searsa8cc0582015-05-07 03:23:20 +0000414LOCAL_DROIDDOC_OPTIONS:=\
415 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700416 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000417 -showAnnotation android.annotation.SystemApi \
418 -api $(INTERNAL_PLATFORM_SYSTEM_API_FILE) \
419 -removedApi $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE) \
Jeff Sharkey05461c02017-05-09 19:01:09 -0600420 -exactApi $(INTERNAL_PLATFORM_SYSTEM_EXACT_API_FILE) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000421 -nodocs
422
Scott Main15b85172017-02-21 14:30:58 -0800423LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000424
425LOCAL_UNINSTALLABLE_MODULE := true
426
427include $(BUILD_DROIDDOC)
428
David Brazdila793f3f2018-01-16 15:03:20 +0000429$(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_SYSTEM_API_FILE) \
David Brazdil68e1c1d2018-03-08 14:32:27 +0000430 $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE) \
431 $(INTERNAL_PLATFORM_SYSTEM_EXACT_API_FILE)
Bart Searsa8cc0582015-05-07 03:23:20 +0000432$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_SYSTEM_API_FILE))
433
Nan Zhangbd9eda52018-06-05 19:01:32 -0700434# ==== the metalava system api stubs ===================================
435include $(CLEAR_VARS)
436
437LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
438LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
439LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
440LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
441LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
442LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
443LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
444LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
445
446LOCAL_MODULE := metalava-system-api-stubs
447LOCAL_DROIDDOC_USE_METALAVA := true
448
449LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/metalava_android_system_stubs_current_intermediates/src
450
451INTERNAL_PLATFORM_METALAVA_SYSTEM_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava-system-api.txt
452INTERNAL_PLATFORM_METALAVA_SYSTEM_REMOVED_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava-system-removed.txt
453
454LOCAL_DROIDDOC_OPTIONS:=\
455 $(framework_metalava_docs_LOCAL_DROIDDOC_OPTIONS) \
456 --show-annotation android.annotation.SystemApi \
457 --api $(INTERNAL_PLATFORM_METALAVA_SYSTEM_API_FILE) \
458 --removed-api $(INTERNAL_PLATFORM_METALAVA_SYSTEM_REMOVED_API_FILE) \
459 -nodocs
460
461LOCAL_UNINSTALLABLE_MODULE := true
462
463include $(BUILD_DROIDDOC)
464
465$(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_METALAVA_SYSTEM_API_FILE) \
466 $(INTERNAL_PLATFORM_METALAVA_SYSTEM_REMOVED_API_FILE) \
467$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_METALAVA_SYSTEM_API_FILE))
468
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000469# ==== the test api stubs ===================================
470include $(CLEAR_VARS)
471
472LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
Colin Crossbd200ce2017-12-04 13:45:19 -0800473LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Crosscf3a0b52017-11-16 00:15:28 -0800474LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000475LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
476LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
477LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
478LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
479LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
480LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
481
482LOCAL_MODULE := test-api-stubs
483
484LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src
485
486LOCAL_DROIDDOC_OPTIONS:=\
487 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700488 -referenceonly \
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000489 -stubs $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src \
490 -showAnnotation android.annotation.TestApi \
491 -api $(INTERNAL_PLATFORM_TEST_API_FILE) \
492 -removedApi $(INTERNAL_PLATFORM_TEST_REMOVED_API_FILE) \
Jeff Sharkey05461c02017-05-09 19:01:09 -0600493 -exactApi $(INTERNAL_PLATFORM_TEST_EXACT_API_FILE) \
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000494 -nodocs
495
Scott Main15b85172017-02-21 14:30:58 -0800496LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000497
498LOCAL_UNINSTALLABLE_MODULE := true
499
500include $(BUILD_DROIDDOC)
501
David Brazdil68e1c1d2018-03-08 14:32:27 +0000502$(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_TEST_API_FILE) \
503 $(INTERNAL_PLATFORM_TEST_REMOVED_API_FILE) \
504 $(INTERNAL_PLATFORM_TEST_EXACT_API_FILE)
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000505$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_TEST_API_FILE))
506
Nan Zhangbd9eda52018-06-05 19:01:32 -0700507# ==== the metalava test api stubs ===================================
508include $(CLEAR_VARS)
509
510LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
511LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
512LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
513LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
514LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
515LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
516LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
517LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
518
519LOCAL_MODULE := metalava-test-api-stubs
520LOCAL_DROIDDOC_USE_METALAVA := true
521
522LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/metalava_android_test_stubs_current_intermediates/src
523
524INTERNAL_PLATFORM_METALAVA_TEST_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava-test-api.txt
525INTERNAL_PLATFORM_METALAVA_TEST_REMOVED_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava-test-removed.txt
526
527LOCAL_DROIDDOC_OPTIONS:=\
528 $(framework_metalava_docs_LOCAL_DROIDDOC_OPTIONS) \
529 --show-annotation android.annotation.TestApi \
530 --api $(INTERNAL_PLATFORM_METALAVA_TEST_API_FILE) \
531 --removed-api $(INTERNAL_PLATFORM_METALAVA_TEST_REMOVED_API_FILE) \
532 -nodocs
533
534LOCAL_UNINSTALLABLE_MODULE := true
535
536include $(BUILD_DROIDDOC)
537
538$(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_METALAVA_TEST_API_FILE) \
539 $(INTERNAL_PLATFORM_METALAVA_TEST_REMOVED_API_FILE) \
540$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_METALAVA_TEST_API_FILE))
541
David Brazdil68e1c1d2018-03-08 14:32:27 +0000542# ==== the complete hidden api list ===================================
543include $(CLEAR_VARS)
544
545LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
546LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
547LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
548LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
549LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
550LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
551LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
552LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
553LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
554
555LOCAL_MODULE := hidden-api-list
556
557LOCAL_DROIDDOC_OPTIONS:=\
558 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
559 -referenceonly \
560 -showUnannotated \
561 -showAnnotation android.annotation.SystemApi \
562 -showAnnotation android.annotation.TestApi \
David Brazdil94c2ab62018-05-30 13:59:11 +0100563 -dexApi $(INTERNAL_PLATFORM_DEX_API_FILE) \
David Brazdil68e1c1d2018-03-08 14:32:27 +0000564 -privateDexApi $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) \
David Brazdil0f0abb22018-04-26 16:10:35 +0100565 -removedDexApi $(INTERNAL_PLATFORM_REMOVED_DEX_API_FILE) \
David Brazdil68e1c1d2018-03-08 14:32:27 +0000566 -nodocs
567
568LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
569
570LOCAL_UNINSTALLABLE_MODULE := true
571
572include $(BUILD_DROIDDOC)
573
David Brazdil94c2ab62018-05-30 13:59:11 +0100574$(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_DEX_API_FILE) \
575 $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) \
David Brazdil0f0abb22018-04-26 16:10:35 +0100576 $(INTERNAL_PLATFORM_REMOVED_DEX_API_FILE)
David Brazdil68e1c1d2018-03-08 14:32:27 +0000577
Bart Searsa8cc0582015-05-07 03:23:20 +0000578# ==== check javadoc comments but don't generate docs ========
579include $(CLEAR_VARS)
580
581LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Crossbd200ce2017-12-04 13:45:19 -0800582LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Crosscf3a0b52017-11-16 00:15:28 -0800583LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000584LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
585LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
586LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
587LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
588LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
589LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
590
591LOCAL_MODULE := doc-comment-check
592
593LOCAL_DROIDDOC_OPTIONS:=\
594 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700595 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000596 -parsecomments
597
Scott Main15b85172017-02-21 14:30:58 -0800598LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000599
600LOCAL_UNINSTALLABLE_MODULE := true
601
602include $(BUILD_DROIDDOC)
603
Bart Searsa8cc0582015-05-07 03:23:20 +0000604# Run this for checkbuild
605checkbuild: doc-comment-check-docs
606# Check comment when you are updating the API
607update-api: doc-comment-check-docs
608
609# ==== static html in the sdk ==================================
610include $(CLEAR_VARS)
611
612LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Crossbd200ce2017-12-04 13:45:19 -0800613LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Crosscf3a0b52017-11-16 00:15:28 -0800614LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000615LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
616LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
617LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
618LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
619LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
620LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
621
622LOCAL_MODULE := offline-sdk
623
624LOCAL_DROIDDOC_OPTIONS:=\
625 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
626 -offlinemode \
627 -title "Android SDK" \
628 -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \
smain@google.com00de8c52016-03-07 18:38:08 -0800629 -sdkvalues $(OUT_DOCS) \
smain@google.com8562ab52016-06-14 17:11:57 -0700630 -hdf android.whichdoc offline
631
Scott Main15b85172017-02-21 14:30:58 -0800632LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
smain@google.com8562ab52016-06-14 17:11:57 -0700633
634include $(BUILD_DROIDDOC)
635
636static_doc_index_redirect := $(out_dir)/index.html
637$(static_doc_index_redirect): \
638 $(LOCAL_PATH)/docs/docs-preview-index.html | $(ACP)
639 $(hide) mkdir -p $(dir $@)
640 $(hide) $(ACP) $< $@
641
642$(full_target): $(static_doc_index_redirect)
smain@google.com8562ab52016-06-14 17:11:57 -0700643
644
Jeff Sharkeyd2bf31c2017-11-29 13:14:27 -0700645# ==== Public API static reference docs ==================================
smain@google.com8562ab52016-06-14 17:11:57 -0700646include $(CLEAR_VARS)
647
648LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Crossbd200ce2017-12-04 13:45:19 -0800649LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Crosscf3a0b52017-11-16 00:15:28 -0800650LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
smain@google.com8562ab52016-06-14 17:11:57 -0700651LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
652LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
653LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
654LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
655LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
656LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
657
658LOCAL_MODULE := offline-sdk-referenceonly
659
660LOCAL_DROIDDOC_OPTIONS:=\
661 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
662 -offlinemode \
663 -title "Android SDK" \
664 -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \
665 -sdkvalues $(OUT_DOCS) \
smain@google.com00de8c52016-03-07 18:38:08 -0800666 -hdf android.whichdoc offline \
Scott Mainf8cdfc82017-03-21 13:43:31 -0700667 -referenceonly
smain@google.com00de8c52016-03-07 18:38:08 -0800668
Scott Main15b85172017-02-21 14:30:58 -0800669LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
smain@google.com00de8c52016-03-07 18:38:08 -0800670
671include $(BUILD_DROIDDOC)
672
673static_doc_index_redirect := $(out_dir)/index.html
smain@google.com151833a2016-08-31 08:42:09 -0700674$(static_doc_index_redirect): $(LOCAL_PATH)/docs/docs-documentation-redirect.html
Dan Willemsen98ff0b72016-03-23 00:42:44 -0700675 $(copy-file-to-target)
smain@google.com00de8c52016-03-07 18:38:08 -0800676
smain@google.com2f2365d2016-09-21 14:05:50 -0700677static_doc_properties := $(out_dir)/source.properties
678$(static_doc_properties): \
679 $(LOCAL_PATH)/docs/source.properties | $(ACP)
680 $(hide) mkdir -p $(dir $@)
681 $(hide) $(ACP) $< $@
682
smain@google.com00de8c52016-03-07 18:38:08 -0800683$(full_target): $(static_doc_index_redirect)
smain@google.com2f2365d2016-09-21 14:05:50 -0700684$(full_target): $(static_doc_properties)
smain@google.com00de8c52016-03-07 18:38:08 -0800685
smain@google.com7aca8be2016-03-10 14:13:30 -0800686
Jeff Sharkeyd2bf31c2017-11-29 13:14:27 -0700687# ==== System API static reference docs ==================================
688include $(CLEAR_VARS)
689
690LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Crossbd200ce2017-12-04 13:45:19 -0800691LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Crosscf3a0b52017-11-16 00:15:28 -0800692LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Jeff Sharkeyd2bf31c2017-11-29 13:14:27 -0700693LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
694LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
695LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
696LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
697LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
698LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
699
700LOCAL_MODULE := offline-system-sdk-referenceonly
701
702LOCAL_DROIDDOC_OPTIONS:=\
703 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
704 -hide 101 -hide 104 -hide 108 \
705 -showAnnotation android.annotation.SystemApi \
706 -offlinemode \
707 -title "Android System SDK" \
708 -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \
709 -sdkvalues $(OUT_DOCS) \
710 -hdf android.whichdoc offline \
711 -referenceonly
712
713LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
714
715include $(BUILD_DROIDDOC)
716
717static_doc_index_redirect := $(out_dir)/index.html
718$(static_doc_index_redirect): $(LOCAL_PATH)/docs/docs-documentation-redirect.html
719 $(copy-file-to-target)
720
721static_doc_properties := $(out_dir)/source.properties
722$(static_doc_properties): \
723 $(LOCAL_PATH)/docs/source.properties | $(ACP)
724 $(hide) mkdir -p $(dir $@)
725 $(hide) $(ACP) $< $@
726
727$(full_target): $(static_doc_index_redirect)
728$(full_target): $(static_doc_properties)
729$(full_target): $(framework_built)
730
731
Bart Searsa8cc0582015-05-07 03:23:20 +0000732# ==== docs for the web (on the androiddevdocs app engine server) =======================
733include $(CLEAR_VARS)
734
735LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Crossbd200ce2017-12-04 13:45:19 -0800736LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Crosscf3a0b52017-11-16 00:15:28 -0800737LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000738LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
739LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
740LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
741LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
742LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
743LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
744LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
745LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
746
747LOCAL_MODULE := online-sdk
748
749LOCAL_DROIDDOC_OPTIONS:= \
750 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
751 -toroot / \
752 -hdf android.whichdoc online \
753 $(sample_groups) \
754 -hdf android.hasSamples true \
755 -samplesdir $(samples_dir)
756
Scott Main15b85172017-02-21 14:30:58 -0800757LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000758
759include $(BUILD_DROIDDOC)
760
761# ==== docs for the web (on the androiddevdocs app engine server) =======================
Bart Searsa8cc0582015-05-07 03:23:20 +0000762include $(CLEAR_VARS)
763
764LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Crossbd200ce2017-12-04 13:45:19 -0800765LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Crosscf3a0b52017-11-16 00:15:28 -0800766LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000767LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
768LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
769LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
770LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
771LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
772LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
773LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
774LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
775
776LOCAL_MODULE := online-system-api-sdk
777
778LOCAL_DROIDDOC_OPTIONS:= \
779 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700780 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000781 -showAnnotation android.annotation.SystemApi \
782 -title "Android SDK - Including system APIs." \
783 -toroot / \
Gina Dimino98ad8882016-05-31 17:25:48 -0700784 -hide 101 \
785 -hide 104 \
786 -hide 108 \
Bart Searsa8cc0582015-05-07 03:23:20 +0000787 -hdf android.whichdoc online \
788 $(sample_groups) \
789 -hdf android.hasSamples true \
790 -samplesdir $(samples_dir)
791
Scott Main15b85172017-02-21 14:30:58 -0800792LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Jeff Sharkey05461c02017-05-09 19:01:09 -0600793
Bart Searsa8cc0582015-05-07 03:23:20 +0000794LOCAL_UNINSTALLABLE_MODULE := true
795
796include $(BUILD_DROIDDOC)
Bart Searsa8cc0582015-05-07 03:23:20 +0000797
798# ==== docs for the web (on the devsite app engine server) =======================
799include $(CLEAR_VARS)
800LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Crossbd200ce2017-12-04 13:45:19 -0800801LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Crosscf3a0b52017-11-16 00:15:28 -0800802LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000803LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
804LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
805LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
806LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
807LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
808LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
809LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
810# specify a second html input dir and an output path relative to OUT_DIR)
Dirk Dougherty3852c1f2016-04-10 02:05:09 -0700811LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
Bart Searsa8cc0582015-05-07 03:23:20 +0000812
813LOCAL_MODULE := ds
814
815LOCAL_DROIDDOC_OPTIONS:= \
816 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000817 -toroot / \
818 -hdf android.whichdoc online \
Dirk Doughertyb042ab12016-06-14 16:26:28 -0700819 -devsite \
Scott Main4f9b48c2017-12-19 13:43:45 -0800820 -yamlV2 \
Dirk Dougherty3852c1f2016-04-10 02:05:09 -0700821 $(sample_groups) \
Dirk Dougherty3852c1f2016-04-10 02:05:09 -0700822 -hdf android.hasSamples true \
823 -samplesdir $(samples_dir)
Bart Searsa8cc0582015-05-07 03:23:20 +0000824
Scott Main15b85172017-02-21 14:30:58 -0800825LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000826
827include $(BUILD_DROIDDOC)
828
Dirk Doughertyb042ab12016-06-14 16:26:28 -0700829# ==== docs for the web (on the devsite app engine server) =======================
830include $(CLEAR_VARS)
831LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Crossbd200ce2017-12-04 13:45:19 -0800832LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Crosscf3a0b52017-11-16 00:15:28 -0800833LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Dirk Doughertyb042ab12016-06-14 16:26:28 -0700834LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
835LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
836LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
837LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
838LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
839LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
840LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
841# specify a second html input dir and an output path relative to OUT_DIR)
842LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
843
844LOCAL_MODULE := ds-static
845
846LOCAL_DROIDDOC_OPTIONS:= \
847 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
848 -hdf android.whichdoc online \
849 -staticonly \
850 -toroot / \
851 -devsite \
852 -ignoreJdLinks
853
Scott Main15b85172017-02-21 14:30:58 -0800854LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Dirk Doughertyb042ab12016-06-14 16:26:28 -0700855
856include $(BUILD_DROIDDOC)
857
Dirk Dougherty7d47b552016-09-13 16:44:25 -0700858# ==== generates full navtree for resolving @links in ds postprocessing ====
859include $(CLEAR_VARS)
860
861LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Crossbd200ce2017-12-04 13:45:19 -0800862LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Crosscf3a0b52017-11-16 00:15:28 -0800863LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Dirk Dougherty7d47b552016-09-13 16:44:25 -0700864LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
865LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
866LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
867LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
868LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
869LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
870
871LOCAL_MODULE := ds-ref-navtree
872
873LOCAL_DROIDDOC_OPTIONS:= \
874 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
875 -hdf android.whichdoc online \
876 -toroot / \
877 -atLinksNavtree \
878 -navtreeonly
879
Scott Main15b85172017-02-21 14:30:58 -0800880LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Dirk Dougherty7d47b552016-09-13 16:44:25 -0700881
882include $(BUILD_DROIDDOC)
883
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800884# ==== site updates for docs (on the androiddevdocs app engine server) =======================
Bart Searsa8cc0582015-05-07 03:23:20 +0000885include $(CLEAR_VARS)
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800886
Bart Searsa8cc0582015-05-07 03:23:20 +0000887LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Crossbd200ce2017-12-04 13:45:19 -0800888LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Crosscf3a0b52017-11-16 00:15:28 -0800889LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000890LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
891LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
892LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
893LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800894LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
Bart Searsa8cc0582015-05-07 03:23:20 +0000895LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
896LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800897LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
Bart Searsa8cc0582015-05-07 03:23:20 +0000898
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800899LOCAL_MODULE := online-sdk-dev
Bart Searsa8cc0582015-05-07 03:23:20 +0000900
901LOCAL_DROIDDOC_OPTIONS:= \
902 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
903 -toroot / \
904 -hdf android.whichdoc online \
905 $(sample_groups) \
906 -hdf android.hasSamples true \
907 -samplesdir $(samples_dir)
908
Scott Main15b85172017-02-21 14:30:58 -0800909LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000910
911include $(BUILD_DROIDDOC)
912
Bart Searsa8cc0582015-05-07 03:23:20 +0000913# ==== docs that have all of the stuff that's @hidden =======================
914include $(CLEAR_VARS)
915
916LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Crossbd200ce2017-12-04 13:45:19 -0800917LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Crosscf3a0b52017-11-16 00:15:28 -0800918LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000919LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
920LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
921LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
922LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
923LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
924LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
925
926LOCAL_MODULE := hidden
927LOCAL_DROIDDOC_OPTIONS:=\
928 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700929 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000930 -title "Android SDK - Including hidden APIs."
931# -hidden
932
Scott Main15b85172017-02-21 14:30:58 -0800933LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000934
935include $(BUILD_DROIDDOC)
936
Joe Onorato1754d742016-11-21 17:51:35 -0800937# ==== java proto host library ==============================
938include $(CLEAR_VARS)
939LOCAL_MODULE := platformprotos
940LOCAL_PROTOC_OPTIMIZE_TYPE := full
941LOCAL_PROTOC_FLAGS := \
942 -Iexternal/protobuf/src
943LOCAL_SOURCE_FILES_ALL_GENERATED := true
944LOCAL_SRC_FILES := \
Mike Mada3a2952017-11-13 12:06:45 -0800945 cmds/am/proto/instrumentation_data.proto \
Primiano Tuccie4d44912018-01-10 12:14:50 +0000946 cmds/statsd/src/perfetto/perfetto_config.proto \
Joe Onorato1754d742016-11-21 17:51:35 -0800947 $(call all-proto-files-under, core/proto) \
Chenjie Yu15176cd2017-11-22 12:36:41 -0800948 $(call all-proto-files-under, libs/incident/proto) \
949 $(call all-proto-files-under, cmds/statsd/src)
Andreas Gampe3e429f32018-02-15 15:12:38 -0800950# b/72714520
951LOCAL_ERROR_PRONE_FLAGS := -Xep:MissingOverride:OFF
Joe Onorato1754d742016-11-21 17:51:35 -0800952include $(BUILD_HOST_JAVA_LIBRARY)
953
Steven Timotius7ece0422017-08-03 13:37:26 -0700954# ==== java proto device library (for test only) ==============================
955include $(CLEAR_VARS)
956LOCAL_MODULE := platformprotosnano
Joe Onorato62c220b2017-11-18 20:32:56 -0800957LOCAL_MODULE_TAGS := tests
Steven Timotius7ece0422017-08-03 13:37:26 -0700958LOCAL_PROTOC_OPTIMIZE_TYPE := nano
959LOCAL_PROTOC_FLAGS := \
960 -Iexternal/protobuf/src
961LOCAL_PROTO_JAVA_OUTPUT_PARAMS := \
962 store_unknown_fields = true
Jiyong Parkf0048392018-02-12 21:57:59 +0900963LOCAL_SDK_VERSION := current
Steven Timotius7ece0422017-08-03 13:37:26 -0700964LOCAL_SRC_FILES := \
Yi Jin437aa6e2018-01-10 11:34:26 -0800965 $(call all-proto-files-under, core/proto) \
966 $(call all-proto-files-under, libs/incident/proto/android/os)
Steven Timotius7ece0422017-08-03 13:37:26 -0700967include $(BUILD_STATIC_JAVA_LIBRARY)
968
Bart Searsa8cc0582015-05-07 03:23:20 +0000969
Joe Onorato62c220b2017-11-18 20:32:56 -0800970# ==== java proto device library (for test only) ==============================
971include $(CLEAR_VARS)
972LOCAL_MODULE := platformprotoslite
973LOCAL_MODULE_TAGS := tests
974LOCAL_PROTOC_OPTIMIZE_TYPE := lite
975LOCAL_PROTOC_FLAGS := \
976 -Iexternal/protobuf/src
977LOCAL_SRC_FILES := \
Yi Jin437aa6e2018-01-10 11:34:26 -0800978 $(call all-proto-files-under, core/proto) \
979 $(call all-proto-files-under, libs/incident/proto/android/os)
Andreas Gampe93b64c92018-01-30 18:50:34 -0800980# Protos have lots of MissingOverride and similar.
981LOCAL_ERROR_PRONE_FLAGS := -XepDisableAllChecks
Joe Onorato62c220b2017-11-18 20:32:56 -0800982include $(BUILD_STATIC_JAVA_LIBRARY)
983
David Brazdil0649c8d2018-01-22 22:23:13 +0000984# ==== hiddenapi lists =======================================
David Brazdil721bc8e2018-05-08 15:04:20 +0100985include $(CLEAR_VARS)
David Brazdil0649c8d2018-01-22 22:23:13 +0000986
David Brazdil721bc8e2018-05-08 15:04:20 +0100987# File names of final API lists
988LOCAL_LIGHT_GREYLIST := $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST)
989LOCAL_DARK_GREYLIST := $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST)
990LOCAL_BLACKLIST := $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST)
991
992# File names of source files we will use to generate the final API lists.
993LOCAL_SRC_GREYLIST := frameworks/base/config/hiddenapi-light-greylist.txt
994LOCAL_SRC_VENDOR_LIST := frameworks/base/config/hiddenapi-vendor-list.txt
David Brazdil4b34f792018-05-08 16:49:02 +0100995LOCAL_SRC_FORCE_BLACKLIST := frameworks/base/config/hiddenapi-force-blacklist.txt
David Brazdil94c2ab62018-05-30 13:59:11 +0100996LOCAL_SRC_PUBLIC_API := $(INTERNAL_PLATFORM_DEX_API_FILE)
David Brazdil721bc8e2018-05-08 15:04:20 +0100997LOCAL_SRC_PRIVATE_API := $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE)
998LOCAL_SRC_REMOVED_API := $(INTERNAL_PLATFORM_REMOVED_DEX_API_FILE)
999
1000LOCAL_SRC_ALL := \
1001 $(LOCAL_SRC_GREYLIST) \
1002 $(LOCAL_SRC_VENDOR_LIST) \
David Brazdil4b34f792018-05-08 16:49:02 +01001003 $(LOCAL_SRC_FORCE_BLACKLIST) \
David Brazdil94c2ab62018-05-30 13:59:11 +01001004 $(LOCAL_SRC_PUBLIC_API) \
David Brazdil721bc8e2018-05-08 15:04:20 +01001005 $(LOCAL_SRC_PRIVATE_API) \
1006 $(LOCAL_SRC_REMOVED_API)
1007
1008define assert-has-no-overlap
1009if [ ! -z "`comm -12 <(sort $(1)) <(sort $(2))`" ]; then \
1010 echo "$(1) and $(2) should not overlap" 1>&2; \
1011 comm -12 <(sort $(1)) <(sort $(2)) 1>&2; \
1012 exit 1; \
1013fi
1014endef
1015
1016define assert-is-subset
1017if [ ! -z "`comm -23 <(sort $(1)) <(sort $(2))`" ]; then \
1018 echo "$(1) must be a subset of $(2)" 1>&2; \
1019 comm -23 <(sort $(1)) <(sort $(2)) 1>&2; \
1020 exit 1; \
1021fi
1022endef
1023
1024define assert-has-no-duplicates
1025if [ ! -z "`sort $(1) | uniq -D`" ]; then \
1026 echo "$(1) has duplicate entries" 1>&2; \
1027 sort $(1) | uniq -D 1>&2; \
1028 exit 1; \
1029fi
1030endef
1031
1032# The following rules build API lists in the build folder.
1033# By not using files from the source tree, ART buildbots can mock these lists
1034# or have alternative rules for building them. Other rules in the build system
1035# should depend on the files in the build folder.
David Brazdilf16ac002018-01-26 11:13:35 +00001036
David Brazdil05855332018-04-25 11:15:07 +01001037# Merge light greylist from multiple files:
David Brazdil721bc8e2018-05-08 15:04:20 +01001038# (1) manual greylist LOCAL_SRC_GREYLIST
1039# (2) list of usages from vendor apps LOCAL_SRC_VENDOR_LIST
1040# (3) list of removed APIs in LOCAL_SRC_REMOVED_API
David Brazdil05855332018-04-25 11:15:07 +01001041# @removed does not imply private in Doclava. We must take the subset also
David Brazdil721bc8e2018-05-08 15:04:20 +01001042# in LOCAL_SRC_PRIVATE_API.
David Brazdil05855332018-04-25 11:15:07 +01001043# (4) list of serialization APIs
1044# Automatically adds all methods which match the signatures in
1045# REGEX_SERIALIZATION. These are greylisted in order to allow applications
1046# to write their own serializers.
David Brazdil721bc8e2018-05-08 15:04:20 +01001047$(LOCAL_LIGHT_GREYLIST): REGEX_SERIALIZATION := \
David Brazdil357170b12018-03-26 16:02:23 +01001048 "readObject\(Ljava/io/ObjectInputStream;\)V" \
1049 "readObjectNoData\(\)V" \
1050 "readResolve\(\)Ljava/lang/Object;" \
1051 "serialVersionUID:J" \
1052 "serialPersistentFields:\[Ljava/io/ObjectStreamField;" \
1053 "writeObject\(Ljava/io/ObjectOutputStream;\)V" \
1054 "writeReplace\(\)Ljava/lang/Object;"
David Brazdil721bc8e2018-05-08 15:04:20 +01001055$(LOCAL_LIGHT_GREYLIST): $(LOCAL_SRC_ALL)
1056 sort $(LOCAL_SRC_GREYLIST) $(LOCAL_SRC_VENDOR_LIST) \
1057 <(grep -E "\->("$(subst $(space),"|",$(REGEX_SERIALIZATION))")$$" \
1058 $(LOCAL_SRC_PRIVATE_API)) \
1059 <(comm -12 <(sort $(LOCAL_SRC_REMOVED_API)) <(sort $(LOCAL_SRC_PRIVATE_API))) \
1060 > $@
1061 $(call assert-has-no-duplicates,$@)
1062 $(call assert-is-subset,$@,$(LOCAL_SRC_PRIVATE_API))
David Brazdil4b34f792018-05-08 16:49:02 +01001063 $(call assert-has-no-overlap,$@,$(LOCAL_SRC_FORCE_BLACKLIST))
David Brazdilf16ac002018-01-26 11:13:35 +00001064
David Brazdil4c3c0312018-05-10 15:50:02 +01001065# Generate dark greylist as remaining classes and class members in the same
1066# package as classes listed in the light greylist.
David Brazdil185f00e2018-05-08 15:28:31 +01001067# The algorithm is as follows:
1068# (1) extract the class descriptor from each entry in LOCAL_LIGHT_GREYLIST
David Brazdil4c3c0312018-05-10 15:50:02 +01001069# (2) strip everything after the last forward-slash,
1070# e.g. 'Lpackage/subpackage/class$inner;' turns into 'Lpackage/subpackage/'
1071# (3) insert all entries from LOCAL_SRC_PRIVATE_API which begin with the package
1072# name but do not contain another forward-slash in the class name, e.g.
1073# matching '^Lpackage/subpackage/[^/;]*;'
David Brazdil185f00e2018-05-08 15:28:31 +01001074# (4) subtract entries shared with LOCAL_LIGHT_GREYLIST
David Brazdil721bc8e2018-05-08 15:04:20 +01001075$(LOCAL_DARK_GREYLIST): $(LOCAL_SRC_ALL) $(LOCAL_LIGHT_GREYLIST)
David Brazdil4b34f792018-05-08 16:49:02 +01001076 comm -13 <(sort $(LOCAL_LIGHT_GREYLIST) $(LOCAL_SRC_FORCE_BLACKLIST)) \
David Brazdil94c2ab62018-05-30 13:59:11 +01001077 <(cat $(LOCAL_SRC_PUBLIC_API) $(LOCAL_LIGHT_GREYLIST) | \
1078 sed 's/\->.*//' | sed 's/\(.*\/\).*/\1/' | sort | uniq | \
David Brazdil4c3c0312018-05-10 15:50:02 +01001079 while read PKG_NAME; do \
1080 grep -E "^$${PKG_NAME}[^/;]*;" $(LOCAL_SRC_PRIVATE_API); \
David Brazdil185f00e2018-05-08 15:28:31 +01001081 done | sort | uniq) \
1082 > $@
David Brazdil721bc8e2018-05-08 15:04:20 +01001083 $(call assert-is-subset,$@,$(LOCAL_SRC_PRIVATE_API))
1084 $(call assert-has-no-duplicates,$@)
1085 $(call assert-has-no-overlap,$@,$(LOCAL_LIGHT_GREYLIST))
David Brazdil4b34f792018-05-08 16:49:02 +01001086 $(call assert-has-no-overlap,$@,$(LOCAL_SRC_FORCE_BLACKLIST))
David Brazdil36bbf122018-03-28 11:28:39 +01001087
David Brazdil721bc8e2018-05-08 15:04:20 +01001088# Generate blacklist as private API minus (light greylist plus dark greylist).
1089$(LOCAL_BLACKLIST): $(LOCAL_SRC_ALL) $(LOCAL_LIGHT_GREYLIST) $(LOCAL_DARK_GREYLIST)
1090 comm -13 <(sort $(LOCAL_LIGHT_GREYLIST) $(LOCAL_DARK_GREYLIST)) \
1091 <(sort $(LOCAL_SRC_PRIVATE_API)) \
1092 > $@
1093 $(call assert-is-subset,$@,$(LOCAL_SRC_PRIVATE_API))
1094 $(call assert-has-no-duplicates,$@)
1095 $(call assert-has-no-overlap,$@,$(LOCAL_LIGHT_GREYLIST))
1096 $(call assert-has-no-overlap,$@,$(LOCAL_DARK_GREYLIST))
David Brazdil4b34f792018-05-08 16:49:02 +01001097 $(call assert-is-subset,$(LOCAL_SRC_FORCE_BLACKLIST),$@)
David Brazdil0649c8d2018-01-22 22:23:13 +00001098
Bart Searsa8cc0582015-05-07 03:23:20 +00001099# Include subdirectory makefiles
1100# ============================================================
1101
1102# If we're building with ONE_SHOT_MAKEFILE (mm, mmm), then what the framework
1103# team really wants is to build the stuff defined by this makefile.
1104ifeq (,$(ONE_SHOT_MAKEFILE))
1105include $(call first-makefiles-under,$(LOCAL_PATH))
1106endif
1107
Holly Jiuyu Sunbbc85802017-12-21 18:44:59 -08001108endif # ANDROID_BUILD_EMBEDDED