| # |
| # Copyright (C) 2008 The Android Open Source Project |
| # |
| # Licensed under the Apache License, Version 2.0 (the "License"); |
| # you may not use this file except in compliance with the License. |
| # You may obtain a copy of the License at |
| # |
| # http://www.apache.org/licenses/LICENSE-2.0 |
| # |
| # Unless required by applicable law or agreed to in writing, software |
| # distributed under the License is distributed on an "AS IS" BASIS, |
| # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| # See the License for the specific language governing permissions and |
| # limitations under the License. |
| # |
| LOCAL_PATH := $(call my-dir) |
| |
| # Load framework-specific path mappings used later in the build. |
| include $(LOCAL_PATH)/pathmap.mk |
| |
| # Build the master framework library. |
| # The framework contains too many method references (>64K) for poor old DEX. |
| # So we first build the framework as a monolithic static library then split it |
| # up into smaller pieces. |
| # ============================================================ |
| |
| # embedded builds use nothing in frameworks/base |
| ifneq ($(ANDROID_BUILD_EMBEDDED),true) |
| |
| # Copy AIDL files to be preprocessed and included in the SDK, |
| # specified relative to the root of the build tree. |
| # ============================================================ |
| include $(CLEAR_VARS) |
| |
| aidl_parcelables := |
| define stubs-to-aidl-parcelables |
| gen := $(TARGET_OUT_COMMON_INTERMEDIATES)/$1.aidl |
| aidl_parcelables += $$(gen) |
| $$(gen): $(call java-lib-header-files,$1) $(HOST_OUT_EXECUTABLES)/sdkparcelables |
| @echo Extract SDK parcelables: $$@ |
| rm -f $$@ |
| $(HOST_OUT_EXECUTABLES)/sdkparcelables $$< $$@ |
| endef |
| |
| $(foreach stubs,android_stubs_current android_test_stubs_current android_system_stubs_current,\ |
| $(eval $(call stubs-to-aidl-parcelables,$(stubs)))) |
| |
| gen := $(TARGET_OUT_COMMON_INTERMEDIATES)/framework.aidl |
| .KATI_RESTAT: $(gen) |
| $(gen): $(aidl_parcelables) |
| @echo Combining SDK parcelables: $@ |
| rm -f $@.tmp |
| cat $^ | sort -u > $@.tmp |
| $(call commit-change-for-toc,$@) |
| |
| # the documentation |
| # ============================================================ |
| |
| # TODO: deal with com/google/android/googleapps |
| packages_to_document := \ |
| android \ |
| javax/microedition/khronos \ |
| org/apache/http/conn \ |
| org/apache/http/params \ |
| |
| # include definition of libcore_to_document |
| include libcore/Docs.mk |
| |
| non_base_dirs := \ |
| ../opt/telephony/src/java/android/telephony \ |
| ../opt/telephony/src/java/android/telephony/gsm \ |
| ../opt/net/voip/src/java/android/net/rtp \ |
| ../opt/net/voip/src/java/android/net/sip \ |
| |
| # Find all files in specific directories (relative to frameworks/base) |
| # to document and check apis |
| files_to_check_apis := \ |
| $(call find-other-java-files, \ |
| $(non_base_dirs) \ |
| ) |
| |
| # Find all files in specific packages that were used to compile |
| # framework.jar to document and check apis |
| files_to_check_apis += \ |
| $(addprefix ../../,\ |
| $(filter \ |
| $(foreach dir,$(FRAMEWORKS_BASE_JAVA_SRC_DIRS),\ |
| $(foreach package,$(packages_to_document),\ |
| $(dir)/$(package)/%.java)),\ |
| $(SOONG_FRAMEWORK_SRCS))) |
| |
| # Find all generated files that were used to compile framework.jar |
| files_to_check_apis_generated := \ |
| $(filter $(OUT_DIR)/%,\ |
| $(SOONG_FRAMEWORK_SRCS)) |
| |
| # These are relative to frameworks/base |
| # FRAMEWORKS_BASE_SUBDIRS comes from build/core/pathmap.mk |
| files_to_document := \ |
| $(files_to_check_apis) \ |
| $(call find-other-java-files,\ |
| test-base/src \ |
| test-mock/src \ |
| test-runner/src) |
| |
| # These are relative to frameworks/base |
| html_dirs := \ |
| $(FRAMEWORKS_BASE_SUBDIRS) \ |
| $(non_base_dirs) \ |
| |
| # Common sources for doc check and api check |
| common_src_files := \ |
| $(call find-other-html-files, $(html_dirs)) \ |
| $(addprefix ../../, $(libcore_to_document)) \ |
| |
| # These are relative to frameworks/base |
| framework_docs_LOCAL_SRC_FILES := \ |
| $(files_to_document) \ |
| $(common_src_files) \ |
| |
| # These are relative to frameworks/base |
| framework_docs_LOCAL_API_CHECK_SRC_FILES := \ |
| $(files_to_check_apis) \ |
| $(common_src_files) \ |
| |
| # This is used by ide.mk as the list of source files that are |
| # always included. |
| INTERNAL_SDK_SOURCE_DIRS := $(addprefix $(LOCAL_PATH)/,$(dirs_to_document)) |
| |
| framework_docs_LOCAL_DROIDDOC_SOURCE_PATH := \ |
| $(FRAMEWORKS_BASE_JAVA_SRC_DIRS) |
| |
| framework_docs_LOCAL_SRCJARS := $(SOONG_FRAMEWORK_SRCJARS) |
| |
| framework_docs_LOCAL_GENERATED_SOURCES := \ |
| $(libcore_to_document_generated) \ |
| $(files_to_check_apis_generated) \ |
| |
| framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES := \ |
| core-oj \ |
| core-libart \ |
| conscrypt \ |
| bouncycastle \ |
| okhttp \ |
| ext \ |
| framework \ |
| voip-common \ |
| |
| # Platform docs can refer to Support Library APIs, but we don't actually build |
| # them as part of the docs target, so we need to include them on the classpath. |
| framework_docs_LOCAL_JAVA_LIBRARIES := \ |
| $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) \ |
| $(FRAMEWORKS_SUPPORT_JAVA_LIBRARIES) |
| |
| framework_docs_LOCAL_MODULE_CLASS := JAVA_LIBRARIES |
| framework_docs_LOCAL_DROIDDOC_HTML_DIR := docs/html |
| # The since flag (-since N.xml API_LEVEL) is used to add API Level information |
| # to the reference documentation. Must be in order of oldest to newest. |
| # |
| # Conscrypt (com.android.org.conscrypt) is an implementation detail and should |
| # not be referenced in the documentation. |
| framework_docs_LOCAL_DROIDDOC_OPTIONS := \ |
| -android \ |
| -knowntags ./frameworks/base/docs/knowntags.txt \ |
| -knowntags ./libcore/known_oj_tags.txt \ |
| -manifest ./frameworks/base/core/res/AndroidManifest.xml \ |
| -hidePackage com.android.internal \ |
| -hidePackage com.android.internal.util \ |
| -hidePackage com.android.okhttp \ |
| -hidePackage com.android.org.conscrypt \ |
| -hidePackage com.android.server \ |
| -since $(SRC_API_DIR)/1.xml 1 \ |
| -since $(SRC_API_DIR)/2.xml 2 \ |
| -since $(SRC_API_DIR)/3.xml 3 \ |
| -since $(SRC_API_DIR)/4.xml 4 \ |
| -since $(SRC_API_DIR)/5.xml 5 \ |
| -since $(SRC_API_DIR)/6.xml 6 \ |
| -since $(SRC_API_DIR)/7.xml 7 \ |
| -since $(SRC_API_DIR)/8.xml 8 \ |
| -since $(SRC_API_DIR)/9.xml 9 \ |
| -since $(SRC_API_DIR)/10.xml 10 \ |
| -since $(SRC_API_DIR)/11.xml 11 \ |
| -since $(SRC_API_DIR)/12.xml 12 \ |
| -since $(SRC_API_DIR)/13.xml 13 \ |
| -since $(SRC_API_DIR)/14.txt 14 \ |
| -since $(SRC_API_DIR)/15.txt 15 \ |
| -since $(SRC_API_DIR)/16.txt 16 \ |
| -since $(SRC_API_DIR)/17.txt 17 \ |
| -since $(SRC_API_DIR)/18.txt 18 \ |
| -since $(SRC_API_DIR)/19.txt 19 \ |
| -since $(SRC_API_DIR)/20.txt 20 \ |
| -since $(SRC_API_DIR)/21.txt 21 \ |
| -since $(SRC_API_DIR)/22.txt 22 \ |
| -since $(SRC_API_DIR)/23.txt 23 \ |
| -since $(SRC_API_DIR)/24.txt 24 \ |
| -since $(SRC_API_DIR)/25.txt 25 \ |
| -since $(SRC_API_DIR)/26.txt 26 \ |
| -since $(SRC_API_DIR)/27.txt 27 \ |
| -since ./frameworks/base/api/current.txt P \ |
| -werror -lerror -hide 111 -hide 113 -hide 125 -hide 126 -hide 127 -hide 128 \ |
| -overview $(LOCAL_PATH)/core/java/overview.html \ |
| |
| framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR:= \ |
| $(call intermediates-dir-for,JAVA_LIBRARIES,framework,,COMMON) |
| |
| framework_docs_LOCAL_ADDITIONAL_JAVA_DIR:= \ |
| $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| |
| framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES := \ |
| frameworks/base/docs/knowntags.txt \ |
| $(libcore_to_document_generated) |
| |
| samples_dir := development/samples/browseable |
| |
| # Whitelist of valid groups, used for default TOC grouping. Each sample must |
| # belong to one (and only one) group. Assign samples to groups by setting |
| # a sample.group var to one of these groups in the sample's _index.jd. |
| sample_groups := -samplegroup Admin \ |
| -samplegroup Background \ |
| -samplegroup Connectivity \ |
| -samplegroup Content \ |
| -samplegroup Input \ |
| -samplegroup Media \ |
| -samplegroup Notification \ |
| -samplegroup RenderScript \ |
| -samplegroup Security \ |
| -samplegroup Sensors \ |
| -samplegroup System \ |
| -samplegroup Testing \ |
| -samplegroup UI \ |
| -samplegroup Views \ |
| -samplegroup Wearable |
| |
| ## SDK version identifiers used in the published docs |
| # major[.minor] version for current SDK. (full releases only) |
| framework_docs_SDK_VERSION:=7.0 |
| # release version (ie "Release x") (full releases only) |
| framework_docs_SDK_REL_ID:=1 |
| |
| framework_docs_LOCAL_DROIDDOC_OPTIONS += \ |
| -hdf dac true \ |
| -hdf sdk.codename O \ |
| -hdf sdk.preview.version 1 \ |
| -hdf sdk.version $(framework_docs_SDK_VERSION) \ |
| -hdf sdk.rel.id $(framework_docs_SDK_REL_ID) \ |
| -hdf sdk.preview 0 \ |
| -resourcesdir $(LOCAL_PATH)/docs/html/reference/images/ \ |
| -resourcesoutdir reference/android/images/ |
| |
| # Federate Support Library references against local API file. |
| framework_docs_LOCAL_DROIDDOC_OPTIONS += \ |
| -federate SupportLib https://developer.android.com \ |
| -federationapi SupportLib prebuilts/sdk/current/support-api.txt |
| |
| # Federate AndroidX references against local API file. |
| framework_docs_LOCAL_DROIDDOC_OPTIONS += \ |
| -federate AndroidX https://developer.android.com \ |
| -federationapi AndroidX prebuilts/sdk/current/androidx-api.txt |
| |
| # ==== Public API diff =========================== |
| include $(CLEAR_VARS) |
| |
| LOCAL_SRC_FILES := $(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
| LOCAL_GENERATED_SOURCES := $(framework_docs_LOCAL_GENERATED_SOURCES) |
| LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| LOCAL_JAVA_LIBRARIES := $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| LOCAL_MODULE_CLASS := $(framework_docs_LOCAL_MODULE_CLASS) |
| LOCAL_ADDITIONAL_JAVA_DIR := $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| LOCAL_ADDITIONAL_DEPENDENCIES := \ |
| $(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) \ |
| $(INTERNAL_PLATFORM_API_FILE) |
| |
| LOCAL_MODULE := offline-sdk-referenceonly |
| |
| last_released_sdk_version := $(lastword $(call numerically_sort, \ |
| $(filter-out current, \ |
| $(patsubst $(SRC_API_DIR)/%.txt,%, $(wildcard $(SRC_API_DIR)/*.txt)) \ |
| )\ |
| )) |
| |
| LOCAL_APIDIFF_OLDAPI := $(LOCAL_PATH)/../../$(SRC_API_DIR)/$(last_released_sdk_version) |
| LOCAL_APIDIFF_NEWAPI := $(LOCAL_PATH)/../../$(basename $(INTERNAL_PLATFORM_API_FILE)) |
| |
| include $(BUILD_APIDIFF) |
| |
| # Hack to get diffs included in docs output |
| out_zip := $(OUT_DOCS)/$(LOCAL_MODULE)-docs.zip |
| $(out_zip): $(full_target) |
| |
| # ==== System API diff =========================== |
| include $(CLEAR_VARS) |
| |
| LOCAL_SRC_FILES := $(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
| LOCAL_GENERATED_SOURCES := $(framework_docs_LOCAL_GENERATED_SOURCES) |
| LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| LOCAL_JAVA_LIBRARIES := $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| LOCAL_MODULE_CLASS := $(framework_docs_LOCAL_MODULE_CLASS) |
| LOCAL_ADDITIONAL_JAVA_DIR := $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| LOCAL_ADDITIONAL_DEPENDENCIES := \ |
| $(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) \ |
| $(INTERNAL_PLATFORM_SYSTEM_API_FILE) |
| |
| LOCAL_MODULE := offline-system-sdk-referenceonly |
| |
| last_released_sdk_version := $(lastword $(call numerically_sort, \ |
| $(filter-out current, \ |
| $(patsubst $(SRC_SYSTEM_API_DIR)/%.txt,%, $(wildcard $(SRC_SYSTEM_API_DIR)/*.txt)) \ |
| )\ |
| )) |
| |
| LOCAL_APIDIFF_OLDAPI := $(LOCAL_PATH)/../../$(SRC_SYSTEM_API_DIR)/$(last_released_sdk_version) |
| LOCAL_APIDIFF_NEWAPI := $(LOCAL_PATH)/../../$(basename $(INTERNAL_PLATFORM_SYSTEM_API_FILE)) |
| |
| include $(BUILD_APIDIFF) |
| |
| # Hack to get diffs included in docs output |
| out_zip := $(OUT_DOCS)/$(LOCAL_MODULE)-docs.zip |
| $(out_zip): $(full_target) |
| |
| $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_API_FILE)) |
| $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_SYSTEM_API_FILE)) |
| $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_TEST_API_FILE)) |
| |
| # ==== the complete hidden api list =================================== |
| include $(CLEAR_VARS) |
| |
| LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
| LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
| LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| |
| LOCAL_MODULE := hidden-api-list |
| |
| LOCAL_DROIDDOC_OPTIONS:=\ |
| $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| -referenceonly \ |
| -showUnannotated \ |
| -showAnnotation android.annotation.SystemApi \ |
| -showAnnotation android.annotation.TestApi \ |
| -privateDexApi $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) \ |
| -nodocs |
| |
| LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
| |
| LOCAL_UNINSTALLABLE_MODULE := true |
| |
| include $(BUILD_DROIDDOC) |
| |
| $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) |
| |
| # ==== check javadoc comments but don't generate docs ======== |
| include $(CLEAR_VARS) |
| |
| LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
| LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
| LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| |
| LOCAL_MODULE := doc-comment-check |
| |
| LOCAL_DROIDDOC_OPTIONS:=\ |
| $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| -referenceonly \ |
| -parsecomments |
| |
| LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
| |
| LOCAL_UNINSTALLABLE_MODULE := true |
| |
| include $(BUILD_DROIDDOC) |
| |
| # Run this for checkbuild |
| checkbuild: doc-comment-check-docs |
| # Check comment when you are updating the API |
| update-api: doc-comment-check-docs |
| |
| # ==== static html in the sdk ================================== |
| include $(CLEAR_VARS) |
| |
| LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
| LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
| LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| |
| LOCAL_MODULE := offline-sdk |
| |
| LOCAL_DROIDDOC_OPTIONS:=\ |
| $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| -offlinemode \ |
| -title "Android SDK" \ |
| -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \ |
| -sdkvalues $(OUT_DOCS) \ |
| -hdf android.whichdoc offline |
| |
| LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
| |
| include $(BUILD_DROIDDOC) |
| |
| static_doc_index_redirect := $(out_dir)/index.html |
| $(static_doc_index_redirect): \ |
| $(LOCAL_PATH)/docs/docs-preview-index.html | $(ACP) |
| $(hide) mkdir -p $(dir $@) |
| $(hide) $(ACP) $< $@ |
| |
| $(full_target): $(static_doc_index_redirect) |
| |
| |
| # ==== Public API static reference docs ================================== |
| include $(CLEAR_VARS) |
| |
| LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
| LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
| LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| |
| LOCAL_MODULE := offline-sdk-referenceonly |
| |
| LOCAL_DROIDDOC_OPTIONS:=\ |
| $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| -offlinemode \ |
| -title "Android SDK" \ |
| -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \ |
| -sdkvalues $(OUT_DOCS) \ |
| -hdf android.whichdoc offline \ |
| -referenceonly |
| |
| LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
| |
| include $(BUILD_DROIDDOC) |
| |
| static_doc_index_redirect := $(out_dir)/index.html |
| $(static_doc_index_redirect): $(LOCAL_PATH)/docs/docs-documentation-redirect.html |
| $(copy-file-to-target) |
| |
| static_doc_properties := $(out_dir)/source.properties |
| $(static_doc_properties): \ |
| $(LOCAL_PATH)/docs/source.properties | $(ACP) |
| $(hide) mkdir -p $(dir $@) |
| $(hide) $(ACP) $< $@ |
| |
| $(full_target): $(static_doc_index_redirect) |
| $(full_target): $(static_doc_properties) |
| |
| |
| # ==== System API static reference docs ================================== |
| include $(CLEAR_VARS) |
| |
| LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
| LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
| LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| |
| LOCAL_MODULE := offline-system-sdk-referenceonly |
| |
| LOCAL_DROIDDOC_OPTIONS:=\ |
| $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| -hide 101 -hide 104 -hide 108 \ |
| -showAnnotation android.annotation.SystemApi \ |
| -offlinemode \ |
| -title "Android System SDK" \ |
| -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \ |
| -sdkvalues $(OUT_DOCS) \ |
| -hdf android.whichdoc offline \ |
| -referenceonly |
| |
| LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
| |
| include $(BUILD_DROIDDOC) |
| |
| static_doc_index_redirect := $(out_dir)/index.html |
| $(static_doc_index_redirect): $(LOCAL_PATH)/docs/docs-documentation-redirect.html |
| $(copy-file-to-target) |
| |
| static_doc_properties := $(out_dir)/source.properties |
| $(static_doc_properties): \ |
| $(LOCAL_PATH)/docs/source.properties | $(ACP) |
| $(hide) mkdir -p $(dir $@) |
| $(hide) $(ACP) $< $@ |
| |
| $(full_target): $(static_doc_index_redirect) |
| $(full_target): $(static_doc_properties) |
| $(full_target): $(framework_built) |
| |
| |
| # ==== docs for the web (on the androiddevdocs app engine server) ======================= |
| include $(CLEAR_VARS) |
| |
| LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
| LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
| LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
| |
| LOCAL_MODULE := online-sdk |
| |
| LOCAL_DROIDDOC_OPTIONS:= \ |
| $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| -toroot / \ |
| -hdf android.whichdoc online \ |
| $(sample_groups) \ |
| -hdf android.hasSamples true \ |
| -samplesdir $(samples_dir) |
| |
| LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
| |
| include $(BUILD_DROIDDOC) |
| |
| # ==== docs for the web (on the androiddevdocs app engine server) ======================= |
| include $(CLEAR_VARS) |
| |
| LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
| LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
| LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
| |
| LOCAL_MODULE := online-system-api-sdk |
| |
| LOCAL_DROIDDOC_OPTIONS:= \ |
| $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| -referenceonly \ |
| -showAnnotation android.annotation.SystemApi \ |
| -title "Android SDK - Including system APIs." \ |
| -toroot / \ |
| -hide 101 \ |
| -hide 104 \ |
| -hide 108 \ |
| -hdf android.whichdoc online \ |
| $(sample_groups) \ |
| -hdf android.hasSamples true \ |
| -samplesdir $(samples_dir) |
| |
| LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
| |
| LOCAL_UNINSTALLABLE_MODULE := true |
| |
| include $(BUILD_DROIDDOC) |
| |
| # ==== docs for the web (on the devsite app engine server) ======================= |
| include $(CLEAR_VARS) |
| LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
| LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
| LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| # specify a second html input dir and an output path relative to OUT_DIR) |
| LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
| |
| LOCAL_MODULE := ds |
| |
| LOCAL_DROIDDOC_OPTIONS:= \ |
| $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| -toroot / \ |
| -hdf android.whichdoc online \ |
| -devsite \ |
| -yamlV2 \ |
| $(sample_groups) \ |
| -hdf android.hasSamples true \ |
| -samplesdir $(samples_dir) |
| |
| LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
| |
| include $(BUILD_DROIDDOC) |
| |
| # ==== docs for the web (on the devsite app engine server) ======================= |
| include $(CLEAR_VARS) |
| LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
| LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
| LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| # specify a second html input dir and an output path relative to OUT_DIR) |
| LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
| |
| LOCAL_MODULE := ds-static |
| |
| LOCAL_DROIDDOC_OPTIONS:= \ |
| $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| -hdf android.whichdoc online \ |
| -staticonly \ |
| -toroot / \ |
| -devsite \ |
| -ignoreJdLinks |
| |
| LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
| |
| include $(BUILD_DROIDDOC) |
| |
| # ==== generates full navtree for resolving @links in ds postprocessing ==== |
| include $(CLEAR_VARS) |
| |
| LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
| LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
| LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| |
| LOCAL_MODULE := ds-ref-navtree |
| |
| LOCAL_DROIDDOC_OPTIONS:= \ |
| $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| -hdf android.whichdoc online \ |
| -toroot / \ |
| -atLinksNavtree \ |
| -navtreeonly |
| |
| LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
| |
| include $(BUILD_DROIDDOC) |
| |
| # ==== site updates for docs (on the androiddevdocs app engine server) ======================= |
| include $(CLEAR_VARS) |
| |
| LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
| LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
| LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
| |
| LOCAL_MODULE := online-sdk-dev |
| |
| LOCAL_DROIDDOC_OPTIONS:= \ |
| $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| -toroot / \ |
| -hdf android.whichdoc online \ |
| $(sample_groups) \ |
| -hdf android.hasSamples true \ |
| -samplesdir $(samples_dir) |
| |
| LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
| |
| include $(BUILD_DROIDDOC) |
| |
| # ==== docs that have all of the stuff that's @hidden ======================= |
| include $(CLEAR_VARS) |
| |
| LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
| LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
| LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| |
| LOCAL_MODULE := hidden |
| LOCAL_DROIDDOC_OPTIONS:=\ |
| $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| -referenceonly \ |
| -title "Android SDK - Including hidden APIs." |
| # -hidden |
| |
| LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
| |
| include $(BUILD_DROIDDOC) |
| |
| # ==== java proto host library ============================== |
| include $(CLEAR_VARS) |
| LOCAL_MODULE := platformprotos |
| LOCAL_PROTOC_OPTIMIZE_TYPE := full |
| LOCAL_PROTOC_FLAGS := \ |
| -Iexternal/protobuf/src |
| LOCAL_SOURCE_FILES_ALL_GENERATED := true |
| LOCAL_SRC_FILES := \ |
| cmds/am/proto/instrumentation_data.proto \ |
| cmds/statsd/src/perfetto/perfetto_config.proto \ |
| $(call all-proto-files-under, core/proto) \ |
| $(call all-proto-files-under, libs/incident/proto) \ |
| $(call all-proto-files-under, cmds/statsd/src) |
| # b/72714520 |
| LOCAL_ERROR_PRONE_FLAGS := -Xep:MissingOverride:OFF |
| include $(BUILD_HOST_JAVA_LIBRARY) |
| |
| # ==== java proto device library (for test only) ============================== |
| include $(CLEAR_VARS) |
| LOCAL_MODULE := platformprotosnano |
| LOCAL_MODULE_TAGS := tests |
| LOCAL_PROTOC_OPTIMIZE_TYPE := nano |
| LOCAL_PROTOC_FLAGS := \ |
| -Iexternal/protobuf/src |
| LOCAL_PROTO_JAVA_OUTPUT_PARAMS := \ |
| store_unknown_fields = true |
| LOCAL_SDK_VERSION := current |
| LOCAL_SRC_FILES := \ |
| $(call all-proto-files-under, core/proto) \ |
| $(call all-proto-files-under, libs/incident/proto/android/os) |
| include $(BUILD_STATIC_JAVA_LIBRARY) |
| |
| |
| # ==== java proto device library (for test only) ============================== |
| include $(CLEAR_VARS) |
| LOCAL_MODULE := platformprotoslite |
| LOCAL_MODULE_TAGS := tests |
| LOCAL_PROTOC_OPTIMIZE_TYPE := lite |
| LOCAL_PROTOC_FLAGS := \ |
| -Iexternal/protobuf/src |
| LOCAL_SRC_FILES := \ |
| $(call all-proto-files-under, core/proto) \ |
| $(call all-proto-files-under, libs/incident/proto/android/os) |
| # Protos have lots of MissingOverride and similar. |
| LOCAL_ERROR_PRONE_FLAGS := -XepDisableAllChecks |
| include $(BUILD_STATIC_JAVA_LIBRARY) |
| |
| # ==== hiddenapi lists ======================================= |
| |
| # Copy light and dark greylist over into the build folder. |
| # This is for ART buildbots which need to mock these lists and have alternative |
| # rules for building them. Other rules in the build system should depend on the |
| # files in the build folder. |
| |
| # Automatically add all methods which match the following signatures. |
| # These need to be greylisted in order to allow applications to write their |
| # own serializers. |
| $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST): REGEX_SERIALIZATION := \ |
| "readObject\(Ljava/io/ObjectInputStream;\)V" \ |
| "readObjectNoData\(\)V" \ |
| "readResolve\(\)Ljava/lang/Object;" \ |
| "serialVersionUID:J" \ |
| "serialPersistentFields:\[Ljava/io/ObjectStreamField;" \ |
| "writeObject\(Ljava/io/ObjectOutputStream;\)V" \ |
| "writeReplace\(\)Ljava/lang/Object;" |
| $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST): PRIVATE_API := $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) |
| # Temporarily merge light greylist from two files. Vendor list will become dark |
| # grey once we remove the UI toast. |
| $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST): frameworks/base/config/hiddenapi-light-greylist.txt \ |
| frameworks/base/config/hiddenapi-vendor-list.txt \ |
| $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) |
| sort frameworks/base/config/hiddenapi-light-greylist.txt \ |
| frameworks/base/config/hiddenapi-vendor-list.txt \ |
| <(grep -E "\->("$(subst $(space),"|",$(REGEX_SERIALIZATION))")$$" $(PRIVATE_API)) \ |
| > $@ |
| |
| $(eval $(call copy-one-file,frameworks/base/config/hiddenapi-dark-greylist.txt,\ |
| $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST))) |
| |
| # Generate dark greylist as private API minus (blacklist plus light greylist). |
| |
| $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST): PRIVATE_API := $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) |
| $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST): LIGHT_GREYLIST := $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST) |
| $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST): DARK_GREYLIST := $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST) |
| $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST): $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) \ |
| $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST) \ |
| $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST) |
| if [ ! -z "`comm -12 <(sort $(LIGHT_GREYLIST)) <(sort $(DARK_GREYLIST))`" ]; then \ |
| echo "There should be no overlap between $(LIGHT_GREYLIST) and $(DARK_GREYLIST)" 1>&2; \ |
| comm -12 <(sort $(LIGHT_GREYLIST)) <(sort $(DARK_GREYLIST)) 1>&2; \ |
| exit 1; \ |
| elif [ ! -z "`comm -13 <(sort $(PRIVATE_API)) <(sort $(LIGHT_GREYLIST))`" ]; then \ |
| echo "$(LIGHT_GREYLIST) must be a subset of $(PRIVATE_API)" 1>&2; \ |
| comm -13 <(sort $(PRIVATE_API)) <(sort $(LIGHT_GREYLIST)) 1>&2; \ |
| exit 2; \ |
| elif [ ! -z "`comm -13 <(sort $(PRIVATE_API)) <(sort $(DARK_GREYLIST))`" ]; then \ |
| echo "$(DARK_GREYLIST) must be a subset of $(PRIVATE_API)" 1>&2; \ |
| comm -13 <(sort $(PRIVATE_API)) <(sort $(DARK_GREYLIST)) 1>&2; \ |
| exit 3; \ |
| fi |
| comm -23 <(sort $(PRIVATE_API)) <(sort $(LIGHT_GREYLIST) $(DARK_GREYLIST)) > $@ |
| |
| # Include subdirectory makefiles |
| # ============================================================ |
| |
| # If we're building with ONE_SHOT_MAKEFILE (mm, mmm), then what the framework |
| # team really wants is to build the stuff defined by this makefile. |
| ifeq (,$(ONE_SHOT_MAKEFILE)) |
| include $(call first-makefiles-under,$(LOCAL_PATH)) |
| endif |
| |
| endif # ANDROID_BUILD_EMBEDDED |
| |