2 # Copyright (C) 2008 The Android Open Source Project
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
8 # http://www.apache.org/licenses/LICENSE-2.0
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.
16 LOCAL_PATH := $(call my-dir)
18 # Load framework-specific path mappings used later in the build.
19 include $(LOCAL_PATH)/pathmap.mk
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 # ============================================================
27 # embedded builds use nothing in frameworks/base
28 ifneq ($(ANDROID_BUILD_EMBEDDED),true)
30 # Copy AIDL files to be preprocessed and included in the SDK,
31 # specified relative to the root of the build tree.
32 # ============================================================
36 define 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: $$@
42 $(HOST_OUT_EXECUTABLES)/sdkparcelables $$< $$@
45 $(foreach stubs,android_stubs_current android_test_stubs_current android_system_stubs_current,\
46 $(eval $(call stubs-to-aidl-parcelables,$(stubs))))
48 gen := $(TARGET_OUT_COMMON_INTERMEDIATES)/framework.aidl
50 $(gen): $(aidl_parcelables)
51 @echo Combining SDK parcelables: $@
53 cat $^ | sort -u > $@.tmp
54 $(call commit-change-for-toc,$@)
57 # ============================================================
59 # TODO: deal with com/google/android/googleapps
60 packages_to_document := \
62 javax/microedition/khronos \
63 org/apache/http/conn \
64 org/apache/http/params \
66 # include definition of libcore_to_document
67 include libcore/Docs.mk
70 ../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 \
75 # Find all files in specific directories (relative to frameworks/base)
76 # to document and check apis
77 files_to_check_apis := \
78 $(call find-other-java-files, \
82 # Find all files in specific packages that were used to compile
83 # framework.jar to document and check apis
84 files_to_check_apis += \
87 $(foreach dir,$(FRAMEWORKS_BASE_JAVA_SRC_DIRS),\
88 $(foreach package,$(packages_to_document),\
89 $(dir)/$(package)/%.java)),\
90 $(SOONG_FRAMEWORK_SRCS)))
92 # Find all generated files that were used to compile framework.jar
93 files_to_check_apis_generated := \
94 $(filter $(OUT_DIR)/%,\
95 $(SOONG_FRAMEWORK_SRCS))
97 # These are relative to frameworks/base
98 # FRAMEWORKS_BASE_SUBDIRS comes from build/core/pathmap.mk
99 files_to_document := \
100 $(files_to_check_apis) \
101 $(call find-other-java-files,\
106 # These are relative to frameworks/base
108 $(FRAMEWORKS_BASE_SUBDIRS) \
111 # Common sources for doc check and api check
112 common_src_files := \
113 $(call find-other-html-files, $(html_dirs)) \
114 $(addprefix ../../, $(libcore_to_document)) \
116 # These are relative to frameworks/base
117 framework_docs_LOCAL_SRC_FILES := \
118 $(files_to_document) \
119 $(common_src_files) \
121 # These are relative to frameworks/base
122 framework_docs_LOCAL_API_CHECK_SRC_FILES := \
123 $(files_to_check_apis) \
124 $(common_src_files) \
126 # This is used by ide.mk as the list of source files that are
128 INTERNAL_SDK_SOURCE_DIRS := $(addprefix $(LOCAL_PATH)/,$(dirs_to_document))
130 framework_docs_LOCAL_DROIDDOC_SOURCE_PATH := \
131 $(FRAMEWORKS_BASE_JAVA_SRC_DIRS)
133 framework_docs_LOCAL_SRCJARS := $(SOONG_FRAMEWORK_SRCJARS)
135 framework_docs_LOCAL_GENERATED_SOURCES := \
136 $(libcore_to_document_generated) \
137 $(files_to_check_apis_generated) \
139 framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES := \
149 # 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.
151 framework_docs_LOCAL_JAVA_LIBRARIES := \
152 $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) \
153 $(FRAMEWORKS_SUPPORT_JAVA_LIBRARIES)
155 framework_docs_LOCAL_MODULE_CLASS := JAVA_LIBRARIES
156 framework_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.
160 # Conscrypt (com.android.org.conscrypt) is an implementation detail and should
161 # not be referenced in the documentation.
162 framework_docs_LOCAL_DROIDDOC_OPTIONS := \
164 -knowntags ./frameworks/base/docs/knowntags.txt \
165 -knowntags ./libcore/known_oj_tags.txt \
166 -manifest ./frameworks/base/core/res/AndroidManifest.xml \
167 -hidePackage com.android.internal \
168 -hidePackage com.android.internal.util \
169 -hidePackage com.android.okhttp \
170 -hidePackage com.android.org.conscrypt \
171 -hidePackage com.android.server \
172 -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 \
194 -since $(SRC_API_DIR)/23.txt 23 \
195 -since $(SRC_API_DIR)/24.txt 24 \
196 -since $(SRC_API_DIR)/25.txt 25 \
197 -since $(SRC_API_DIR)/26.txt 26 \
198 -since $(SRC_API_DIR)/27.txt 27 \
199 -since $(SRC_API_DIR)/28.txt 28 \
200 -werror -lerror -hide 111 -hide 113 -hide 125 -hide 126 -hide 127 -hide 128 \
201 -overview $(LOCAL_PATH)/core/java/overview.html \
203 framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR:= \
204 $(call intermediates-dir-for,JAVA_LIBRARIES,framework,,COMMON)
206 framework_docs_LOCAL_ADDITIONAL_JAVA_DIR:= \
207 $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
209 framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES := \
210 frameworks/base/docs/knowntags.txt \
211 $(libcore_to_document_generated)
213 samples_dir := development/samples/browseable
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.
218 sample_groups := -samplegroup Admin \
219 -samplegroup Background \
220 -samplegroup Connectivity \
221 -samplegroup Content \
224 -samplegroup Notification \
225 -samplegroup RenderScript \
226 -samplegroup Security \
227 -samplegroup Sensors \
228 -samplegroup System \
229 -samplegroup Testing \
232 -samplegroup Wearable
234 ## SDK version identifiers used in the published docs
235 # major[.minor] version for current SDK. (full releases only)
236 framework_docs_SDK_VERSION:=7.0
237 # release version (ie "Release x") (full releases only)
238 framework_docs_SDK_REL_ID:=1
240 framework_docs_LOCAL_DROIDDOC_OPTIONS += \
242 -hdf sdk.codename O \
243 -hdf sdk.preview.version 1 \
244 -hdf sdk.version $(framework_docs_SDK_VERSION) \
245 -hdf sdk.rel.id $(framework_docs_SDK_REL_ID) \
247 -resourcesdir $(LOCAL_PATH)/docs/html/reference/images/ \
248 -resourcesoutdir reference/android/images/
250 # Federate Support Library references against local API file.
251 framework_docs_LOCAL_DROIDDOC_OPTIONS += \
252 -federate SupportLib https://developer.android.com \
253 -federationapi SupportLib prebuilts/sdk/current/support-api.txt
255 # Federate AndroidX references against local API file.
256 framework_docs_LOCAL_DROIDDOC_OPTIONS += \
257 -federate AndroidX https://developer.android.com \
258 -federationapi AndroidX prebuilts/sdk/current/androidx-api.txt
260 framework_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
269 # ==== Public API diff ===========================
270 include $(CLEAR_VARS)
272 LOCAL_SRC_FILES := $(framework_docs_LOCAL_API_CHECK_SRC_FILES)
273 LOCAL_GENERATED_SOURCES := $(framework_docs_LOCAL_GENERATED_SOURCES)
274 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
275 LOCAL_JAVA_LIBRARIES := $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
276 LOCAL_MODULE_CLASS := $(framework_docs_LOCAL_MODULE_CLASS)
277 LOCAL_ADDITIONAL_JAVA_DIR := $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
278 LOCAL_ADDITIONAL_DEPENDENCIES := \
279 $(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) \
280 $(INTERNAL_PLATFORM_API_FILE)
282 LOCAL_MODULE := offline-sdk-referenceonly
284 last_released_sdk_version := $(lastword $(call numerically_sort, \
285 $(filter-out current, \
286 $(patsubst $(SRC_API_DIR)/%.txt,%, $(wildcard $(SRC_API_DIR)/*.txt)) \
290 LOCAL_APIDIFF_OLDAPI := $(LOCAL_PATH)/../../$(SRC_API_DIR)/$(last_released_sdk_version)
291 LOCAL_APIDIFF_NEWAPI := $(LOCAL_PATH)/../../$(basename $(INTERNAL_PLATFORM_API_FILE))
293 include $(BUILD_APIDIFF)
295 # Hack to get diffs included in docs output
296 out_zip := $(OUT_DOCS)/$(LOCAL_MODULE)-docs.zip
297 $(out_zip): $(full_target)
299 # ==== System API diff ===========================
300 include $(CLEAR_VARS)
302 LOCAL_SRC_FILES := $(framework_docs_LOCAL_API_CHECK_SRC_FILES)
303 LOCAL_GENERATED_SOURCES := $(framework_docs_LOCAL_GENERATED_SOURCES)
304 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
305 LOCAL_JAVA_LIBRARIES := $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
306 LOCAL_MODULE_CLASS := $(framework_docs_LOCAL_MODULE_CLASS)
307 LOCAL_ADDITIONAL_JAVA_DIR := $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
308 LOCAL_ADDITIONAL_DEPENDENCIES := \
309 $(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) \
310 $(INTERNAL_PLATFORM_SYSTEM_API_FILE)
312 LOCAL_MODULE := offline-system-sdk-referenceonly
314 last_released_sdk_version := $(lastword $(call numerically_sort, \
315 $(filter-out current, \
316 $(patsubst $(SRC_SYSTEM_API_DIR)/%.txt,%, $(wildcard $(SRC_SYSTEM_API_DIR)/*.txt)) \
320 LOCAL_APIDIFF_OLDAPI := $(LOCAL_PATH)/../../$(SRC_SYSTEM_API_DIR)/$(last_released_sdk_version)
321 LOCAL_APIDIFF_NEWAPI := $(LOCAL_PATH)/../../$(basename $(INTERNAL_PLATFORM_SYSTEM_API_FILE))
323 include $(BUILD_APIDIFF)
325 # Hack to get diffs included in docs output
326 out_zip := $(OUT_DOCS)/$(LOCAL_MODULE)-docs.zip
327 $(out_zip): $(full_target)
329 # ==== the api stubs and current.xml ===========================
330 include $(CLEAR_VARS)
332 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
333 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
334 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
335 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
336 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
337 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
338 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
339 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
340 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
342 LOCAL_MODULE := api-stubs
344 LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_stubs_current_intermediates/src
346 LOCAL_DROIDDOC_OPTIONS:=\
347 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
349 -api $(INTERNAL_PLATFORM_API_FILE) \
350 -removedApi $(INTERNAL_PLATFORM_REMOVED_API_FILE) \
353 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
355 LOCAL_UNINSTALLABLE_MODULE := true
357 include $(BUILD_DROIDDOC)
359 $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_API_FILE) \
360 $(INTERNAL_PLATFORM_REMOVED_API_FILE)
361 $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_API_FILE))
363 # ==== the metalava api stubs and current.xml ===========================
364 include $(CLEAR_VARS)
366 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
367 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
368 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
369 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
370 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
371 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
372 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
373 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
375 LOCAL_MODULE := metalava-api-stubs
376 LOCAL_DROIDDOC_USE_METALAVA := true
377 LOCAL_DROIDDOC_METALAVA_PREVIOUS_API := prebuilts/sdk/api/27.txt
378 LOCAL_DROIDDOC_METALAVA_ANNOTATIONS_ENABLED := true
379 LOCAL_DROIDDOC_METALAVA_MERGE_ANNOTATIONS_DIR := tools/metalava/manual
381 LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/metalava_android_stubs_current_intermediates/src
383 INTERNAL_PLATFORM_METALAVA_PUBLIC_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava_public_api.txt
384 INTERNAL_PLATFORM_METALAVA_PUBLIC_REMOVED_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava_removed.txt
386 LOCAL_DROIDDOC_OPTIONS:=\
387 $(framework_metalava_docs_LOCAL_DROIDDOC_OPTIONS) \
388 --api $(INTERNAL_PLATFORM_METALAVA_PUBLIC_API_FILE) \
389 --removed-api $(INTERNAL_PLATFORM_METALAVA_PUBLIC_REMOVED_API_FILE) \
392 LOCAL_UNINSTALLABLE_MODULE := true
394 include $(BUILD_DROIDDOC)
396 $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_METALAVA_PUBLIC_API_FILE) \
397 $(INTERNAL_PLATFORM_METALAVA_PUBLIC_REMOVED_API_FILE)
398 $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_METALAVA_PUBLIC_API_FILE))
400 # ==== the system api stubs ===================================
401 include $(CLEAR_VARS)
403 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
404 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
405 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
406 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
407 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
408 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
409 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
410 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
411 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
413 LOCAL_MODULE := system-api-stubs
415 LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_system_stubs_current_intermediates/src
417 LOCAL_DROIDDOC_OPTIONS:=\
418 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
420 -showAnnotation android.annotation.SystemApi \
421 -api $(INTERNAL_PLATFORM_SYSTEM_API_FILE) \
422 -removedApi $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE) \
423 -exactApi $(INTERNAL_PLATFORM_SYSTEM_EXACT_API_FILE) \
426 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
428 LOCAL_UNINSTALLABLE_MODULE := true
430 include $(BUILD_DROIDDOC)
432 $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_SYSTEM_API_FILE) \
433 $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE) \
434 $(INTERNAL_PLATFORM_SYSTEM_EXACT_API_FILE)
435 $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_SYSTEM_API_FILE))
437 # ==== the metalava system api stubs ===================================
438 include $(CLEAR_VARS)
440 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
441 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
442 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
443 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
444 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
445 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
446 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
447 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
449 LOCAL_MODULE := metalava-system-api-stubs
450 LOCAL_DROIDDOC_USE_METALAVA := true
451 LOCAL_DROIDDOC_METALAVA_PREVIOUS_API := prebuilts/sdk/api/27.txt
452 LOCAL_DROIDDOC_METALAVA_ANNOTATIONS_ENABLED := true
453 LOCAL_DROIDDOC_METALAVA_MERGE_ANNOTATIONS_DIR := tools/metalava/manual
455 LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/metalava_android_system_stubs_current_intermediates/src
457 INTERNAL_PLATFORM_METALAVA_SYSTEM_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava-system-api.txt
458 INTERNAL_PLATFORM_METALAVA_SYSTEM_REMOVED_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava-system-removed.txt
460 LOCAL_DROIDDOC_OPTIONS:=\
461 $(framework_metalava_docs_LOCAL_DROIDDOC_OPTIONS) \
462 --show-annotation android.annotation.SystemApi \
463 --api $(INTERNAL_PLATFORM_METALAVA_SYSTEM_API_FILE) \
464 --removed-api $(INTERNAL_PLATFORM_METALAVA_SYSTEM_REMOVED_API_FILE) \
467 LOCAL_UNINSTALLABLE_MODULE := true
469 include $(BUILD_DROIDDOC)
471 $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_METALAVA_SYSTEM_API_FILE) \
472 $(INTERNAL_PLATFORM_METALAVA_SYSTEM_REMOVED_API_FILE) \
473 $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_METALAVA_SYSTEM_API_FILE))
475 # ==== the test api stubs ===================================
476 include $(CLEAR_VARS)
478 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
479 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
480 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
481 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
482 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
483 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
484 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
485 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
486 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
488 LOCAL_MODULE := test-api-stubs
490 LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src
492 LOCAL_DROIDDOC_OPTIONS:=\
493 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
495 -stubs $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src \
496 -showAnnotation android.annotation.TestApi \
497 -api $(INTERNAL_PLATFORM_TEST_API_FILE) \
498 -removedApi $(INTERNAL_PLATFORM_TEST_REMOVED_API_FILE) \
499 -exactApi $(INTERNAL_PLATFORM_TEST_EXACT_API_FILE) \
502 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
504 LOCAL_UNINSTALLABLE_MODULE := true
506 include $(BUILD_DROIDDOC)
508 $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_TEST_API_FILE) \
509 $(INTERNAL_PLATFORM_TEST_REMOVED_API_FILE) \
510 $(INTERNAL_PLATFORM_TEST_EXACT_API_FILE)
511 $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_TEST_API_FILE))
513 # ==== the metalava test api stubs ===================================
514 include $(CLEAR_VARS)
516 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
517 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
518 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
519 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
520 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
521 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
522 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
523 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
525 LOCAL_MODULE := metalava-test-api-stubs
526 LOCAL_DROIDDOC_USE_METALAVA := true
527 LOCAL_DROIDDOC_METALAVA_PREVIOUS_API := prebuilts/sdk/api/27.txt
528 LOCAL_DROIDDOC_METALAVA_ANNOTATIONS_ENABLED := true
529 LOCAL_DROIDDOC_METALAVA_MERGE_ANNOTATIONS_DIR := tools/metalava/manual
531 LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/metalava_android_test_stubs_current_intermediates/src
533 INTERNAL_PLATFORM_METALAVA_TEST_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava-test-api.txt
534 INTERNAL_PLATFORM_METALAVA_TEST_REMOVED_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava-test-removed.txt
536 LOCAL_DROIDDOC_OPTIONS:=\
537 $(framework_metalava_docs_LOCAL_DROIDDOC_OPTIONS) \
538 --show-annotation android.annotation.TestApi \
539 --api $(INTERNAL_PLATFORM_METALAVA_TEST_API_FILE) \
540 --removed-api $(INTERNAL_PLATFORM_METALAVA_TEST_REMOVED_API_FILE) \
543 LOCAL_UNINSTALLABLE_MODULE := true
545 include $(BUILD_DROIDDOC)
547 $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_METALAVA_TEST_API_FILE) \
548 $(INTERNAL_PLATFORM_METALAVA_TEST_REMOVED_API_FILE) \
549 $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_METALAVA_TEST_API_FILE))
551 # ==== the complete hidden api list ===================================
552 include $(CLEAR_VARS)
554 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
555 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
556 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
557 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
558 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
559 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
560 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
561 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
562 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
564 LOCAL_MODULE := hidden-api-list
566 LOCAL_DROIDDOC_OPTIONS:=\
567 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
570 -showAnnotation android.annotation.SystemApi \
571 -showAnnotation android.annotation.TestApi \
572 -dexApi $(INTERNAL_PLATFORM_DEX_API_FILE) \
573 -privateDexApi $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) \
574 -removedDexApi $(INTERNAL_PLATFORM_REMOVED_DEX_API_FILE) \
577 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
579 LOCAL_UNINSTALLABLE_MODULE := true
581 include $(BUILD_DROIDDOC)
583 $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_DEX_API_FILE) \
584 $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) \
585 $(INTERNAL_PLATFORM_REMOVED_DEX_API_FILE)
587 # ==== check javadoc comments but don't generate docs ========
588 include $(CLEAR_VARS)
590 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
591 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
592 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
593 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
594 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
595 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
596 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
597 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
598 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
600 LOCAL_MODULE := doc-comment-check
602 LOCAL_DROIDDOC_OPTIONS:=\
603 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
607 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
609 LOCAL_UNINSTALLABLE_MODULE := true
611 include $(BUILD_DROIDDOC)
613 # Run this for checkbuild
614 checkbuild: doc-comment-check-docs
615 # Check comment when you are updating the API
616 update-api: doc-comment-check-docs
618 # ==== static html in the sdk ==================================
619 include $(CLEAR_VARS)
621 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
622 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
623 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
624 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
625 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
626 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
627 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
628 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
629 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
631 LOCAL_MODULE := offline-sdk
633 LOCAL_DROIDDOC_OPTIONS:=\
634 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
636 -title "Android SDK" \
637 -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \
638 -sdkvalues $(OUT_DOCS) \
639 -hdf android.whichdoc offline
641 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
643 include $(BUILD_DROIDDOC)
645 static_doc_index_redirect := $(out_dir)/index.html
646 $(static_doc_index_redirect): \
647 $(LOCAL_PATH)/docs/docs-preview-index.html | $(ACP)
648 $(hide) mkdir -p $(dir $@)
651 $(full_target): $(static_doc_index_redirect)
654 # ==== Public API static reference docs ==================================
655 include $(CLEAR_VARS)
657 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
658 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
659 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
660 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
661 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
662 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
663 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
664 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
665 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
667 LOCAL_MODULE := offline-sdk-referenceonly
669 LOCAL_DROIDDOC_OPTIONS:=\
670 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
672 -title "Android SDK" \
673 -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \
674 -sdkvalues $(OUT_DOCS) \
675 -hdf android.whichdoc offline \
678 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
680 include $(BUILD_DROIDDOC)
682 static_doc_index_redirect := $(out_dir)/index.html
683 $(static_doc_index_redirect): $(LOCAL_PATH)/docs/docs-documentation-redirect.html
684 $(copy-file-to-target)
686 static_doc_properties := $(out_dir)/source.properties
687 $(static_doc_properties): \
688 $(LOCAL_PATH)/docs/source.properties | $(ACP)
689 $(hide) mkdir -p $(dir $@)
692 $(full_target): $(static_doc_index_redirect)
693 $(full_target): $(static_doc_properties)
696 # ==== System API static reference docs ==================================
697 include $(CLEAR_VARS)
699 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
700 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
701 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
702 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
703 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
704 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
705 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
706 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
707 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
709 LOCAL_MODULE := offline-system-sdk-referenceonly
711 LOCAL_DROIDDOC_OPTIONS:=\
712 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
713 -hide 101 -hide 104 -hide 108 \
714 -showAnnotation android.annotation.SystemApi \
716 -title "Android System SDK" \
717 -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \
718 -sdkvalues $(OUT_DOCS) \
719 -hdf android.whichdoc offline \
722 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
724 include $(BUILD_DROIDDOC)
726 static_doc_index_redirect := $(out_dir)/index.html
727 $(static_doc_index_redirect): $(LOCAL_PATH)/docs/docs-documentation-redirect.html
728 $(copy-file-to-target)
730 static_doc_properties := $(out_dir)/source.properties
731 $(static_doc_properties): \
732 $(LOCAL_PATH)/docs/source.properties | $(ACP)
733 $(hide) mkdir -p $(dir $@)
736 $(full_target): $(static_doc_index_redirect)
737 $(full_target): $(static_doc_properties)
738 $(full_target): $(framework_built)
741 # ==== docs for the web (on the androiddevdocs app engine server) =======================
742 include $(CLEAR_VARS)
744 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
745 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
746 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
747 LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
748 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
749 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
750 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
751 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
752 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
753 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
754 LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
756 LOCAL_MODULE := online-sdk
758 LOCAL_DROIDDOC_OPTIONS:= \
759 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
761 -hdf android.whichdoc online \
763 -hdf android.hasSamples true \
764 -samplesdir $(samples_dir)
766 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
768 include $(BUILD_DROIDDOC)
770 # ==== docs for the web (on the androiddevdocs app engine server) =======================
771 include $(CLEAR_VARS)
773 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
774 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
775 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
776 LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
777 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
778 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
779 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
780 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
781 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
782 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
783 LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
785 LOCAL_MODULE := online-system-api-sdk
787 LOCAL_DROIDDOC_OPTIONS:= \
788 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
790 -showAnnotation android.annotation.SystemApi \
791 -title "Android SDK - Including system APIs." \
796 -hdf android.whichdoc online \
798 -hdf android.hasSamples true \
799 -samplesdir $(samples_dir)
801 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
803 LOCAL_UNINSTALLABLE_MODULE := true
805 include $(BUILD_DROIDDOC)
807 # ==== docs for the web (on the devsite app engine server) =======================
808 include $(CLEAR_VARS)
809 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
810 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
811 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
812 LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
813 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
814 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
815 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
816 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
817 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
818 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
819 # specify a second html input dir and an output path relative to OUT_DIR)
820 LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
824 LOCAL_DROIDDOC_OPTIONS:= \
825 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
827 -hdf android.whichdoc online \
831 -hdf android.hasSamples true \
832 -samplesdir $(samples_dir)
834 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
836 include $(BUILD_DROIDDOC)
838 # ==== docs for the web (on the devsite app engine server) =======================
839 include $(CLEAR_VARS)
840 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
841 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
842 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
843 LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
844 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
845 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
846 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
847 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
848 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
849 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
850 # specify a second html input dir and an output path relative to OUT_DIR)
851 LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
853 LOCAL_MODULE := ds-static
855 LOCAL_DROIDDOC_OPTIONS:= \
856 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
857 -hdf android.whichdoc online \
863 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
865 include $(BUILD_DROIDDOC)
867 # ==== generates full navtree for resolving @links in ds postprocessing ====
868 include $(CLEAR_VARS)
870 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
871 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
872 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
873 LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
874 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
875 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
876 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
877 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
878 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
880 LOCAL_MODULE := ds-ref-navtree
882 LOCAL_DROIDDOC_OPTIONS:= \
883 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
884 -hdf android.whichdoc online \
889 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
891 include $(BUILD_DROIDDOC)
893 # ==== site updates for docs (on the androiddevdocs app engine server) =======================
894 include $(CLEAR_VARS)
896 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
897 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
898 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
899 LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
900 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
901 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
902 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
903 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
904 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
905 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
906 LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
908 LOCAL_MODULE := online-sdk-dev
910 LOCAL_DROIDDOC_OPTIONS:= \
911 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
913 -hdf android.whichdoc online \
915 -hdf android.hasSamples true \
916 -samplesdir $(samples_dir)
918 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
920 include $(BUILD_DROIDDOC)
922 # ==== docs that have all of the stuff that's @hidden =======================
923 include $(CLEAR_VARS)
925 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
926 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
927 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
928 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
929 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
930 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
931 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
932 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
933 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
935 LOCAL_MODULE := hidden
936 LOCAL_DROIDDOC_OPTIONS:=\
937 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
939 -title "Android SDK - Including hidden APIs."
942 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
944 include $(BUILD_DROIDDOC)
946 # ==== java proto host library ==============================
947 include $(CLEAR_VARS)
948 LOCAL_MODULE := platformprotos
949 LOCAL_PROTOC_OPTIMIZE_TYPE := full
950 LOCAL_PROTOC_FLAGS := \
951 -Iexternal/protobuf/src
952 LOCAL_SOURCE_FILES_ALL_GENERATED := true
954 cmds/am/proto/instrumentation_data.proto \
955 cmds/statsd/src/perfetto/perfetto_config.proto \
956 $(call all-proto-files-under, core/proto) \
957 $(call all-proto-files-under, libs/incident/proto) \
958 $(call all-proto-files-under, cmds/statsd/src)
960 LOCAL_ERROR_PRONE_FLAGS := -Xep:MissingOverride:OFF
961 include $(BUILD_HOST_JAVA_LIBRARY)
963 # ==== java proto device library (for test only) ==============================
964 include $(CLEAR_VARS)
965 LOCAL_MODULE := platformprotosnano
966 LOCAL_MODULE_TAGS := tests
967 LOCAL_PROTOC_OPTIMIZE_TYPE := nano
968 LOCAL_PROTOC_FLAGS := \
969 -Iexternal/protobuf/src
970 LOCAL_PROTO_JAVA_OUTPUT_PARAMS := \
971 store_unknown_fields = true
972 LOCAL_SDK_VERSION := current
974 $(call all-proto-files-under, core/proto) \
975 $(call all-proto-files-under, libs/incident/proto/android/os)
976 include $(BUILD_STATIC_JAVA_LIBRARY)
979 # ==== java proto device library (for test only) ==============================
980 include $(CLEAR_VARS)
981 LOCAL_MODULE := platformprotoslite
982 LOCAL_MODULE_TAGS := tests
983 LOCAL_PROTOC_OPTIMIZE_TYPE := lite
984 LOCAL_PROTOC_FLAGS := \
985 -Iexternal/protobuf/src
987 $(call all-proto-files-under, core/proto) \
988 $(call all-proto-files-under, libs/incident/proto/android/os)
989 # Protos have lots of MissingOverride and similar.
990 LOCAL_ERROR_PRONE_FLAGS := -XepDisableAllChecks
991 include $(BUILD_STATIC_JAVA_LIBRARY)
993 # ==== hiddenapi lists =======================================
994 include $(CLEAR_VARS)
996 # File names of final API lists
997 LOCAL_LIGHT_GREYLIST := $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST)
998 LOCAL_DARK_GREYLIST := $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST)
999 LOCAL_BLACKLIST := $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST)
1001 # File names of source files we will use to generate the final API lists.
1002 LOCAL_SRC_GREYLIST := frameworks/base/config/hiddenapi-light-greylist.txt
1003 LOCAL_SRC_VENDOR_LIST := frameworks/base/config/hiddenapi-vendor-list.txt
1004 LOCAL_SRC_FORCE_BLACKLIST := frameworks/base/config/hiddenapi-force-blacklist.txt
1005 LOCAL_SRC_PUBLIC_API := frameworks/base/config/hiddenapi-public-dex.txt
1006 LOCAL_SRC_PRIVATE_API := frameworks/base/config/hiddenapi-private-dex.txt
1007 LOCAL_SRC_REMOVED_API := frameworks/base/config/hiddenapi-removed-dex.txt
1010 $(LOCAL_SRC_GREYLIST) \
1011 $(LOCAL_SRC_VENDOR_LIST) \
1012 $(LOCAL_SRC_FORCE_BLACKLIST) \
1013 $(LOCAL_SRC_PUBLIC_API) \
1014 $(LOCAL_SRC_PRIVATE_API) \
1015 $(LOCAL_SRC_REMOVED_API)
1017 define assert-has-no-overlap
1018 if [ ! -z "`comm -12 <(sort $(1)) <(sort $(2))`" ]; then \
1019 echo "$(1) and $(2) should not overlap" 1>&2; \
1020 comm -12 <(sort $(1)) <(sort $(2)) 1>&2; \
1025 define assert-is-subset
1026 if [ ! -z "`comm -23 <(sort $(1)) <(sort $(2))`" ]; then \
1027 echo "$(1) must be a subset of $(2)" 1>&2; \
1028 comm -23 <(sort $(1)) <(sort $(2)) 1>&2; \
1033 define assert-has-no-duplicates
1034 if [ ! -z "`sort $(1) | uniq -D`" ]; then \
1035 echo "$(1) has duplicate entries" 1>&2; \
1036 sort $(1) | uniq -D 1>&2; \
1041 # The following rules build API lists in the build folder.
1042 # By not using files from the source tree, ART buildbots can mock these lists
1043 # or have alternative rules for building them. Other rules in the build system
1044 # should depend on the files in the build folder.
1046 # Merge light greylist from multiple files:
1047 # (1) manual greylist LOCAL_SRC_GREYLIST
1048 # (2) list of usages from vendor apps LOCAL_SRC_VENDOR_LIST
1049 # (3) list of removed APIs in LOCAL_SRC_REMOVED_API
1050 # @removed does not imply private in Doclava. We must take the subset also
1051 # in LOCAL_SRC_PRIVATE_API.
1052 # (4) list of serialization APIs
1053 # Automatically adds all methods which match the signatures in
1054 # REGEX_SERIALIZATION. These are greylisted in order to allow applications
1055 # to write their own serializers.
1056 $(LOCAL_LIGHT_GREYLIST): REGEX_SERIALIZATION := \
1057 "readObject\(Ljava/io/ObjectInputStream;\)V" \
1058 "readObjectNoData\(\)V" \
1059 "readResolve\(\)Ljava/lang/Object;" \
1060 "serialVersionUID:J" \
1061 "serialPersistentFields:\[Ljava/io/ObjectStreamField;" \
1062 "writeObject\(Ljava/io/ObjectOutputStream;\)V" \
1063 "writeReplace\(\)Ljava/lang/Object;"
1064 $(LOCAL_LIGHT_GREYLIST): $(LOCAL_SRC_ALL)
1065 sort $(LOCAL_SRC_GREYLIST) $(LOCAL_SRC_VENDOR_LIST) \
1066 <(grep -E "\->("$(subst $(space),"|",$(REGEX_SERIALIZATION))")$$" \
1067 $(LOCAL_SRC_PRIVATE_API)) \
1068 <(comm -12 <(sort $(LOCAL_SRC_REMOVED_API)) <(sort $(LOCAL_SRC_PRIVATE_API))) \
1070 $(call assert-has-no-duplicates,$@)
1071 $(call assert-is-subset,$@,$(LOCAL_SRC_PRIVATE_API))
1072 $(call assert-has-no-overlap,$@,$(LOCAL_SRC_FORCE_BLACKLIST))
1074 # Generate dark greylist as remaining classes and class members in the same
1075 # package as classes listed in the light greylist.
1076 # The algorithm is as follows:
1077 # (1) extract the class descriptor from each entry in LOCAL_LIGHT_GREYLIST
1078 # (2) strip everything after the last forward-slash,
1079 # e.g. 'Lpackage/subpackage/class$inner;' turns into 'Lpackage/subpackage/'
1080 # (3) insert all entries from LOCAL_SRC_PRIVATE_API which begin with the package
1081 # name but do not contain another forward-slash in the class name, e.g.
1082 # matching '^Lpackage/subpackage/[^/;]*;'
1083 # (4) subtract entries shared with LOCAL_LIGHT_GREYLIST
1084 $(LOCAL_DARK_GREYLIST): $(LOCAL_SRC_ALL) $(LOCAL_LIGHT_GREYLIST)
1085 comm -13 <(sort $(LOCAL_LIGHT_GREYLIST) $(LOCAL_SRC_FORCE_BLACKLIST)) \
1086 <(cat $(LOCAL_SRC_PUBLIC_API) $(LOCAL_LIGHT_GREYLIST) | \
1087 sed 's/\->.*//' | sed 's/\(.*\/\).*/\1/' | sort | uniq | \
1088 while read PKG_NAME; do \
1089 grep -E "^$${PKG_NAME}[^/;]*;" $(LOCAL_SRC_PRIVATE_API); \
1090 done | sort | uniq) \
1092 $(call assert-is-subset,$@,$(LOCAL_SRC_PRIVATE_API))
1093 $(call assert-has-no-duplicates,$@)
1094 $(call assert-has-no-overlap,$@,$(LOCAL_LIGHT_GREYLIST))
1095 $(call assert-has-no-overlap,$@,$(LOCAL_SRC_FORCE_BLACKLIST))
1097 # Generate blacklist as private API minus (light greylist plus dark greylist).
1098 $(LOCAL_BLACKLIST): $(LOCAL_SRC_ALL) $(LOCAL_LIGHT_GREYLIST) $(LOCAL_DARK_GREYLIST)
1099 comm -13 <(sort $(LOCAL_LIGHT_GREYLIST) $(LOCAL_DARK_GREYLIST)) \
1100 <(sort $(LOCAL_SRC_PRIVATE_API)) \
1102 $(call assert-is-subset,$@,$(LOCAL_SRC_PRIVATE_API))
1103 $(call assert-has-no-duplicates,$@)
1104 $(call assert-has-no-overlap,$@,$(LOCAL_LIGHT_GREYLIST))
1105 $(call assert-has-no-overlap,$@,$(LOCAL_DARK_GREYLIST))
1106 $(call assert-is-subset,$(LOCAL_SRC_FORCE_BLACKLIST),$@)
1108 # Include subdirectory makefiles
1109 # ============================================================
1111 # If we're building with ONE_SHOT_MAKEFILE (mm, mmm), then what the framework
1112 # team really wants is to build the stuff defined by this makefile.
1113 ifeq (,$(ONE_SHOT_MAKEFILE))
1114 include $(call first-makefiles-under,$(LOCAL_PATH))
1117 endif # ANDROID_BUILD_EMBEDDED