871 lines
33 KiB
Makefile
871 lines
33 KiB
Makefile
#
|
|
# 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 \
|
|
icu4j \
|
|
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.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 \
|
|
-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
|
|
|
|
# ==== 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)
|
|
|
|
# ==== the api stubs and current.xml ===========================
|
|
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 := api-stubs
|
|
|
|
LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_stubs_current_intermediates/src
|
|
|
|
LOCAL_DROIDDOC_OPTIONS:=\
|
|
$(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
|
|
-referenceonly \
|
|
-api $(INTERNAL_PLATFORM_API_FILE) \
|
|
-privateApi $(INTERNAL_PLATFORM_PRIVATE_API_FILE) \
|
|
-privateDexApi $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) \
|
|
-removedApi $(INTERNAL_PLATFORM_REMOVED_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_API_FILE) \
|
|
$(INTERNAL_PLATFORM_PRIVATE_API_FILE) \
|
|
$(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE)
|
|
$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_API_FILE))
|
|
|
|
# ==== the system api stubs ===================================
|
|
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 := system-api-stubs
|
|
|
|
LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_system_stubs_current_intermediates/src
|
|
|
|
LOCAL_DROIDDOC_OPTIONS:=\
|
|
$(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
|
|
-referenceonly \
|
|
-showAnnotation android.annotation.SystemApi \
|
|
-api $(INTERNAL_PLATFORM_SYSTEM_API_FILE) \
|
|
-privateApi $(INTERNAL_PLATFORM_SYSTEM_PRIVATE_API_FILE) \
|
|
-privateDexApi $(INTERNAL_PLATFORM_SYSTEM_PRIVATE_DEX_API_FILE) \
|
|
-removedApi $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE) \
|
|
-exactApi $(INTERNAL_PLATFORM_SYSTEM_EXACT_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_SYSTEM_API_FILE) \
|
|
$(INTERNAL_PLATFORM_SYSTEM_PRIVATE_API_FILE) \
|
|
$(INTERNAL_PLATFORM_SYSTEM_PRIVATE_DEX_API_FILE)
|
|
$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_SYSTEM_API_FILE))
|
|
|
|
# ==== the test api stubs ===================================
|
|
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 := test-api-stubs
|
|
|
|
LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src
|
|
|
|
LOCAL_DROIDDOC_OPTIONS:=\
|
|
$(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
|
|
-referenceonly \
|
|
-stubs $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src \
|
|
-showAnnotation android.annotation.TestApi \
|
|
-api $(INTERNAL_PLATFORM_TEST_API_FILE) \
|
|
-removedApi $(INTERNAL_PLATFORM_TEST_REMOVED_API_FILE) \
|
|
-exactApi $(INTERNAL_PLATFORM_TEST_EXACT_API_FILE) \
|
|
-nodocs
|
|
|
|
LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
|
|
|
|
LOCAL_UNINSTALLABLE_MODULE := true
|
|
|
|
include $(BUILD_DROIDDOC)
|
|
|
|
$(INTERNAL_PLATFORM_TEST_API_FILE): $(full_target)
|
|
$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_TEST_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 \
|
|
$(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)
|
|
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_JAVA_LIBRARIES := core-oj core-libart
|
|
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 blacklist and light 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.
|
|
|
|
$(eval $(call copy-one-file,frameworks/base/config/hiddenapi-blacklist.txt,\
|
|
$(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST)))
|
|
$(eval $(call copy-one-file,frameworks/base/config/hiddenapi-light-greylist.txt,\
|
|
$(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST)))
|
|
|
|
# Generate dark greylist as private API minus (blacklist plus light greylist).
|
|
|
|
$(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST): PRIVATE_API := $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE)
|
|
$(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST): BLACKLIST := $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST)
|
|
$(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST): LIGHT_GREYLIST := $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST)
|
|
$(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST): $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) \
|
|
$(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST) \
|
|
$(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST)
|
|
if [ ! -z "`comm -12 <(sort $(BLACKLIST)) <(sort $(LIGHT_GREYLIST))`" ]; then \
|
|
echo "There should be no overlap between $(BLACKLIST) and $(LIGHT_GREYLIST)" 1>&2; \
|
|
exit 1; \
|
|
elif [ ! -z "`comm -13 <(sort $(PRIVATE_API)) <(sort $(BLACKLIST))`" ]; then \
|
|
echo "$(BLACKLIST) must be a subset of $(PRIVATE_API)" 1>&2; \
|
|
exit 2; \
|
|
elif [ ! -z "`comm -13 <(sort $(PRIVATE_API)) <(sort $(LIGHT_GREYLIST))`" ]; then \
|
|
echo "$(LIGHT_GREYLIST) must be a subset of $(PRIVATE_API)" 1>&2; \
|
|
exit 3; \
|
|
fi
|
|
comm -23 <(sort $(PRIVATE_API)) <(sort $(BLACKLIST) $(LIGHT_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
|
|
|