2015-05-07 03:23:20 +00:00
|
|
|
#
|
|
|
|
|
# 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)
|
|
|
|
|
|
2017-11-16 00:15:28 -08:00
|
|
|
# Load framework-specific path mappings used later in the build.
|
|
|
|
|
include $(LOCAL_PATH)/pathmap.mk
|
2015-05-07 03:23:20 +00:00
|
|
|
|
|
|
|
|
# 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)
|
|
|
|
|
|
2017-12-15 17:30:33 -08:00
|
|
|
aidl_parcelables :=
|
|
|
|
|
define stubs-to-aidl-parcelables
|
|
|
|
|
gen := $(TARGET_OUT_COMMON_INTERMEDIATES)/$1.aidl
|
|
|
|
|
aidl_parcelables += $$(gen)
|
2018-02-09 11:24:14 -08:00
|
|
|
$$(gen): $(call java-lib-header-files,$1) $(HOST_OUT_EXECUTABLES)/sdkparcelables
|
2017-12-15 17:30:33 -08:00
|
|
|
@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))))
|
|
|
|
|
|
2015-05-07 03:23:20 +00:00
|
|
|
gen := $(TARGET_OUT_COMMON_INTERMEDIATES)/framework.aidl
|
2017-12-15 17:30:33 -08:00
|
|
|
.KATI_RESTAT: $(gen)
|
|
|
|
|
$(gen): $(aidl_parcelables)
|
|
|
|
|
@echo Combining SDK parcelables: $@
|
|
|
|
|
rm -f $@.tmp
|
|
|
|
|
cat $^ | sort -u > $@.tmp
|
|
|
|
|
$(call commit-change-for-toc,$@)
|
2015-05-07 03:23:20 +00:00
|
|
|
|
|
|
|
|
# the documentation
|
|
|
|
|
# ============================================================
|
|
|
|
|
|
|
|
|
|
# TODO: deal with com/google/android/googleapps
|
|
|
|
|
packages_to_document := \
|
2017-11-16 00:15:28 -08:00
|
|
|
android \
|
|
|
|
|
javax/microedition/khronos \
|
|
|
|
|
org/apache/http/conn \
|
|
|
|
|
org/apache/http/params \
|
2015-05-07 03:23:20 +00:00
|
|
|
|
|
|
|
|
# include definition of libcore_to_document
|
|
|
|
|
include libcore/Docs.mk
|
|
|
|
|
|
|
|
|
|
non_base_dirs := \
|
2017-11-16 00:15:28 -08:00
|
|
|
../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 \
|
2015-05-07 03:23:20 +00:00
|
|
|
|
2017-06-29 14:58:43 +01:00
|
|
|
framework_base_android_test_mock_src_files := \
|
2017-11-15 11:39:14 +00:00
|
|
|
$(call all-java-files-under, test-mock/src/android/test/mock)
|
2017-06-29 14:58:43 +01:00
|
|
|
|
|
|
|
|
framework_base_android_test_runner_excluding_mock_src_files := \
|
2017-11-16 00:15:28 -08:00
|
|
|
$(filter-out $(framework_base_android_test_mock_src_files), $(call all-java-files-under, test-runner/src))
|
|
|
|
|
|
|
|
|
|
# Find all files in specific directories (relative to frameworks/base)
|
|
|
|
|
# to document and check apis
|
|
|
|
|
files_to_check_apis := \
|
|
|
|
|
$(call find-other-java-files, \
|
2017-11-16 15:47:05 +00:00
|
|
|
test-base/src \
|
2017-11-16 00:15:28 -08:00
|
|
|
$(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
|
2017-12-04 13:45:19 -08:00
|
|
|
files_to_check_apis_generated := \
|
|
|
|
|
$(filter $(OUT_DIR)/%,\
|
|
|
|
|
$(SOONG_FRAMEWORK_SRCS))
|
2015-12-03 07:39:55 -08:00
|
|
|
|
2015-05-07 03:23:20 +00:00
|
|
|
# These are relative to frameworks/base
|
|
|
|
|
# FRAMEWORKS_BASE_SUBDIRS comes from build/core/pathmap.mk
|
2017-11-16 00:15:28 -08:00
|
|
|
files_to_document := \
|
|
|
|
|
$(files_to_check_apis) \
|
|
|
|
|
$(call find-other-java-files,\
|
|
|
|
|
$(addprefix ../../, $(FRAMEWORKS_DATA_BINDING_JAVA_SRC_DIRS)) \
|
|
|
|
|
test-runner/src)
|
2015-12-03 07:39:55 -08:00
|
|
|
|
2015-05-07 03:23:20 +00:00
|
|
|
# These are relative to frameworks/base
|
|
|
|
|
html_dirs := \
|
|
|
|
|
$(FRAMEWORKS_BASE_SUBDIRS) \
|
2017-11-16 00:15:28 -08:00
|
|
|
$(non_base_dirs) \
|
2015-05-07 03:23:20 +00:00
|
|
|
|
|
|
|
|
# Common sources for doc check and api check
|
|
|
|
|
common_src_files := \
|
|
|
|
|
$(call find-other-html-files, $(html_dirs)) \
|
2017-11-16 00:15:28 -08:00
|
|
|
$(addprefix ../../, $(libcore_to_document)) \
|
2015-05-07 03:23:20 +00:00
|
|
|
|
|
|
|
|
# These are relative to frameworks/base
|
|
|
|
|
framework_docs_LOCAL_SRC_FILES := \
|
2017-11-16 00:15:28 -08:00
|
|
|
$(files_to_document) \
|
|
|
|
|
$(common_src_files) \
|
2015-05-07 03:23:20 +00:00
|
|
|
|
|
|
|
|
# These are relative to frameworks/base
|
|
|
|
|
framework_docs_LOCAL_API_CHECK_SRC_FILES := \
|
2017-11-16 00:15:28 -08:00
|
|
|
$(framework_base_android_test_mock_src_files) \
|
|
|
|
|
$(framework_base_android_test_runner_excluding_mock_src_files) \
|
|
|
|
|
$(files_to_check_apis) \
|
|
|
|
|
$(common_src_files) \
|
2015-05-07 03:23:20 +00:00
|
|
|
|
|
|
|
|
# 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)
|
|
|
|
|
|
2017-11-16 00:15:28 -08:00
|
|
|
framework_docs_LOCAL_SRCJARS := $(SOONG_FRAMEWORK_SRCJARS)
|
|
|
|
|
|
2017-12-04 13:45:19 -08:00
|
|
|
framework_docs_LOCAL_GENERATED_SOURCES := \
|
|
|
|
|
$(libcore_to_document_generated) \
|
|
|
|
|
$(files_to_check_apis_generated) \
|
2015-05-07 03:23:20 +00:00
|
|
|
|
|
|
|
|
framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES := \
|
2015-02-17 16:58:52 +00:00
|
|
|
core-oj \
|
2015-05-07 03:23:20 +00:00
|
|
|
core-libart \
|
|
|
|
|
conscrypt \
|
|
|
|
|
bouncycastle \
|
|
|
|
|
okhttp \
|
|
|
|
|
ext \
|
|
|
|
|
framework \
|
2017-06-29 14:58:43 +01:00
|
|
|
voip-common \
|
|
|
|
|
android.test.mock \
|
2015-05-07 03:23:20 +00:00
|
|
|
|
2017-04-05 10:21:58 -04:00
|
|
|
# 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.
|
2015-05-07 03:23:20 +00:00
|
|
|
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 := \
|
2017-04-24 18:06:20 -06:00
|
|
|
-android \
|
2015-05-07 03:23:20 +00:00
|
|
|
-knowntags ./frameworks/base/docs/knowntags.txt \
|
2015-07-27 14:02:11 +01:00
|
|
|
-knowntags ./libcore/known_oj_tags.txt \
|
2017-06-05 17:38:17 -06:00
|
|
|
-manifest ./frameworks/base/core/res/AndroidManifest.xml \
|
2018-03-05 22:55:32 +00:00
|
|
|
-hidePackage com.android.internal \
|
|
|
|
|
-hidePackage com.android.internal.util \
|
2017-12-06 21:02:11 -07:00
|
|
|
-hidePackage com.android.okhttp \
|
2015-05-07 03:23:20 +00:00
|
|
|
-hidePackage com.android.org.conscrypt \
|
2018-04-19 16:23:53 +01:00
|
|
|
-hidePackage com.android.server
|
|
|
|
|
|
|
|
|
|
# Convert an sdk level to a "since" argument.
|
|
|
|
|
since-arg = -since $(wildcard $(HISTORICAL_SDK_VERSIONS_ROOT)/$(1)/public/api/android.*) $(1)
|
|
|
|
|
|
|
|
|
|
finalized_sdks := $(patsubst $(HISTORICAL_SDK_VERSIONS_ROOT)/%/public/api/android.xml,%,\
|
|
|
|
|
$(wildcard $(HISTORICAL_SDK_VERSIONS_ROOT)/*/public/api/android.xml))
|
|
|
|
|
finalized_sdks += $(patsubst $(HISTORICAL_SDK_VERSIONS_ROOT)/%/public/api/android.txt,%,\
|
|
|
|
|
$(wildcard $(HISTORICAL_SDK_VERSIONS_ROOT)/*/public/api/android.txt))
|
|
|
|
|
finalized_sdks := $(call numerically_sort,$(finalized_sdks))
|
|
|
|
|
|
|
|
|
|
framework_docs_LOCAL_DROIDDOC_OPTIONS += $(foreach sdk,$(finalized_sdks),$(call since-arg,$(sdk)))
|
|
|
|
|
ifneq ($(PLATFORM_VERSION_CODENAME),REL)
|
|
|
|
|
framework_docs_LOCAL_DROIDDOC_OPTIONS += \
|
|
|
|
|
-since ./frameworks/base/api/current.txt $(PLATFORM_VERSION_CODENAME)
|
|
|
|
|
endif
|
|
|
|
|
framework_docs_LOCAL_DROIDDOC_OPTIONS += \
|
2017-12-06 21:12:23 -07:00
|
|
|
-werror -lerror -hide 111 -hide 113 -hide 125 -hide 126 -hide 127 -hide 128 \
|
2018-04-19 16:23:53 +01:00
|
|
|
-overview $(LOCAL_PATH)/core/java/overview.html
|
2015-05-07 03:23:20 +00:00
|
|
|
|
|
|
|
|
framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR:= \
|
|
|
|
|
$(call intermediates-dir-for,JAVA_LIBRARIES,framework,,COMMON)
|
|
|
|
|
|
|
|
|
|
framework_docs_LOCAL_ADDITIONAL_JAVA_DIR:= \
|
2017-04-05 10:21:58 -04:00
|
|
|
$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
|
2015-05-07 03:23:20 +00:00
|
|
|
|
|
|
|
|
framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES := \
|
2015-07-14 13:39:23 +01:00
|
|
|
frameworks/base/docs/knowntags.txt \
|
2017-10-27 10:46:53 -07:00
|
|
|
$(libcore_to_document_generated)
|
2015-05-07 03:23:20 +00:00
|
|
|
|
|
|
|
|
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 \
|
2015-05-27 14:50:51 -07:00
|
|
|
-samplegroup System \
|
2015-05-07 03:23:20 +00:00
|
|
|
-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)
|
2016-08-29 18:36:50 -07:00
|
|
|
framework_docs_SDK_VERSION:=7.0
|
2015-05-07 03:23:20 +00:00
|
|
|
# release version (ie "Release x") (full releases only)
|
|
|
|
|
framework_docs_SDK_REL_ID:=1
|
|
|
|
|
|
|
|
|
|
framework_docs_LOCAL_DROIDDOC_OPTIONS += \
|
2017-03-03 13:09:15 -08:00
|
|
|
-hdf dac true \
|
2017-03-21 13:43:31 -07:00
|
|
|
-hdf sdk.codename O \
|
|
|
|
|
-hdf sdk.preview.version 1 \
|
2015-05-07 03:23:20 +00:00
|
|
|
-hdf sdk.version $(framework_docs_SDK_VERSION) \
|
|
|
|
|
-hdf sdk.rel.id $(framework_docs_SDK_REL_ID) \
|
2017-03-21 13:43:31 -07:00
|
|
|
-hdf sdk.preview 0 \
|
|
|
|
|
-resourcesdir $(LOCAL_PATH)/docs/html/reference/images/ \
|
|
|
|
|
-resourcesoutdir reference/android/images/
|
2015-05-07 03:23:20 +00:00
|
|
|
|
2017-04-05 10:21:58 -04:00
|
|
|
# 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
|
|
|
|
|
|
2015-05-07 03:23:20 +00:00
|
|
|
|
|
|
|
|
$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_API_FILE))
|
|
|
|
|
$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_SYSTEM_API_FILE))
|
2015-11-06 15:21:13 +00:00
|
|
|
$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_TEST_API_FILE))
|
|
|
|
|
|
2015-05-07 03:23:20 +00:00
|
|
|
# ==== check javadoc comments but don't generate docs ========
|
|
|
|
|
include $(CLEAR_VARS)
|
|
|
|
|
|
|
|
|
|
LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
|
2017-12-04 13:45:19 -08:00
|
|
|
LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
|
2017-11-16 00:15:28 -08:00
|
|
|
LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
|
2015-05-07 03:23:20 +00:00
|
|
|
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) \
|
2016-09-01 19:52:17 -07:00
|
|
|
-referenceonly \
|
2015-05-07 03:23:20 +00:00
|
|
|
-parsecomments
|
|
|
|
|
|
2017-02-21 14:30:58 -08:00
|
|
|
LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
|
2015-05-07 03:23:20 +00:00
|
|
|
|
|
|
|
|
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)
|
2017-12-04 13:45:19 -08:00
|
|
|
LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
|
2017-11-16 00:15:28 -08:00
|
|
|
LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
|
2015-05-07 03:23:20 +00:00
|
|
|
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
|
|
|
|
|
|
2016-06-14 17:11:57 -07:00
|
|
|
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
|
|
|
|
|
|
2017-02-21 14:30:58 -08:00
|
|
|
LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
|
2016-06-14 17:11:57 -07:00
|
|
|
|
|
|
|
|
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)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# ==== static html in the sdk ==================================
|
|
|
|
|
include $(CLEAR_VARS)
|
|
|
|
|
|
|
|
|
|
LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
|
2017-12-04 13:45:19 -08:00
|
|
|
LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
|
2017-11-16 00:15:28 -08:00
|
|
|
LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
|
2016-06-14 17:11:57 -07:00
|
|
|
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
|
|
|
|
|
|
2016-03-07 18:38:08 -08:00
|
|
|
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 \
|
2017-03-21 13:43:31 -07:00
|
|
|
-referenceonly
|
2016-03-07 18:38:08 -08:00
|
|
|
|
2017-02-21 14:30:58 -08:00
|
|
|
LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
|
2016-03-07 18:38:08 -08:00
|
|
|
|
|
|
|
|
include $(BUILD_DROIDDOC)
|
|
|
|
|
|
|
|
|
|
static_doc_index_redirect := $(out_dir)/index.html
|
2016-08-31 08:42:09 -07:00
|
|
|
$(static_doc_index_redirect): $(LOCAL_PATH)/docs/docs-documentation-redirect.html
|
2016-03-23 00:42:44 -07:00
|
|
|
$(copy-file-to-target)
|
2016-03-07 18:38:08 -08:00
|
|
|
|
2016-09-21 14:05:50 -07:00
|
|
|
static_doc_properties := $(out_dir)/source.properties
|
|
|
|
|
$(static_doc_properties): \
|
|
|
|
|
$(LOCAL_PATH)/docs/source.properties | $(ACP)
|
|
|
|
|
$(hide) mkdir -p $(dir $@)
|
|
|
|
|
$(hide) $(ACP) $< $@
|
|
|
|
|
|
2016-03-07 18:38:08 -08:00
|
|
|
$(full_target): $(static_doc_index_redirect)
|
2016-09-21 14:05:50 -07:00
|
|
|
$(full_target): $(static_doc_properties)
|
2016-03-07 18:38:08 -08:00
|
|
|
|
2016-03-10 14:13:30 -08:00
|
|
|
|
2015-05-07 03:23:20 +00:00
|
|
|
# ==== docs for the web (on the androiddevdocs app engine server) =======================
|
|
|
|
|
include $(CLEAR_VARS)
|
|
|
|
|
|
|
|
|
|
LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
|
2017-12-04 13:45:19 -08:00
|
|
|
LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
|
2017-11-16 00:15:28 -08:00
|
|
|
LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
|
2015-05-07 03:23:20 +00:00
|
|
|
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)
|
|
|
|
|
|
2017-02-21 14:30:58 -08:00
|
|
|
LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
|
2015-05-07 03:23:20 +00:00
|
|
|
|
|
|
|
|
include $(BUILD_DROIDDOC)
|
|
|
|
|
|
|
|
|
|
# ==== docs for the web (on the androiddevdocs app engine server) =======================
|
|
|
|
|
include $(CLEAR_VARS)
|
|
|
|
|
|
|
|
|
|
LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
|
2017-12-04 13:45:19 -08:00
|
|
|
LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
|
2017-11-16 00:15:28 -08:00
|
|
|
LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
|
2015-05-07 03:23:20 +00:00
|
|
|
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) \
|
2016-09-01 19:52:17 -07:00
|
|
|
-referenceonly \
|
2015-05-07 03:23:20 +00:00
|
|
|
-showAnnotation android.annotation.SystemApi \
|
|
|
|
|
-title "Android SDK - Including system APIs." \
|
|
|
|
|
-toroot / \
|
2016-05-31 17:25:48 -07:00
|
|
|
-hide 101 \
|
|
|
|
|
-hide 104 \
|
|
|
|
|
-hide 108 \
|
2015-05-07 03:23:20 +00:00
|
|
|
-hdf android.whichdoc online \
|
|
|
|
|
$(sample_groups) \
|
|
|
|
|
-hdf android.hasSamples true \
|
|
|
|
|
-samplesdir $(samples_dir)
|
|
|
|
|
|
2017-02-21 14:30:58 -08:00
|
|
|
LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
|
2017-05-09 19:01:09 -06:00
|
|
|
|
2015-05-07 03:23:20 +00:00
|
|
|
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)
|
2017-12-04 13:45:19 -08:00
|
|
|
LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
|
2017-11-16 00:15:28 -08:00
|
|
|
LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
|
2015-05-07 03:23:20 +00:00
|
|
|
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)
|
2016-04-10 02:05:09 -07:00
|
|
|
LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
|
2015-05-07 03:23:20 +00:00
|
|
|
|
|
|
|
|
LOCAL_MODULE := ds
|
|
|
|
|
|
|
|
|
|
LOCAL_DROIDDOC_OPTIONS:= \
|
|
|
|
|
$(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
|
|
|
|
|
-toroot / \
|
|
|
|
|
-hdf android.whichdoc online \
|
2016-06-14 16:26:28 -07:00
|
|
|
-devsite \
|
2016-04-10 02:05:09 -07:00
|
|
|
$(sample_groups) \
|
|
|
|
|
-hdf android.hasSamples true \
|
|
|
|
|
-samplesdir $(samples_dir)
|
2015-05-07 03:23:20 +00:00
|
|
|
|
2017-02-21 14:30:58 -08:00
|
|
|
LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
|
2015-05-07 03:23:20 +00:00
|
|
|
|
|
|
|
|
include $(BUILD_DROIDDOC)
|
|
|
|
|
|
2016-06-14 16:26:28 -07:00
|
|
|
# ==== docs for the web (on the devsite app engine server) =======================
|
|
|
|
|
include $(CLEAR_VARS)
|
|
|
|
|
LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
|
2017-12-04 13:45:19 -08:00
|
|
|
LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
|
2017-11-16 00:15:28 -08:00
|
|
|
LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
|
2016-06-14 16:26:28 -07:00
|
|
|
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
|
|
|
|
|
|
2017-02-21 14:30:58 -08:00
|
|
|
LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
|
2016-06-14 16:26:28 -07:00
|
|
|
|
|
|
|
|
include $(BUILD_DROIDDOC)
|
|
|
|
|
|
2016-09-13 16:44:25 -07:00
|
|
|
# ==== generates full navtree for resolving @links in ds postprocessing ====
|
|
|
|
|
include $(CLEAR_VARS)
|
|
|
|
|
|
|
|
|
|
LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
|
2017-12-04 13:45:19 -08:00
|
|
|
LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
|
2017-11-16 00:15:28 -08:00
|
|
|
LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
|
2016-09-13 16:44:25 -07:00
|
|
|
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
|
|
|
|
|
|
2017-02-21 14:30:58 -08:00
|
|
|
LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
|
2016-09-13 16:44:25 -07:00
|
|
|
|
2016-06-14 16:26:28 -07:00
|
|
|
include $(BUILD_DROIDDOC)
|
2015-05-07 03:23:20 +00:00
|
|
|
|
2015-11-07 13:18:02 -08:00
|
|
|
# ==== site updates for docs (on the androiddevdocs app engine server) =======================
|
2015-05-07 03:23:20 +00:00
|
|
|
include $(CLEAR_VARS)
|
2015-11-07 13:18:02 -08:00
|
|
|
|
2015-05-07 03:23:20 +00:00
|
|
|
LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
|
2017-12-04 13:45:19 -08:00
|
|
|
LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
|
2017-11-16 00:15:28 -08:00
|
|
|
LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
|
2015-05-07 03:23:20 +00:00
|
|
|
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)
|
2015-11-07 13:18:02 -08:00
|
|
|
LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
|
2015-05-07 03:23:20 +00:00
|
|
|
LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
|
|
|
|
|
LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
|
2015-11-07 13:18:02 -08:00
|
|
|
LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
|
2015-05-07 03:23:20 +00:00
|
|
|
|
2015-11-07 13:18:02 -08:00
|
|
|
LOCAL_MODULE := online-sdk-dev
|
2015-05-07 03:23:20 +00:00
|
|
|
|
|
|
|
|
LOCAL_DROIDDOC_OPTIONS:= \
|
|
|
|
|
$(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
|
|
|
|
|
-toroot / \
|
|
|
|
|
-hdf android.whichdoc online \
|
|
|
|
|
$(sample_groups) \
|
|
|
|
|
-hdf android.hasSamples true \
|
|
|
|
|
-samplesdir $(samples_dir)
|
|
|
|
|
|
2017-02-21 14:30:58 -08:00
|
|
|
LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
|
2015-05-07 03:23:20 +00:00
|
|
|
|
|
|
|
|
include $(BUILD_DROIDDOC)
|
|
|
|
|
|
|
|
|
|
# ==== docs that have all of the stuff that's @hidden =======================
|
|
|
|
|
include $(CLEAR_VARS)
|
|
|
|
|
|
|
|
|
|
LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
|
2017-12-04 13:45:19 -08:00
|
|
|
LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
|
2017-11-16 00:15:28 -08:00
|
|
|
LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
|
2015-05-07 03:23:20 +00:00
|
|
|
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) \
|
2016-09-01 19:52:17 -07:00
|
|
|
-referenceonly \
|
2015-05-07 03:23:20 +00:00
|
|
|
-title "Android SDK - Including hidden APIs."
|
|
|
|
|
# -hidden
|
|
|
|
|
|
2017-02-21 14:30:58 -08:00
|
|
|
LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
|
2015-05-07 03:23:20 +00:00
|
|
|
|
|
|
|
|
include $(BUILD_DROIDDOC)
|
|
|
|
|
|
First checkin of incident reporting.
There are a few major pieces here:
incidentd
---------
This daemon (started by init) runs and accepts incoming requests to take
incident reports. When prompted, it calls into various system services
and fills in an IncidentProto data structure, and then writes the report
into dropbox.
The next steps for incidentd:
- Security review of SELinux policies. These will be a subset of
the dumpstate permissions. Until this is done, incidentd is
not started at boot time.
incident
--------
This shell command calls into incidentd, and can initiate an incident
report and either capture the output or leave for dropbox.
incident_report
---------------
This host side tool can call adb shell with the correct parameters
and also format the incident report as text. This formatting code
was left of the device on purpose. Right now it's pretty small, but
as the number of fields increases, the metadata and code to do the
formatting will start to grow.
The incident_report command also contains a workaround to let it
work before incidentd is turned on by default. Right now, it is
implemented to call adb shell dumpsys <service> --proto directly,
whereas in the future it will go through the full incidentd flow.
incident_section_gen
--------------------
A build-time tool that generates a stripped down set of information
about the fields that are available.
libincident
-----------
This library contains the code to connect to incidentd, and the
meta proto definitions that are used by the framework protos.
The basics are here now, but they are not fully fleshed out yet.
The privacy.proto file contains annotations that can go in the
proto file that we will later use to filter which fields are
uploaded, and which are used by local sources. For example, a
device in a test lab is safe to upload much much more information
than a real user. These will share the same mechanism, but the
user's output will be filtered according to these annotations.
frameworks/core/proto
---------------------
These .proto files contain the definitions of the system's
output. There is one master android.os.IncidentProto file that
is the top level of an incident report, but some other services
(notification, fingerprint, batterystats, etc) will have others
that are used directly by the logging mechanism.
Other files which are shared by several of the services also go
here, such as ComponentName, Locale, Configuration, etc. There
will be many more.
There is also a first iplementation of a dump method handling
--proto in the fingerprint service.
IncidentManager
---------------
The java API to trigger an incident report.
Test: Not written yet
Change-Id: I59568b115ac7fcf73af70c946c95752bf33ae67f
2016-11-21 17:51:35 -08:00
|
|
|
# ==== 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 := \
|
|
|
|
|
$(call all-proto-files-under, core/proto) \
|
|
|
|
|
$(call all-proto-files-under, libs/incident/proto)
|
2018-02-15 15:12:38 -08:00
|
|
|
# b/72714520
|
|
|
|
|
LOCAL_ERROR_PRONE_FLAGS := -Xep:MissingOverride:OFF
|
First checkin of incident reporting.
There are a few major pieces here:
incidentd
---------
This daemon (started by init) runs and accepts incoming requests to take
incident reports. When prompted, it calls into various system services
and fills in an IncidentProto data structure, and then writes the report
into dropbox.
The next steps for incidentd:
- Security review of SELinux policies. These will be a subset of
the dumpstate permissions. Until this is done, incidentd is
not started at boot time.
incident
--------
This shell command calls into incidentd, and can initiate an incident
report and either capture the output or leave for dropbox.
incident_report
---------------
This host side tool can call adb shell with the correct parameters
and also format the incident report as text. This formatting code
was left of the device on purpose. Right now it's pretty small, but
as the number of fields increases, the metadata and code to do the
formatting will start to grow.
The incident_report command also contains a workaround to let it
work before incidentd is turned on by default. Right now, it is
implemented to call adb shell dumpsys <service> --proto directly,
whereas in the future it will go through the full incidentd flow.
incident_section_gen
--------------------
A build-time tool that generates a stripped down set of information
about the fields that are available.
libincident
-----------
This library contains the code to connect to incidentd, and the
meta proto definitions that are used by the framework protos.
The basics are here now, but they are not fully fleshed out yet.
The privacy.proto file contains annotations that can go in the
proto file that we will later use to filter which fields are
uploaded, and which are used by local sources. For example, a
device in a test lab is safe to upload much much more information
than a real user. These will share the same mechanism, but the
user's output will be filtered according to these annotations.
frameworks/core/proto
---------------------
These .proto files contain the definitions of the system's
output. There is one master android.os.IncidentProto file that
is the top level of an incident report, but some other services
(notification, fingerprint, batterystats, etc) will have others
that are used directly by the logging mechanism.
Other files which are shared by several of the services also go
here, such as ComponentName, Locale, Configuration, etc. There
will be many more.
There is also a first iplementation of a dump method handling
--proto in the fingerprint service.
IncidentManager
---------------
The java API to trigger an incident report.
Test: Not written yet
Change-Id: I59568b115ac7fcf73af70c946c95752bf33ae67f
2016-11-21 17:51:35 -08:00
|
|
|
include $(BUILD_HOST_JAVA_LIBRARY)
|
|
|
|
|
|
2015-05-07 03:23:20 +00:00
|
|
|
|
2018-01-22 22:23:13 +00:00
|
|
|
# ==== hiddenapi lists =======================================
|
2018-05-08 15:04:20 +01:00
|
|
|
include $(CLEAR_VARS)
|
|
|
|
|
|
|
|
|
|
# File names of final API lists
|
|
|
|
|
LOCAL_LIGHT_GREYLIST := $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST)
|
|
|
|
|
LOCAL_DARK_GREYLIST := $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST)
|
|
|
|
|
LOCAL_BLACKLIST := $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST)
|
|
|
|
|
|
|
|
|
|
# File names of source files we will use to generate the final API lists.
|
|
|
|
|
LOCAL_SRC_GREYLIST := frameworks/base/config/hiddenapi-light-greylist.txt
|
|
|
|
|
LOCAL_SRC_VENDOR_LIST := frameworks/base/config/hiddenapi-vendor-list.txt
|
2018-05-08 16:49:02 +01:00
|
|
|
LOCAL_SRC_FORCE_BLACKLIST := frameworks/base/config/hiddenapi-force-blacklist.txt
|
2018-05-31 13:58:41 +01:00
|
|
|
LOCAL_SRC_PUBLIC_API := $(INTERNAL_PLATFORM_DEX_API_FILE)
|
2018-05-08 15:04:20 +01:00
|
|
|
LOCAL_SRC_PRIVATE_API := $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE)
|
|
|
|
|
LOCAL_SRC_REMOVED_API := $(INTERNAL_PLATFORM_REMOVED_DEX_API_FILE)
|
|
|
|
|
|
|
|
|
|
LOCAL_SRC_ALL := \
|
|
|
|
|
$(LOCAL_SRC_GREYLIST) \
|
|
|
|
|
$(LOCAL_SRC_VENDOR_LIST) \
|
2018-05-08 16:49:02 +01:00
|
|
|
$(LOCAL_SRC_FORCE_BLACKLIST) \
|
2018-05-31 13:58:41 +01:00
|
|
|
$(LOCAL_SRC_PUBLIC_API) \
|
2018-05-08 15:04:20 +01:00
|
|
|
$(LOCAL_SRC_PRIVATE_API) \
|
|
|
|
|
$(LOCAL_SRC_REMOVED_API)
|
|
|
|
|
|
|
|
|
|
define assert-has-no-overlap
|
|
|
|
|
if [ ! -z "`comm -12 <(sort $(1)) <(sort $(2))`" ]; then \
|
|
|
|
|
echo "$(1) and $(2) should not overlap" 1>&2; \
|
|
|
|
|
comm -12 <(sort $(1)) <(sort $(2)) 1>&2; \
|
|
|
|
|
exit 1; \
|
|
|
|
|
fi
|
|
|
|
|
endef
|
|
|
|
|
|
|
|
|
|
define assert-is-subset
|
|
|
|
|
if [ ! -z "`comm -23 <(sort $(1)) <(sort $(2))`" ]; then \
|
|
|
|
|
echo "$(1) must be a subset of $(2)" 1>&2; \
|
|
|
|
|
comm -23 <(sort $(1)) <(sort $(2)) 1>&2; \
|
|
|
|
|
exit 1; \
|
|
|
|
|
fi
|
|
|
|
|
endef
|
|
|
|
|
|
|
|
|
|
define assert-has-no-duplicates
|
|
|
|
|
if [ ! -z "`sort $(1) | uniq -D`" ]; then \
|
|
|
|
|
echo "$(1) has duplicate entries" 1>&2; \
|
|
|
|
|
sort $(1) | uniq -D 1>&2; \
|
|
|
|
|
exit 1; \
|
|
|
|
|
fi
|
|
|
|
|
endef
|
2018-01-22 22:23:13 +00:00
|
|
|
|
2018-05-08 15:04:20 +01:00
|
|
|
# The following rules build API lists in the build folder.
|
|
|
|
|
# By not using files from the source tree, ART buildbots can mock these lists
|
|
|
|
|
# or have alternative rules for building them. Other rules in the build system
|
|
|
|
|
# should depend on the files in the build folder.
|
2018-01-26 11:13:35 +00:00
|
|
|
|
2018-05-05 11:43:29 +01:00
|
|
|
# Merge light greylist from multiple files:
|
2018-05-08 15:04:20 +01:00
|
|
|
# (1) manual greylist LOCAL_SRC_GREYLIST
|
|
|
|
|
# (2) list of usages from vendor apps LOCAL_SRC_VENDOR_LIST
|
|
|
|
|
# (3) list of removed APIs in LOCAL_SRC_REMOVED_API
|
2018-05-05 11:43:29 +01:00
|
|
|
# @removed does not imply private in Doclava. We must take the subset also
|
2018-05-08 15:04:20 +01:00
|
|
|
# in LOCAL_SRC_PRIVATE_API.
|
2018-05-05 11:43:29 +01:00
|
|
|
# (4) list of serialization APIs
|
|
|
|
|
# Automatically adds all methods which match the signatures in
|
|
|
|
|
# REGEX_SERIALIZATION. These are greylisted in order to allow applications
|
|
|
|
|
# to write their own serializers.
|
2018-05-08 15:04:20 +01:00
|
|
|
$(LOCAL_LIGHT_GREYLIST): REGEX_SERIALIZATION := \
|
2018-05-05 11:43:29 +01:00
|
|
|
"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;"
|
2018-05-08 15:04:20 +01:00
|
|
|
$(LOCAL_LIGHT_GREYLIST): $(LOCAL_SRC_ALL)
|
2018-07-11 15:55:32 +01:00
|
|
|
sort $(LOCAL_SRC_GREYLIST) $(LOCAL_SRC_VENDOR_LIST) $(PRIVATE_GREYLIST_INPUTS) \
|
2018-05-08 15:04:20 +01:00
|
|
|
<(grep -E "\->("$(subst $(space),"|",$(REGEX_SERIALIZATION))")$$" \
|
|
|
|
|
$(LOCAL_SRC_PRIVATE_API)) \
|
|
|
|
|
<(comm -12 <(sort $(LOCAL_SRC_REMOVED_API)) <(sort $(LOCAL_SRC_PRIVATE_API))) \
|
|
|
|
|
> $@
|
|
|
|
|
$(call assert-has-no-duplicates,$@)
|
|
|
|
|
$(call assert-is-subset,$@,$(LOCAL_SRC_PRIVATE_API))
|
2018-05-08 16:49:02 +01:00
|
|
|
$(call assert-has-no-overlap,$@,$(LOCAL_SRC_FORCE_BLACKLIST))
|
2018-05-08 15:04:20 +01:00
|
|
|
|
2018-05-10 15:50:02 +01:00
|
|
|
# Generate dark greylist as remaining classes and class members in the same
|
|
|
|
|
# package as classes listed in the light greylist.
|
2018-05-08 15:28:31 +01:00
|
|
|
# The algorithm is as follows:
|
|
|
|
|
# (1) extract the class descriptor from each entry in LOCAL_LIGHT_GREYLIST
|
2018-05-10 15:50:02 +01:00
|
|
|
# (2) strip everything after the last forward-slash,
|
|
|
|
|
# e.g. 'Lpackage/subpackage/class$inner;' turns into 'Lpackage/subpackage/'
|
|
|
|
|
# (3) insert all entries from LOCAL_SRC_PRIVATE_API which begin with the package
|
|
|
|
|
# name but do not contain another forward-slash in the class name, e.g.
|
|
|
|
|
# matching '^Lpackage/subpackage/[^/;]*;'
|
2018-05-08 15:28:31 +01:00
|
|
|
# (4) subtract entries shared with LOCAL_LIGHT_GREYLIST
|
2018-05-08 15:04:20 +01:00
|
|
|
$(LOCAL_DARK_GREYLIST): $(LOCAL_SRC_ALL) $(LOCAL_LIGHT_GREYLIST)
|
2018-05-08 16:49:02 +01:00
|
|
|
comm -13 <(sort $(LOCAL_LIGHT_GREYLIST) $(LOCAL_SRC_FORCE_BLACKLIST)) \
|
2018-05-31 13:58:41 +01:00
|
|
|
<(cat $(LOCAL_SRC_PUBLIC_API) $(LOCAL_LIGHT_GREYLIST) | \
|
|
|
|
|
sed 's/\->.*//' | sed 's/\(.*\/\).*/\1/' | sort | uniq | \
|
2018-05-10 15:50:02 +01:00
|
|
|
while read PKG_NAME; do \
|
|
|
|
|
grep -E "^$${PKG_NAME}[^/;]*;" $(LOCAL_SRC_PRIVATE_API); \
|
2018-05-08 15:28:31 +01:00
|
|
|
done | sort | uniq) \
|
|
|
|
|
> $@
|
2018-05-08 15:04:20 +01:00
|
|
|
$(call assert-is-subset,$@,$(LOCAL_SRC_PRIVATE_API))
|
|
|
|
|
$(call assert-has-no-duplicates,$@)
|
|
|
|
|
$(call assert-has-no-overlap,$@,$(LOCAL_LIGHT_GREYLIST))
|
2018-05-08 16:49:02 +01:00
|
|
|
$(call assert-has-no-overlap,$@,$(LOCAL_SRC_FORCE_BLACKLIST))
|
2018-05-08 15:04:20 +01:00
|
|
|
|
|
|
|
|
# Generate blacklist as private API minus (light greylist plus dark greylist).
|
|
|
|
|
$(LOCAL_BLACKLIST): $(LOCAL_SRC_ALL) $(LOCAL_LIGHT_GREYLIST) $(LOCAL_DARK_GREYLIST)
|
|
|
|
|
comm -13 <(sort $(LOCAL_LIGHT_GREYLIST) $(LOCAL_DARK_GREYLIST)) \
|
|
|
|
|
<(sort $(LOCAL_SRC_PRIVATE_API)) \
|
|
|
|
|
> $@
|
|
|
|
|
$(call assert-is-subset,$@,$(LOCAL_SRC_PRIVATE_API))
|
|
|
|
|
$(call assert-has-no-duplicates,$@)
|
|
|
|
|
$(call assert-has-no-overlap,$@,$(LOCAL_LIGHT_GREYLIST))
|
|
|
|
|
$(call assert-has-no-overlap,$@,$(LOCAL_DARK_GREYLIST))
|
2018-05-08 16:49:02 +01:00
|
|
|
$(call assert-is-subset,$(LOCAL_SRC_FORCE_BLACKLIST),$@)
|
2018-01-22 22:23:13 +00:00
|
|
|
|
2018-05-02 15:47:32 +01:00
|
|
|
# Build AOSP blacklist
|
|
|
|
|
# ============================================================
|
|
|
|
|
include $(CLEAR_VARS)
|
|
|
|
|
|
|
|
|
|
LOCAL_LIGHT_GREYLIST_FILE := frameworks/base/config/hiddenapi-p-light-greylist.txt
|
|
|
|
|
LOCAL_BLACKLIST_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/hiddenapi-aosp-blacklist.txt
|
|
|
|
|
|
|
|
|
|
.PHONY: hiddenapi-aosp-blacklist
|
|
|
|
|
hiddenapi-aosp-blacklist: $(LOCAL_BLACKLIST_FILE)
|
|
|
|
|
|
|
|
|
|
$(LOCAL_BLACKLIST_FILE): $(LOCAL_LIGHT_GREYLIST_FILE) $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE)
|
|
|
|
|
LC_COLLATE=C comm -13 <(sort $(LOCAL_LIGHT_GREYLIST_FILE)) \
|
|
|
|
|
<(sort $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE)) > $@
|
|
|
|
|
|
2015-05-07 03:23:20 +00:00
|
|
|
# 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
|
|
|
|
|
|
2017-12-21 18:44:59 -08:00
|
|
|
endif # ANDROID_BUILD_EMBEDDED
|
