blob: ea75b19c7ff8d5c26daf4ba25d8765c7dee3c7f3 [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 Cross5f4dcf62017-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)
39 $$(gen): $(call java-lib-header-files,$1) | $(HOST_OUT_EXECUTABLES)/sdkparcelables
40 @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 Cross5f4dcf62017-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 Cross5f4dcf62017-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
Paul Duffinc08090f2017-06-29 14:58:43 +010075framework_base_android_test_mock_src_files := \
Paul Duffin69516f42017-11-15 11:39:14 +000076 $(call all-java-files-under, test-mock/src/android/test/mock)
Paul Duffinc08090f2017-06-29 14:58:43 +010077
78framework_base_android_test_runner_excluding_mock_src_files := \
Colin Cross5f4dcf62017-11-16 00:15:28 -080079 $(filter-out $(framework_base_android_test_mock_src_files), $(call all-java-files-under, test-runner/src))
Paul Duffinc08090f2017-06-29 14:58:43 +010080
Colin Cross5f4dcf62017-11-16 00:15:28 -080081# Find all files in specific directories (relative to frameworks/base)
82# to document and check apis
83files_to_check_apis := \
84 $(call find-other-java-files, \
Paul Duffin21418272017-11-16 15:47:05 +000085 test-base/src \
Colin Cross5f4dcf62017-11-16 00:15:28 -080086 $(non_base_dirs) \
87 )
Bart Searsa8cc0582015-05-07 03:23:20 +000088
Colin Cross5f4dcf62017-11-16 00:15:28 -080089# Find all files in specific packages that were used to compile
90# framework.jar to document and check apis
91files_to_check_apis += \
92 $(addprefix ../../,\
93 $(filter \
94 $(foreach dir,$(FRAMEWORKS_BASE_JAVA_SRC_DIRS),\
95 $(foreach package,$(packages_to_document),\
96 $(dir)/$(package)/%.java)),\
97 $(SOONG_FRAMEWORK_SRCS)))
98
99# Find all generated files that were used to compile framework.jar
Colin Cross0c760952017-12-04 13:45:19 -0800100files_to_check_apis_generated := \
101 $(filter $(OUT_DIR)/%,\
102 $(SOONG_FRAMEWORK_SRCS))
George Mountf6be9932015-12-03 07:39:55 -0800103
Bart Searsa8cc0582015-05-07 03:23:20 +0000104# These are relative to frameworks/base
105# FRAMEWORKS_BASE_SUBDIRS comes from build/core/pathmap.mk
Colin Cross5f4dcf62017-11-16 00:15:28 -0800106files_to_document := \
107 $(files_to_check_apis) \
108 $(call find-other-java-files,\
109 $(addprefix ../../, $(FRAMEWORKS_DATA_BINDING_JAVA_SRC_DIRS)) \
110 test-runner/src)
George Mountf6be9932015-12-03 07:39:55 -0800111
Bart Searsa8cc0582015-05-07 03:23:20 +0000112# These are relative to frameworks/base
113html_dirs := \
114 $(FRAMEWORKS_BASE_SUBDIRS) \
Colin Cross5f4dcf62017-11-16 00:15:28 -0800115 $(non_base_dirs) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000116
117# Common sources for doc check and api check
118common_src_files := \
119 $(call find-other-html-files, $(html_dirs)) \
Colin Cross5f4dcf62017-11-16 00:15:28 -0800120 $(addprefix ../../, $(libcore_to_document)) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000121
122# These are relative to frameworks/base
123framework_docs_LOCAL_SRC_FILES := \
Colin Cross5f4dcf62017-11-16 00:15:28 -0800124 $(files_to_document) \
125 $(common_src_files) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000126
127# These are relative to frameworks/base
128framework_docs_LOCAL_API_CHECK_SRC_FILES := \
Colin Cross5f4dcf62017-11-16 00:15:28 -0800129 $(framework_base_android_test_mock_src_files) \
130 $(framework_base_android_test_runner_excluding_mock_src_files) \
131 $(files_to_check_apis) \
132 $(common_src_files) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000133
134# This is used by ide.mk as the list of source files that are
135# always included.
136INTERNAL_SDK_SOURCE_DIRS := $(addprefix $(LOCAL_PATH)/,$(dirs_to_document))
137
138framework_docs_LOCAL_DROIDDOC_SOURCE_PATH := \
139 $(FRAMEWORKS_BASE_JAVA_SRC_DIRS)
140
Colin Cross5f4dcf62017-11-16 00:15:28 -0800141framework_docs_LOCAL_SRCJARS := $(SOONG_FRAMEWORK_SRCJARS)
142
Colin Cross0c760952017-12-04 13:45:19 -0800143framework_docs_LOCAL_GENERATED_SOURCES := \
144 $(libcore_to_document_generated) \
145 $(files_to_check_apis_generated) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000146
147framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES := \
Piotr Jastrzebskicfa292e2015-02-17 16:58:52 +0000148 core-oj \
Bart Searsa8cc0582015-05-07 03:23:20 +0000149 core-libart \
150 conscrypt \
151 bouncycastle \
152 okhttp \
153 ext \
Rayhaan Jaufeerally2e47a6e2015-08-03 13:54:28 +0100154 icu4j \
Bart Searsa8cc0582015-05-07 03:23:20 +0000155 framework \
Paul Duffinc08090f2017-06-29 14:58:43 +0100156 voip-common \
157 android.test.mock \
Bart Searsa8cc0582015-05-07 03:23:20 +0000158
Alan Viverette2d362a52017-04-05 10:21:58 -0400159# Platform docs can refer to Support Library APIs, but we don't actually build
160# them as part of the docs target, so we need to include them on the classpath.
Bart Searsa8cc0582015-05-07 03:23:20 +0000161framework_docs_LOCAL_JAVA_LIBRARIES := \
162 $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) \
163 $(FRAMEWORKS_SUPPORT_JAVA_LIBRARIES)
164
165framework_docs_LOCAL_MODULE_CLASS := JAVA_LIBRARIES
166framework_docs_LOCAL_DROIDDOC_HTML_DIR := docs/html
167# The since flag (-since N.xml API_LEVEL) is used to add API Level information
168# to the reference documentation. Must be in order of oldest to newest.
169#
170# Conscrypt (com.android.org.conscrypt) is an implementation detail and should
171# not be referenced in the documentation.
172framework_docs_LOCAL_DROIDDOC_OPTIONS := \
Jeff Sharkey0f3f60b2017-04-24 18:06:20 -0600173 -android \
Bart Searsa8cc0582015-05-07 03:23:20 +0000174 -knowntags ./frameworks/base/docs/knowntags.txt \
Narayan Kamath2c4f2842015-07-27 14:02:11 +0100175 -knowntags ./libcore/known_oj_tags.txt \
Jeff Sharkeybfc4fcd2017-06-05 17:38:17 -0600176 -manifest ./frameworks/base/core/res/AndroidManifest.xml \
Jeff Sharkeybc4f48b2017-12-06 21:02:11 -0700177 -hidePackage com.android.okhttp \
Bart Searsa8cc0582015-05-07 03:23:20 +0000178 -hidePackage com.android.org.conscrypt \
Jeff Sharkeybc4f48b2017-12-06 21:02:11 -0700179 -hidePackage com.android.server \
Bart Searsa8cc0582015-05-07 03:23:20 +0000180 -since $(SRC_API_DIR)/1.xml 1 \
181 -since $(SRC_API_DIR)/2.xml 2 \
182 -since $(SRC_API_DIR)/3.xml 3 \
183 -since $(SRC_API_DIR)/4.xml 4 \
184 -since $(SRC_API_DIR)/5.xml 5 \
185 -since $(SRC_API_DIR)/6.xml 6 \
186 -since $(SRC_API_DIR)/7.xml 7 \
187 -since $(SRC_API_DIR)/8.xml 8 \
188 -since $(SRC_API_DIR)/9.xml 9 \
189 -since $(SRC_API_DIR)/10.xml 10 \
190 -since $(SRC_API_DIR)/11.xml 11 \
191 -since $(SRC_API_DIR)/12.xml 12 \
192 -since $(SRC_API_DIR)/13.xml 13 \
193 -since $(SRC_API_DIR)/14.txt 14 \
194 -since $(SRC_API_DIR)/15.txt 15 \
195 -since $(SRC_API_DIR)/16.txt 16 \
196 -since $(SRC_API_DIR)/17.txt 17 \
197 -since $(SRC_API_DIR)/18.txt 18 \
198 -since $(SRC_API_DIR)/19.txt 19 \
199 -since $(SRC_API_DIR)/20.txt 20 \
200 -since $(SRC_API_DIR)/21.txt 21 \
201 -since $(SRC_API_DIR)/22.txt 22 \
Joe Fernandez1827e322015-08-12 19:45:22 -0700202 -since $(SRC_API_DIR)/23.txt 23 \
Dirk Dougherty5f60f7c2016-06-14 16:26:28 -0700203 -since $(SRC_API_DIR)/24.txt 24 \
Dirk Dougherty3376f582016-10-14 10:27:08 -0700204 -since $(SRC_API_DIR)/25.txt 25 \
Dirk Doughertyfdad0ba2017-06-09 14:43:32 -0700205 -since $(SRC_API_DIR)/26.txt 26 \
Andrew Solovaya6019b22017-10-06 14:27:20 -0700206 -since $(SRC_API_DIR)/27.txt 27 \
Jeff Sharkey2337aec2017-12-06 21:12:23 -0700207 -werror -lerror -hide 111 -hide 113 -hide 125 -hide 126 -hide 127 -hide 128 \
Jeff Sharkey0f3f60b2017-04-24 18:06:20 -0600208 -overview $(LOCAL_PATH)/core/java/overview.html \
Bart Searsa8cc0582015-05-07 03:23:20 +0000209
210framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR:= \
211 $(call intermediates-dir-for,JAVA_LIBRARIES,framework,,COMMON)
212
213framework_docs_LOCAL_ADDITIONAL_JAVA_DIR:= \
Alan Viverette2d362a52017-04-05 10:21:58 -0400214 $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
Bart Searsa8cc0582015-05-07 03:23:20 +0000215
216framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES := \
Narayan Kamathc21739a2015-07-14 13:39:23 +0100217 frameworks/base/docs/knowntags.txt \
Colin Cross72d359f2017-10-27 10:46:53 -0700218 $(libcore_to_document_generated)
Bart Searsa8cc0582015-05-07 03:23:20 +0000219
220samples_dir := development/samples/browseable
221
222# Whitelist of valid groups, used for default TOC grouping. Each sample must
223# belong to one (and only one) group. Assign samples to groups by setting
224# a sample.group var to one of these groups in the sample's _index.jd.
225sample_groups := -samplegroup Admin \
226 -samplegroup Background \
227 -samplegroup Connectivity \
228 -samplegroup Content \
229 -samplegroup Input \
230 -samplegroup Media \
231 -samplegroup Notification \
232 -samplegroup RenderScript \
233 -samplegroup Security \
234 -samplegroup Sensors \
Trevor Johns4cbe3592015-05-27 14:50:51 -0700235 -samplegroup System \
Bart Searsa8cc0582015-05-07 03:23:20 +0000236 -samplegroup Testing \
237 -samplegroup UI \
238 -samplegroup Views \
239 -samplegroup Wearable
240
241## SDK version identifiers used in the published docs
242 # major[.minor] version for current SDK. (full releases only)
smain@google.comdde8deb2016-08-29 18:36:50 -0700243framework_docs_SDK_VERSION:=7.0
Bart Searsa8cc0582015-05-07 03:23:20 +0000244 # release version (ie "Release x") (full releases only)
245framework_docs_SDK_REL_ID:=1
246
247framework_docs_LOCAL_DROIDDOC_OPTIONS += \
Billy Lamberta75dbc8f2017-03-03 13:09:15 -0800248 -hdf dac true \
Scott Mainf8cdfc82017-03-21 13:43:31 -0700249 -hdf sdk.codename O \
250 -hdf sdk.preview.version 1 \
Bart Searsa8cc0582015-05-07 03:23:20 +0000251 -hdf sdk.version $(framework_docs_SDK_VERSION) \
252 -hdf sdk.rel.id $(framework_docs_SDK_REL_ID) \
Scott Mainf8cdfc82017-03-21 13:43:31 -0700253 -hdf sdk.preview 0 \
254 -resourcesdir $(LOCAL_PATH)/docs/html/reference/images/ \
255 -resourcesoutdir reference/android/images/
Bart Searsa8cc0582015-05-07 03:23:20 +0000256
Alan Viverette2d362a52017-04-05 10:21:58 -0400257# Federate Support Library references against local API file.
258framework_docs_LOCAL_DROIDDOC_OPTIONS += \
259 -federate SupportLib https://developer.android.com \
260 -federationapi SupportLib prebuilts/sdk/current/support-api.txt
261
Bart Searsa8cc0582015-05-07 03:23:20 +0000262# ==== the api stubs and current.xml ===========================
263include $(CLEAR_VARS)
264
265LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800266LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800267LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000268LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
269LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
270LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
271LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
272LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
273LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
274
275LOCAL_MODULE := api-stubs
276
Ying Wang0f92a2e2015-07-16 14:20:22 -0700277LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_stubs_current_intermediates/src
278
Bart Searsa8cc0582015-05-07 03:23:20 +0000279LOCAL_DROIDDOC_OPTIONS:=\
280 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700281 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000282 -api $(INTERNAL_PLATFORM_API_FILE) \
David Brazdila793f3f2018-01-16 15:03:20 +0000283 -privateApi $(INTERNAL_PLATFORM_PRIVATE_API_FILE) \
284 -privateDexApi $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000285 -removedApi $(INTERNAL_PLATFORM_REMOVED_API_FILE) \
286 -nodocs
287
Scott Main15b85172017-02-21 14:30:58 -0800288LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000289
290LOCAL_UNINSTALLABLE_MODULE := true
291
292include $(BUILD_DROIDDOC)
293
David Brazdila793f3f2018-01-16 15:03:20 +0000294$(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_API_FILE) \
295 $(INTERNAL_PLATFORM_PRIVATE_API_FILE) \
296 $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE)
Bart Searsa8cc0582015-05-07 03:23:20 +0000297$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_API_FILE))
298
299# ==== the system api stubs ===================================
300include $(CLEAR_VARS)
301
302LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800303LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800304LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000305LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
306LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
307LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
308LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
309LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
310LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
311
312LOCAL_MODULE := system-api-stubs
313
Ying Wang0f92a2e2015-07-16 14:20:22 -0700314LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_system_stubs_current_intermediates/src
315
Bart Searsa8cc0582015-05-07 03:23:20 +0000316LOCAL_DROIDDOC_OPTIONS:=\
317 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700318 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000319 -showAnnotation android.annotation.SystemApi \
320 -api $(INTERNAL_PLATFORM_SYSTEM_API_FILE) \
David Brazdila793f3f2018-01-16 15:03:20 +0000321 -privateApi $(INTERNAL_PLATFORM_SYSTEM_PRIVATE_API_FILE) \
322 -privateDexApi $(INTERNAL_PLATFORM_SYSTEM_PRIVATE_DEX_API_FILE) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000323 -removedApi $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE) \
Jeff Sharkey05461c02017-05-09 19:01:09 -0600324 -exactApi $(INTERNAL_PLATFORM_SYSTEM_EXACT_API_FILE) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000325 -nodocs
326
Scott Main15b85172017-02-21 14:30:58 -0800327LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000328
329LOCAL_UNINSTALLABLE_MODULE := true
330
331include $(BUILD_DROIDDOC)
332
David Brazdila793f3f2018-01-16 15:03:20 +0000333$(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_SYSTEM_API_FILE) \
334 $(INTERNAL_PLATFORM_SYSTEM_PRIVATE_API_FILE) \
335 $(INTERNAL_PLATFORM_SYSTEM_PRIVATE_DEX_API_FILE)
Bart Searsa8cc0582015-05-07 03:23:20 +0000336$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_SYSTEM_API_FILE))
337
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000338# ==== the test api stubs ===================================
339include $(CLEAR_VARS)
340
341LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800342LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800343LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000344LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
345LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
346LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
347LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
348LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
349LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
350
351LOCAL_MODULE := test-api-stubs
352
353LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src
354
355LOCAL_DROIDDOC_OPTIONS:=\
356 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700357 -referenceonly \
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000358 -stubs $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src \
359 -showAnnotation android.annotation.TestApi \
360 -api $(INTERNAL_PLATFORM_TEST_API_FILE) \
361 -removedApi $(INTERNAL_PLATFORM_TEST_REMOVED_API_FILE) \
Jeff Sharkey05461c02017-05-09 19:01:09 -0600362 -exactApi $(INTERNAL_PLATFORM_TEST_EXACT_API_FILE) \
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000363 -nodocs
364
Scott Main15b85172017-02-21 14:30:58 -0800365LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000366
367LOCAL_UNINSTALLABLE_MODULE := true
368
369include $(BUILD_DROIDDOC)
370
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000371$(INTERNAL_PLATFORM_TEST_API_FILE): $(full_target)
372$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_TEST_API_FILE))
373
Bart Searsa8cc0582015-05-07 03:23:20 +0000374# ==== check javadoc comments but don't generate docs ========
375include $(CLEAR_VARS)
376
377LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800378LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800379LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000380LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
381LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
382LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
383LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
384LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
385LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
386
387LOCAL_MODULE := doc-comment-check
388
389LOCAL_DROIDDOC_OPTIONS:=\
390 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700391 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000392 -parsecomments
393
Scott Main15b85172017-02-21 14:30:58 -0800394LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000395
396LOCAL_UNINSTALLABLE_MODULE := true
397
398include $(BUILD_DROIDDOC)
399
Bart Searsa8cc0582015-05-07 03:23:20 +0000400# Run this for checkbuild
401checkbuild: doc-comment-check-docs
402# Check comment when you are updating the API
403update-api: doc-comment-check-docs
404
405# ==== static html in the sdk ==================================
406include $(CLEAR_VARS)
407
408LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800409LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800410LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000411LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
412LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
413LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
414LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
415LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
416LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
417
418LOCAL_MODULE := offline-sdk
419
420LOCAL_DROIDDOC_OPTIONS:=\
421 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
422 -offlinemode \
423 -title "Android SDK" \
424 -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \
smain@google.com00de8c52016-03-07 18:38:08 -0800425 -sdkvalues $(OUT_DOCS) \
smain@google.com8562ab52016-06-14 17:11:57 -0700426 -hdf android.whichdoc offline
427
Scott Main15b85172017-02-21 14:30:58 -0800428LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
smain@google.com8562ab52016-06-14 17:11:57 -0700429
430include $(BUILD_DROIDDOC)
431
432static_doc_index_redirect := $(out_dir)/index.html
433$(static_doc_index_redirect): \
434 $(LOCAL_PATH)/docs/docs-preview-index.html | $(ACP)
435 $(hide) mkdir -p $(dir $@)
436 $(hide) $(ACP) $< $@
437
438$(full_target): $(static_doc_index_redirect)
smain@google.com8562ab52016-06-14 17:11:57 -0700439
440
441# ==== static html in the sdk ==================================
442include $(CLEAR_VARS)
443
444LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800445LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800446LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
smain@google.com8562ab52016-06-14 17:11:57 -0700447LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
448LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
449LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
450LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
451LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
452LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
453
454LOCAL_MODULE := offline-sdk-referenceonly
455
456LOCAL_DROIDDOC_OPTIONS:=\
457 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
458 -offlinemode \
459 -title "Android SDK" \
460 -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \
461 -sdkvalues $(OUT_DOCS) \
smain@google.com00de8c52016-03-07 18:38:08 -0800462 -hdf android.whichdoc offline \
Scott Mainf8cdfc82017-03-21 13:43:31 -0700463 -referenceonly
smain@google.com00de8c52016-03-07 18:38:08 -0800464
Scott Main15b85172017-02-21 14:30:58 -0800465LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
smain@google.com00de8c52016-03-07 18:38:08 -0800466
467include $(BUILD_DROIDDOC)
468
469static_doc_index_redirect := $(out_dir)/index.html
smain@google.com151833a2016-08-31 08:42:09 -0700470$(static_doc_index_redirect): $(LOCAL_PATH)/docs/docs-documentation-redirect.html
Dan Willemsen98ff0b72016-03-23 00:42:44 -0700471 $(copy-file-to-target)
smain@google.com00de8c52016-03-07 18:38:08 -0800472
smain@google.com2f2365d2016-09-21 14:05:50 -0700473static_doc_properties := $(out_dir)/source.properties
474$(static_doc_properties): \
475 $(LOCAL_PATH)/docs/source.properties | $(ACP)
476 $(hide) mkdir -p $(dir $@)
477 $(hide) $(ACP) $< $@
478
smain@google.com00de8c52016-03-07 18:38:08 -0800479$(full_target): $(static_doc_index_redirect)
smain@google.com2f2365d2016-09-21 14:05:50 -0700480$(full_target): $(static_doc_properties)
smain@google.com00de8c52016-03-07 18:38:08 -0800481
smain@google.com7aca8be2016-03-10 14:13:30 -0800482
Bart Searsa8cc0582015-05-07 03:23:20 +0000483# ==== docs for the web (on the androiddevdocs app engine server) =======================
484include $(CLEAR_VARS)
485
486LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800487LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800488LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000489LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
490LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
491LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
492LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
493LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
494LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
495LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
496LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
497
498LOCAL_MODULE := online-sdk
499
500LOCAL_DROIDDOC_OPTIONS:= \
501 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
502 -toroot / \
503 -hdf android.whichdoc online \
504 $(sample_groups) \
505 -hdf android.hasSamples true \
506 -samplesdir $(samples_dir)
507
Scott Main15b85172017-02-21 14:30:58 -0800508LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000509
510include $(BUILD_DROIDDOC)
511
512# ==== docs for the web (on the androiddevdocs app engine server) =======================
Bart Searsa8cc0582015-05-07 03:23:20 +0000513include $(CLEAR_VARS)
514
515LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800516LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800517LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000518LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
519LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
520LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
521LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
522LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
523LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
524LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
525LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
526
527LOCAL_MODULE := online-system-api-sdk
528
529LOCAL_DROIDDOC_OPTIONS:= \
530 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700531 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000532 -showAnnotation android.annotation.SystemApi \
533 -title "Android SDK - Including system APIs." \
534 -toroot / \
Gina Dimino98ad8882016-05-31 17:25:48 -0700535 -hide 101 \
536 -hide 104 \
537 -hide 108 \
Bart Searsa8cc0582015-05-07 03:23:20 +0000538 -hdf android.whichdoc online \
539 $(sample_groups) \
540 -hdf android.hasSamples true \
541 -samplesdir $(samples_dir)
542
Scott Main15b85172017-02-21 14:30:58 -0800543LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Jeff Sharkey05461c02017-05-09 19:01:09 -0600544
Bart Searsa8cc0582015-05-07 03:23:20 +0000545LOCAL_UNINSTALLABLE_MODULE := true
546
547include $(BUILD_DROIDDOC)
Bart Searsa8cc0582015-05-07 03:23:20 +0000548
549# ==== docs for the web (on the devsite app engine server) =======================
550include $(CLEAR_VARS)
551LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800552LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800553LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000554LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
555LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
556LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
557LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
558LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
559LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
560LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
561# specify a second html input dir and an output path relative to OUT_DIR)
Dirk Dougherty3852c1f2016-04-10 02:05:09 -0700562LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
Bart Searsa8cc0582015-05-07 03:23:20 +0000563
564LOCAL_MODULE := ds
565
566LOCAL_DROIDDOC_OPTIONS:= \
567 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000568 -toroot / \
569 -hdf android.whichdoc online \
Dirk Doughertyb042ab12016-06-14 16:26:28 -0700570 -devsite \
Dirk Dougherty3852c1f2016-04-10 02:05:09 -0700571 $(sample_groups) \
Dirk Dougherty3852c1f2016-04-10 02:05:09 -0700572 -hdf android.hasSamples true \
573 -samplesdir $(samples_dir)
Bart Searsa8cc0582015-05-07 03:23:20 +0000574
Scott Main15b85172017-02-21 14:30:58 -0800575LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000576
577include $(BUILD_DROIDDOC)
578
Dirk Doughertyb042ab12016-06-14 16:26:28 -0700579# ==== docs for the web (on the devsite app engine server) =======================
580include $(CLEAR_VARS)
581LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800582LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800583LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Dirk Doughertyb042ab12016-06-14 16:26:28 -0700584LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
585LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
586LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
587LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
588LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
589LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
590LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
591# specify a second html input dir and an output path relative to OUT_DIR)
592LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
593
594LOCAL_MODULE := ds-static
595
596LOCAL_DROIDDOC_OPTIONS:= \
597 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
598 -hdf android.whichdoc online \
599 -staticonly \
600 -toroot / \
601 -devsite \
602 -ignoreJdLinks
603
Scott Main15b85172017-02-21 14:30:58 -0800604LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Dirk Doughertyb042ab12016-06-14 16:26:28 -0700605
606include $(BUILD_DROIDDOC)
607
Dirk Dougherty7d47b552016-09-13 16:44:25 -0700608# ==== generates full navtree for resolving @links in ds postprocessing ====
609include $(CLEAR_VARS)
610
611LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800612LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800613LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Dirk Dougherty7d47b552016-09-13 16:44:25 -0700614LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
615LOCAL_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_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
619LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
620
621LOCAL_MODULE := ds-ref-navtree
622
623LOCAL_DROIDDOC_OPTIONS:= \
624 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
625 -hdf android.whichdoc online \
626 -toroot / \
627 -atLinksNavtree \
628 -navtreeonly
629
Scott Main15b85172017-02-21 14:30:58 -0800630LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Dirk Dougherty7d47b552016-09-13 16:44:25 -0700631
632include $(BUILD_DROIDDOC)
633
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800634# ==== site updates for docs (on the androiddevdocs app engine server) =======================
Bart Searsa8cc0582015-05-07 03:23:20 +0000635include $(CLEAR_VARS)
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800636
Bart Searsa8cc0582015-05-07 03:23:20 +0000637LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800638LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800639LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000640LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
641LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
642LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
643LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800644LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
Bart Searsa8cc0582015-05-07 03:23:20 +0000645LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
646LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800647LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
Bart Searsa8cc0582015-05-07 03:23:20 +0000648
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800649LOCAL_MODULE := online-sdk-dev
Bart Searsa8cc0582015-05-07 03:23:20 +0000650
651LOCAL_DROIDDOC_OPTIONS:= \
652 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
653 -toroot / \
654 -hdf android.whichdoc online \
655 $(sample_groups) \
656 -hdf android.hasSamples true \
657 -samplesdir $(samples_dir)
658
Scott Main15b85172017-02-21 14:30:58 -0800659LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000660
661include $(BUILD_DROIDDOC)
662
Bart Searsa8cc0582015-05-07 03:23:20 +0000663# ==== docs that have all of the stuff that's @hidden =======================
664include $(CLEAR_VARS)
665
666LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800667LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800668LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000669LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
670LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
671LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
672LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
673LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
674LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
675
676LOCAL_MODULE := hidden
677LOCAL_DROIDDOC_OPTIONS:=\
678 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700679 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000680 -title "Android SDK - Including hidden APIs."
681# -hidden
682
Scott Main15b85172017-02-21 14:30:58 -0800683LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000684
685include $(BUILD_DROIDDOC)
686
Joe Onorato1754d742016-11-21 17:51:35 -0800687# ==== java proto host library ==============================
688include $(CLEAR_VARS)
689LOCAL_MODULE := platformprotos
690LOCAL_PROTOC_OPTIMIZE_TYPE := full
691LOCAL_PROTOC_FLAGS := \
692 -Iexternal/protobuf/src
693LOCAL_SOURCE_FILES_ALL_GENERATED := true
694LOCAL_SRC_FILES := \
695 $(call all-proto-files-under, core/proto) \
696 $(call all-proto-files-under, libs/incident/proto)
697include $(BUILD_HOST_JAVA_LIBRARY)
698
Bart Searsa8cc0582015-05-07 03:23:20 +0000699
David Brazdil0649c8d2018-01-22 22:23:13 +0000700# ==== hiddenapi lists =======================================
701
David Brazdilf16ac002018-01-26 11:13:35 +0000702# Copy blacklist and dark greylist over into the build folder.
703# This is for ART buildbots which need to mock these lists and have alternative
704# rules for building them. Other rules in the build system should depend on the
705# files in the build folder.
706
707$(eval $(call copy-one-file,frameworks/base/config/hiddenapi-blacklist.txt,\
708 $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST)))
709$(eval $(call copy-one-file,frameworks/base/config/hiddenapi-dark-greylist.txt,\
710 $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST)))
711
David Brazdil0649c8d2018-01-22 22:23:13 +0000712# Generate light greylist as private API minus (blacklist plus dark greylist).
713
714$(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST): PRIVATE_API := $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE)
715$(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST): BLACKLIST := $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST)
716$(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST): DARK_GREYLIST := $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST)
717$(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST): $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) \
718 $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST) \
719 $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST)
720 if [ ! -z "`comm -12 <(sort $(BLACKLIST)) <(sort $(DARK_GREYLIST))`" ]; then \
721 echo "There should be no overlap between $(BLACKLIST) and $(DARK_GREYLIST)" 1>&2; \
722 exit 1; \
723 elif [ ! -z "`comm -13 <(sort $(PRIVATE_API)) <(sort $(BLACKLIST))`" ]; then \
724 echo "$(BLACKLIST) must be a subset of $(PRIVATE_API)" 1>&2; \
725 exit 2; \
726 elif [ ! -z "`comm -13 <(sort $(PRIVATE_API)) <(sort $(DARK_GREYLIST))`" ]; then \
727 echo "$(DARK_GREYLIST) must be a subset of $(PRIVATE_API)" 1>&2; \
728 exit 3; \
729 fi
730 comm -23 <(sort $(PRIVATE_API)) <(sort $(BLACKLIST) $(DARK_GREYLIST)) > $@
731
Bart Searsa8cc0582015-05-07 03:23:20 +0000732# Include subdirectory makefiles
733# ============================================================
734
735# If we're building with ONE_SHOT_MAKEFILE (mm, mmm), then what the framework
736# team really wants is to build the stuff defined by this makefile.
737ifeq (,$(ONE_SHOT_MAKEFILE))
738include $(call first-makefiles-under,$(LOCAL_PATH))
739endif
740
Holly Jiuyu Sunbbc85802017-12-21 18:44:59 -0800741endif # ANDROID_BUILD_EMBEDDED
742