Android.mk

   1 #
   2 # Copyright (C) 2008 The Android Open Source Project
   3 #
   4 # Licensed under the Apache License, Version 2.0 (the "License");
   5 # you may not use this file except in compliance with the License.
   6 # You may obtain a copy of the License at
   7 #
   8 #      http://www.apache.org/licenses/LICENSE-2.0
   9 #
  10 # Unless required by applicable law or agreed to in writing, software
  11 # distributed under the License is distributed on an "AS IS" BASIS,
  12 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13 # See the License for the specific language governing permissions and
  14 # limitations under the License.
  15 #
  16 LOCAL_PATH := $(call my-dir)
  17
  18 # Load framework-specific path mappings used later in the build.
  19 include $(LOCAL_PATH)/pathmap.mk
  20
  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
  28 ifneq ($(ANDROID_BUILD_EMBEDDED),true)
  29
  30 # Copy AIDL files to be preprocessed and included in the SDK,
  31 # specified relative to the root of the build tree.
  32 # ============================================================
  33 include $(CLEAR_VARS)
  34
  35 aidl_parcelables :=
  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: $$@
  41         rm -f $$@
  42         $(HOST_OUT_EXECUTABLES)/sdkparcelables $$< $$@
  43 endef
  44
  45 $(foreach stubs,android_stubs_current android_test_stubs_current android_system_stubs_current,\
  46   $(eval $(call stubs-to-aidl-parcelables,$(stubs))))
  47
  48 gen := $(TARGET_OUT_COMMON_INTERMEDIATES)/framework.aidl
  49 .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,$@)
  55
  56 # the documentation
  57 # ============================================================
  58
  59 # TODO: deal with com/google/android/googleapps
  60 packages_to_document := \
  61   android \
  62   javax/microedition/khronos \
  63   org/apache/http/conn \
  64   org/apache/http/params \
  65
  66 # include definition of libcore_to_document
  67 include libcore/Docs.mk
  68
  69 non_base_dirs := \
  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 \
  74
  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, \
  79     $(non_base_dirs) \
  80   )
  81
  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 += \
  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
  93 files_to_check_apis_generated := \
  94   $(filter $(OUT_DIR)/%,\
  95     $(SOONG_FRAMEWORK_SRCS))
  96
  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,\
 102     test-base/src \
 103     test-mock/src \
 104     test-runner/src)
 105
 106 # These are relative to frameworks/base
 107 html_dirs := \
 108         $(FRAMEWORKS_BASE_SUBDIRS) \
 109         $(non_base_dirs) \
 110
 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)) \
 115
 116 # These are relative to frameworks/base
 117 framework_docs_LOCAL_SRC_FILES := \
 118   $(files_to_document) \
 119   $(common_src_files) \
 120
 121 # These are relative to frameworks/base
 122 framework_docs_LOCAL_API_CHECK_SRC_FILES := \
 123   $(files_to_check_apis) \
 124   $(common_src_files) \
 125
 126 # This is used by ide.mk as the list of source files that are
 127 # always included.
 128 INTERNAL_SDK_SOURCE_DIRS := $(addprefix $(LOCAL_PATH)/,$(dirs_to_document))
 129
 130 framework_docs_LOCAL_DROIDDOC_SOURCE_PATH := \
 131         $(FRAMEWORKS_BASE_JAVA_SRC_DIRS)
 132
 133 framework_docs_LOCAL_SRCJARS := $(SOONG_FRAMEWORK_SRCJARS)
 134
 135 framework_docs_LOCAL_GENERATED_SOURCES := \
 136   $(libcore_to_document_generated) \
 137   $(files_to_check_apis_generated) \
 138
 139 framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES := \
 140         core-oj \
 141         core-libart \
 142         conscrypt \
 143         bouncycastle \
 144         okhttp \
 145         ext \
 146         framework \
 147         voip-common \
 148
 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)
 154
 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.
 159 #
 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 := \
 163     -android \
 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 ./frameworks/base/api/current.txt P \
 200     -werror -lerror -hide 111 -hide 113 -hide 125 -hide 126 -hide 127 -hide 128 \
 201     -overview $(LOCAL_PATH)/core/java/overview.html \
 202
 203 framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR:= \
 204         $(call intermediates-dir-for,JAVA_LIBRARIES,framework,,COMMON)
 205
 206 framework_docs_LOCAL_ADDITIONAL_JAVA_DIR:= \
 207         $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
 208
 209 framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES := \
 210     frameworks/base/docs/knowntags.txt \
 211     $(libcore_to_document_generated)
 212
 213 samples_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.
 218 sample_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 \
 228                  -samplegroup System \
 229                  -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)
 236 framework_docs_SDK_VERSION:=7.0
 237   # release version (ie "Release x")  (full releases only)
 238 framework_docs_SDK_REL_ID:=1
 239
 240 framework_docs_LOCAL_DROIDDOC_OPTIONS += \
 241                 -hdf dac true \
 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) \
 246                 -hdf sdk.preview 0 \
 247                 -resourcesdir $(LOCAL_PATH)/docs/html/reference/images/ \
 248                 -resourcesoutdir reference/android/images/
 249
 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
 254
 255 # ====  Public API diff ===========================
 256 include $(CLEAR_VARS)
 257
 258 LOCAL_SRC_FILES := $(framework_docs_LOCAL_API_CHECK_SRC_FILES)
 259 LOCAL_GENERATED_SOURCES := $(framework_docs_LOCAL_GENERATED_SOURCES)
 260 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
 261 LOCAL_JAVA_LIBRARIES := $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
 262 LOCAL_MODULE_CLASS := $(framework_docs_LOCAL_MODULE_CLASS)
 263 LOCAL_ADDITIONAL_JAVA_DIR := $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
 264 LOCAL_ADDITIONAL_DEPENDENCIES := \
 265         $(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) \
 266         $(INTERNAL_PLATFORM_API_FILE)
 267
 268 LOCAL_MODULE := offline-sdk-referenceonly
 269
 270 last_released_sdk_version := $(lastword $(call numerically_sort, \
 271                         $(filter-out current, \
 272                                 $(patsubst $(SRC_API_DIR)/%.txt,%, $(wildcard $(SRC_API_DIR)/*.txt)) \
 273                          )\
 274                 ))
 275
 276 LOCAL_APIDIFF_OLDAPI := $(LOCAL_PATH)/../../$(SRC_API_DIR)/$(last_released_sdk_version)
 277 LOCAL_APIDIFF_NEWAPI := $(LOCAL_PATH)/../../$(basename $(INTERNAL_PLATFORM_API_FILE))
 278
 279 include $(BUILD_APIDIFF)
 280
 281 # Hack to get diffs included in docs output
 282 out_zip := $(OUT_DOCS)/$(LOCAL_MODULE)-docs.zip
 283 $(out_zip): $(full_target)
 284
 285 # ====  System API diff ===========================
 286 include $(CLEAR_VARS)
 287
 288 LOCAL_SRC_FILES := $(framework_docs_LOCAL_API_CHECK_SRC_FILES)
 289 LOCAL_GENERATED_SOURCES := $(framework_docs_LOCAL_GENERATED_SOURCES)
 290 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
 291 LOCAL_JAVA_LIBRARIES := $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
 292 LOCAL_MODULE_CLASS := $(framework_docs_LOCAL_MODULE_CLASS)
 293 LOCAL_ADDITIONAL_JAVA_DIR := $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
 294 LOCAL_ADDITIONAL_DEPENDENCIES := \
 295         $(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) \
 296         $(INTERNAL_PLATFORM_SYSTEM_API_FILE)
 297
 298 LOCAL_MODULE := offline-system-sdk-referenceonly
 299
 300 last_released_sdk_version := $(lastword $(call numerically_sort, \
 301                         $(filter-out current, \
 302                                 $(patsubst $(SRC_SYSTEM_API_DIR)/%.txt,%, $(wildcard $(SRC_SYSTEM_API_DIR)/*.txt)) \
 303                          )\
 304                 ))
 305
 306 LOCAL_APIDIFF_OLDAPI := $(LOCAL_PATH)/../../$(SRC_SYSTEM_API_DIR)/$(last_released_sdk_version)
 307 LOCAL_APIDIFF_NEWAPI := $(LOCAL_PATH)/../../$(basename $(INTERNAL_PLATFORM_SYSTEM_API_FILE))
 308
 309 include $(BUILD_APIDIFF)
 310
 311 # Hack to get diffs included in docs output
 312 out_zip := $(OUT_DOCS)/$(LOCAL_MODULE)-docs.zip
 313 $(out_zip): $(full_target)
 314
 315 # ====  the api stubs and current.xml ===========================
 316 include $(CLEAR_VARS)
 317
 318 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
 319 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
 320 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
 321 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
 322 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 323 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 324 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 325 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
 326 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 327
 328 LOCAL_MODULE := api-stubs
 329
 330 LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_stubs_current_intermediates/src
 331
 332 LOCAL_DROIDDOC_OPTIONS:=\
 333                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 334                 -referenceonly \
 335                 -api $(INTERNAL_PLATFORM_API_FILE) \
 336                 -removedApi $(INTERNAL_PLATFORM_REMOVED_API_FILE) \
 337                 -nodocs
 338
 339 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
 340
 341 LOCAL_UNINSTALLABLE_MODULE := true
 342
 343 include $(BUILD_DROIDDOC)
 344
 345 $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_API_FILE) \
 346                                           $(INTERNAL_PLATFORM_REMOVED_API_FILE)
 347 $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_API_FILE))
 348
 349 # ====  the system api stubs ===================================
 350 include $(CLEAR_VARS)
 351
 352 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
 353 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
 354 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
 355 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
 356 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 357 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 358 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 359 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
 360 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 361
 362 LOCAL_MODULE := system-api-stubs
 363
 364 LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_system_stubs_current_intermediates/src
 365
 366 LOCAL_DROIDDOC_OPTIONS:=\
 367                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 368                 -referenceonly \
 369                 -showAnnotation android.annotation.SystemApi \
 370                 -api $(INTERNAL_PLATFORM_SYSTEM_API_FILE) \
 371                 -removedApi $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE) \
 372                 -exactApi $(INTERNAL_PLATFORM_SYSTEM_EXACT_API_FILE) \
 373                 -nodocs
 374
 375 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
 376
 377 LOCAL_UNINSTALLABLE_MODULE := true
 378
 379 include $(BUILD_DROIDDOC)
 380
 381 $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_SYSTEM_API_FILE) \
 382                                           $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE) \
 383                                           $(INTERNAL_PLATFORM_SYSTEM_EXACT_API_FILE)
 384 $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_SYSTEM_API_FILE))
 385
 386 # ====  the test api stubs ===================================
 387 include $(CLEAR_VARS)
 388
 389 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
 390 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
 391 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
 392 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
 393 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 394 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 395 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 396 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
 397 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 398
 399 LOCAL_MODULE := test-api-stubs
 400
 401 LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src
 402
 403 LOCAL_DROIDDOC_OPTIONS:=\
 404                $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 405                -referenceonly \
 406                -stubs $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src \
 407                -showAnnotation android.annotation.TestApi \
 408                -api $(INTERNAL_PLATFORM_TEST_API_FILE) \
 409                -removedApi $(INTERNAL_PLATFORM_TEST_REMOVED_API_FILE) \
 410                -exactApi $(INTERNAL_PLATFORM_TEST_EXACT_API_FILE) \
 411                -nodocs
 412
 413 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
 414
 415 LOCAL_UNINSTALLABLE_MODULE := true
 416
 417 include $(BUILD_DROIDDOC)
 418
 419 $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_TEST_API_FILE) \
 420                                           $(INTERNAL_PLATFORM_TEST_REMOVED_API_FILE) \
 421                                           $(INTERNAL_PLATFORM_TEST_EXACT_API_FILE)
 422 $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_TEST_API_FILE))
 423
 424 # ====  the complete hidden api list ===================================
 425 include $(CLEAR_VARS)
 426
 427 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
 428 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
 429 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
 430 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
 431 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 432 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 433 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 434 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
 435 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 436
 437 LOCAL_MODULE := hidden-api-list
 438
 439 LOCAL_DROIDDOC_OPTIONS:=\
 440                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 441                 -referenceonly \
 442                 -showUnannotated \
 443                 -showAnnotation android.annotation.SystemApi \
 444                 -showAnnotation android.annotation.TestApi \
 445                 -privateDexApi $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) \
 446                 -nodocs
 447
 448 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
 449
 450 LOCAL_UNINSTALLABLE_MODULE := true
 451
 452 include $(BUILD_DROIDDOC)
 453
 454 $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE)
 455
 456 # ====  check javadoc comments but don't generate docs ========
 457 include $(CLEAR_VARS)
 458
 459 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 460 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
 461 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
 462 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 463 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 464 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 465 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 466 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 467 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 468
 469 LOCAL_MODULE := doc-comment-check
 470
 471 LOCAL_DROIDDOC_OPTIONS:=\
 472                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 473                 -referenceonly \
 474                 -parsecomments
 475
 476 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
 477
 478 LOCAL_UNINSTALLABLE_MODULE := true
 479
 480 include $(BUILD_DROIDDOC)
 481
 482 # Run this for checkbuild
 483 checkbuild: doc-comment-check-docs
 484 # Check comment when you are updating the API
 485 update-api: doc-comment-check-docs
 486
 487 # ====  static html in the sdk ==================================
 488 include $(CLEAR_VARS)
 489
 490 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 491 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
 492 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
 493 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 494 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 495 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 496 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 497 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 498 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 499
 500 LOCAL_MODULE := offline-sdk
 501
 502 LOCAL_DROIDDOC_OPTIONS:=\
 503                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 504                 -offlinemode \
 505                 -title "Android SDK" \
 506                 -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \
 507                 -sdkvalues $(OUT_DOCS) \
 508                 -hdf android.whichdoc offline
 509
 510 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
 511
 512 include $(BUILD_DROIDDOC)
 513
 514 static_doc_index_redirect := $(out_dir)/index.html
 515 $(static_doc_index_redirect): \
 516         $(LOCAL_PATH)/docs/docs-preview-index.html | $(ACP)
 517         $(hide) mkdir -p $(dir $@)
 518         $(hide) $(ACP) $< $@
 519
 520 $(full_target): $(static_doc_index_redirect)
 521
 522
 523 # ==== Public API static reference docs ==================================
 524 include $(CLEAR_VARS)
 525
 526 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 527 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
 528 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
 529 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 530 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 531 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 532 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 533 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 534 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 535
 536 LOCAL_MODULE := offline-sdk-referenceonly
 537
 538 LOCAL_DROIDDOC_OPTIONS:=\
 539                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 540                 -offlinemode \
 541                 -title "Android SDK" \
 542                 -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \
 543                 -sdkvalues $(OUT_DOCS) \
 544                 -hdf android.whichdoc offline \
 545                 -referenceonly
 546
 547 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
 548
 549 include $(BUILD_DROIDDOC)
 550
 551 static_doc_index_redirect := $(out_dir)/index.html
 552 $(static_doc_index_redirect): $(LOCAL_PATH)/docs/docs-documentation-redirect.html
 553         $(copy-file-to-target)
 554
 555 static_doc_properties := $(out_dir)/source.properties
 556 $(static_doc_properties): \
 557         $(LOCAL_PATH)/docs/source.properties | $(ACP)
 558         $(hide) mkdir -p $(dir $@)
 559         $(hide) $(ACP) $< $@
 560
 561 $(full_target): $(static_doc_index_redirect)
 562 $(full_target): $(static_doc_properties)
 563
 564
 565 # ==== System API static reference docs ==================================
 566 include $(CLEAR_VARS)
 567
 568 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 569 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
 570 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
 571 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 572 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 573 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 574 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 575 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 576 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 577
 578 LOCAL_MODULE := offline-system-sdk-referenceonly
 579
 580 LOCAL_DROIDDOC_OPTIONS:=\
 581                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 582                 -hide 101 -hide 104 -hide 108 \
 583                 -showAnnotation android.annotation.SystemApi \
 584                 -offlinemode \
 585                 -title "Android System SDK" \
 586                 -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \
 587                 -sdkvalues $(OUT_DOCS) \
 588                 -hdf android.whichdoc offline \
 589                 -referenceonly
 590
 591 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
 592
 593 include $(BUILD_DROIDDOC)
 594
 595 static_doc_index_redirect := $(out_dir)/index.html
 596 $(static_doc_index_redirect): $(LOCAL_PATH)/docs/docs-documentation-redirect.html
 597         $(copy-file-to-target)
 598
 599 static_doc_properties := $(out_dir)/source.properties
 600 $(static_doc_properties): \
 601         $(LOCAL_PATH)/docs/source.properties | $(ACP)
 602         $(hide) mkdir -p $(dir $@)
 603         $(hide) $(ACP) $< $@
 604
 605 $(full_target): $(static_doc_index_redirect)
 606 $(full_target): $(static_doc_properties)
 607 $(full_target): $(framework_built)
 608
 609
 610 # ==== docs for the web (on the androiddevdocs app engine server) =======================
 611 include $(CLEAR_VARS)
 612
 613 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 614 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
 615 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
 616 LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
 617 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 618 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 619 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 620 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 621 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 622 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 623 LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
 624
 625 LOCAL_MODULE := online-sdk
 626
 627 LOCAL_DROIDDOC_OPTIONS:= \
 628                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 629                 -toroot / \
 630                 -hdf android.whichdoc online \
 631                 $(sample_groups) \
 632                 -hdf android.hasSamples true \
 633                 -samplesdir $(samples_dir)
 634
 635 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
 636
 637 include $(BUILD_DROIDDOC)
 638
 639 # ==== docs for the web (on the androiddevdocs app engine server) =======================
 640 include $(CLEAR_VARS)
 641
 642 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 643 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
 644 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
 645 LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
 646 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 647 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 648 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 649 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 650 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 651 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 652 LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
 653
 654 LOCAL_MODULE := online-system-api-sdk
 655
 656 LOCAL_DROIDDOC_OPTIONS:= \
 657                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 658                 -referenceonly \
 659                 -showAnnotation android.annotation.SystemApi \
 660                 -title "Android SDK - Including system APIs." \
 661                 -toroot / \
 662                 -hide 101 \
 663                 -hide 104 \
 664                 -hide 108 \
 665                 -hdf android.whichdoc online \
 666                 $(sample_groups) \
 667                 -hdf android.hasSamples true \
 668                 -samplesdir $(samples_dir)
 669
 670 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
 671
 672 LOCAL_UNINSTALLABLE_MODULE := true
 673
 674 include $(BUILD_DROIDDOC)
 675
 676 # ==== docs for the web (on the devsite app engine server) =======================
 677 include $(CLEAR_VARS)
 678 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 679 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
 680 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
 681 LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
 682 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 683 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 684 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 685 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 686 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 687 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 688 # specify a second html input dir and an output path relative to OUT_DIR)
 689 LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
 690
 691 LOCAL_MODULE := ds
 692
 693 LOCAL_DROIDDOC_OPTIONS:= \
 694                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 695                 -toroot / \
 696                 -hdf android.whichdoc online \
 697                 -devsite \
 698                 -yamlV2 \
 699                 $(sample_groups) \
 700                 -hdf android.hasSamples true \
 701                 -samplesdir $(samples_dir)
 702
 703 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
 704
 705 include $(BUILD_DROIDDOC)
 706
 707 # ==== docs for the web (on the devsite app engine server) =======================
 708 include $(CLEAR_VARS)
 709 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 710 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
 711 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
 712 LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
 713 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 714 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 715 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 716 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 717 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 718 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 719 # specify a second html input dir and an output path relative to OUT_DIR)
 720 LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
 721
 722 LOCAL_MODULE := ds-static
 723
 724 LOCAL_DROIDDOC_OPTIONS:= \
 725                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 726                 -hdf android.whichdoc online \
 727                 -staticonly \
 728                 -toroot / \
 729                 -devsite \
 730                 -ignoreJdLinks
 731
 732 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
 733
 734 include $(BUILD_DROIDDOC)
 735
 736 # ==== generates full navtree for resolving @links in ds postprocessing ====
 737 include $(CLEAR_VARS)
 738
 739 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 740 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
 741 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
 742 LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
 743 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 744 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 745 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 746 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 747 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 748
 749 LOCAL_MODULE := ds-ref-navtree
 750
 751 LOCAL_DROIDDOC_OPTIONS:= \
 752                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 753                 -hdf android.whichdoc online \
 754                 -toroot / \
 755                 -atLinksNavtree \
 756                 -navtreeonly
 757
 758 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
 759
 760 include $(BUILD_DROIDDOC)
 761
 762 # ==== site updates for docs (on the androiddevdocs app engine server) =======================
 763 include $(CLEAR_VARS)
 764
 765 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 766 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
 767 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
 768 LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
 769 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 770 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 771 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 772 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 773 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 774 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 775 LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
 776
 777 LOCAL_MODULE := online-sdk-dev
 778
 779 LOCAL_DROIDDOC_OPTIONS:= \
 780                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 781                 -toroot / \
 782                 -hdf android.whichdoc online \
 783                 $(sample_groups) \
 784                 -hdf android.hasSamples true \
 785                 -samplesdir $(samples_dir)
 786
 787 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
 788
 789 include $(BUILD_DROIDDOC)
 790
 791 # ==== docs that have all of the stuff that's @hidden =======================
 792 include $(CLEAR_VARS)
 793
 794 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 795 LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
 796 LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
 797 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 798 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 799 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 800 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 801 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 802 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 803
 804 LOCAL_MODULE := hidden
 805 LOCAL_DROIDDOC_OPTIONS:=\
 806                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 807                 -referenceonly \
 808                 -title "Android SDK - Including hidden APIs."
 809 #               -hidden
 810
 811 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
 812
 813 include $(BUILD_DROIDDOC)
 814
 815 # ====  java proto host library  ==============================
 816 include $(CLEAR_VARS)
 817 LOCAL_MODULE := platformprotos
 818 LOCAL_PROTOC_OPTIMIZE_TYPE := full
 819 LOCAL_PROTOC_FLAGS := \
 820     -Iexternal/protobuf/src
 821 LOCAL_SOURCE_FILES_ALL_GENERATED := true
 822 LOCAL_SRC_FILES := \
 823     cmds/am/proto/instrumentation_data.proto \
 824     cmds/statsd/src/perfetto/perfetto_config.proto \
 825     $(call all-proto-files-under, core/proto) \
 826     $(call all-proto-files-under, libs/incident/proto) \
 827     $(call all-proto-files-under, cmds/statsd/src)
 828 # b/72714520
 829 LOCAL_ERROR_PRONE_FLAGS := -Xep:MissingOverride:OFF
 830 include $(BUILD_HOST_JAVA_LIBRARY)
 831
 832 # ====  java proto device library (for test only)  ==============================
 833 include $(CLEAR_VARS)
 834 LOCAL_MODULE := platformprotosnano
 835 LOCAL_MODULE_TAGS := tests
 836 LOCAL_PROTOC_OPTIMIZE_TYPE := nano
 837 LOCAL_PROTOC_FLAGS := \
 838     -Iexternal/protobuf/src
 839 LOCAL_PROTO_JAVA_OUTPUT_PARAMS := \
 840     store_unknown_fields = true
 841 LOCAL_SDK_VERSION := current
 842 LOCAL_SRC_FILES := \
 843     $(call all-proto-files-under, core/proto) \
 844     $(call all-proto-files-under, libs/incident/proto/android/os)
 845 include $(BUILD_STATIC_JAVA_LIBRARY)
 846
 847
 848 # ====  java proto device library (for test only)  ==============================
 849 include $(CLEAR_VARS)
 850 LOCAL_MODULE := platformprotoslite
 851 LOCAL_MODULE_TAGS := tests
 852 LOCAL_PROTOC_OPTIMIZE_TYPE := lite
 853 LOCAL_PROTOC_FLAGS := \
 854     -Iexternal/protobuf/src
 855 LOCAL_SRC_FILES := \
 856     $(call all-proto-files-under, core/proto) \
 857     $(call all-proto-files-under, libs/incident/proto/android/os)
 858 # Protos have lots of MissingOverride and similar.
 859 LOCAL_ERROR_PRONE_FLAGS := -XepDisableAllChecks
 860 include $(BUILD_STATIC_JAVA_LIBRARY)
 861
 862 # ==== hiddenapi lists =======================================
 863
 864 # Copy blacklist and light greylist over into the build folder.
 865 # This is for ART buildbots which need to mock these lists and have alternative
 866 # rules for building them. Other rules in the build system should depend on the
 867 # files in the build folder.
 868
 869 $(eval $(call copy-one-file,frameworks/base/config/hiddenapi-blacklist.txt,\
 870                             $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST)))
 871
 872 # Temporarily merge light greylist from two files. Vendor list will become dark
 873 # grey once we remove the UI toast.
 874 $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST): frameworks/base/config/hiddenapi-light-greylist.txt \
 875                                                frameworks/base/config/hiddenapi-vendor-list.txt
 876         sort $^ > $@
 877
 878 # Generate dark greylist as private API minus (blacklist plus light greylist).
 879
 880 $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST): PRIVATE_API := $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE)
 881 $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST): BLACKLIST := $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST)
 882 $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST): LIGHT_GREYLIST := $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST)
 883 $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST): $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) \
 884                                               $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST) \
 885                                               $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST)
 886         if [ ! -z "`comm -12 <(sort $(BLACKLIST)) <(sort $(LIGHT_GREYLIST))`" ]; then \
 887                 echo "There should be no overlap between $(BLACKLIST) and $(LIGHT_GREYLIST)" 1>&2; \
 888                 exit 1; \
 889         elif [ ! -z "`comm -13 <(sort $(PRIVATE_API)) <(sort $(BLACKLIST))`" ]; then \
 890                 echo "$(BLACKLIST) must be a subset of $(PRIVATE_API)" 1>&2; \
 891                 exit 2; \
 892         elif [ ! -z "`comm -13 <(sort $(PRIVATE_API)) <(sort $(LIGHT_GREYLIST))`" ]; then \
 893                 echo "$(LIGHT_GREYLIST) must be a subset of $(PRIVATE_API)" 1>&2; \
 894                 exit 3; \
 895         fi
 896         comm -23 <(sort $(PRIVATE_API)) <(sort $(BLACKLIST) $(LIGHT_GREYLIST)) > $@
 897
 898 # Include subdirectory makefiles
 899 # ============================================================
 900
 901 # If we're building with ONE_SHOT_MAKEFILE (mm, mmm), then what the framework
 902 # team really wants is to build the stuff defined by this makefile.
 903 ifeq (,$(ONE_SHOT_MAKEFILE))
 904 include $(call first-makefiles-under,$(LOCAL_PATH))
 905 endif
 906
 907 endif # ANDROID_BUILD_EMBEDDED
 908