Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 1 | # |
| 2 | # Copyright (C) 2008 The Android Open Source Project |
| 3 | # |
| 4 | # Licensed under the Apache License, Version 2.0 (the "License"); |
| 5 | # you may not use this file except in compliance with the License. |
| 6 | # You may obtain a copy of the License at |
| 7 | # |
| 8 | # http://www.apache.org/licenses/LICENSE-2.0 |
| 9 | # |
| 10 | # Unless required by applicable law or agreed to in writing, software |
| 11 | # distributed under the License is distributed on an "AS IS" BASIS, |
| 12 | # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 13 | # See the License for the specific language governing permissions and |
| 14 | # limitations under the License. |
| 15 | # |
| 16 | LOCAL_PATH := $(call my-dir) |
| 17 | |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 18 | # Load framework-specific path mappings used later in the build. |
| 19 | include $(LOCAL_PATH)/pathmap.mk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 20 | |
| 21 | # Build the master framework library. |
| 22 | # The framework contains too many method references (>64K) for poor old DEX. |
| 23 | # So we first build the framework as a monolithic static library then split it |
| 24 | # up into smaller pieces. |
| 25 | # ============================================================ |
| 26 | |
| 27 | # embedded builds use nothing in frameworks/base |
| 28 | ifneq ($(ANDROID_BUILD_EMBEDDED),true) |
| 29 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 30 | # Copy AIDL files to be preprocessed and included in the SDK, |
| 31 | # specified relative to the root of the build tree. |
| 32 | # ============================================================ |
| 33 | include $(CLEAR_VARS) |
| 34 | |
Colin Cross | 77ebd08 | 2017-12-15 17:30:33 -0800 | [diff] [blame] | 35 | aidl_parcelables := |
| 36 | define stubs-to-aidl-parcelables |
| 37 | gen := $(TARGET_OUT_COMMON_INTERMEDIATES)/$1.aidl |
| 38 | aidl_parcelables += $$(gen) |
Colin Cross | fdbe7d1 | 2018-02-09 11:24:14 -0800 | [diff] [blame] | 39 | $$(gen): $(call java-lib-header-files,$1) $(HOST_OUT_EXECUTABLES)/sdkparcelables |
Colin Cross | 77ebd08 | 2017-12-15 17:30:33 -0800 | [diff] [blame] | 40 | @echo Extract SDK parcelables: $$@ |
| 41 | rm -f $$@ |
| 42 | $(HOST_OUT_EXECUTABLES)/sdkparcelables $$< $$@ |
| 43 | endef |
| 44 | |
| 45 | $(foreach stubs,android_stubs_current android_test_stubs_current android_system_stubs_current,\ |
| 46 | $(eval $(call stubs-to-aidl-parcelables,$(stubs)))) |
| 47 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 48 | gen := $(TARGET_OUT_COMMON_INTERMEDIATES)/framework.aidl |
Colin Cross | 77ebd08 | 2017-12-15 17:30:33 -0800 | [diff] [blame] | 49 | .KATI_RESTAT: $(gen) |
| 50 | $(gen): $(aidl_parcelables) |
| 51 | @echo Combining SDK parcelables: $@ |
| 52 | rm -f $@.tmp |
| 53 | cat $^ | sort -u > $@.tmp |
| 54 | $(call commit-change-for-toc,$@) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 55 | |
| 56 | # the documentation |
| 57 | # ============================================================ |
| 58 | |
| 59 | # TODO: deal with com/google/android/googleapps |
| 60 | packages_to_document := \ |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 61 | android \ |
| 62 | javax/microedition/khronos \ |
| 63 | org/apache/http/conn \ |
| 64 | org/apache/http/params \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 65 | |
| 66 | # include definition of libcore_to_document |
| 67 | include libcore/Docs.mk |
| 68 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 69 | non_base_dirs := \ |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 70 | ../opt/telephony/src/java/android/telephony \ |
| 71 | ../opt/telephony/src/java/android/telephony/gsm \ |
| 72 | ../opt/net/voip/src/java/android/net/rtp \ |
| 73 | ../opt/net/voip/src/java/android/net/sip \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 74 | |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 75 | # Find all files in specific directories (relative to frameworks/base) |
| 76 | # to document and check apis |
| 77 | files_to_check_apis := \ |
| 78 | $(call find-other-java-files, \ |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 79 | $(non_base_dirs) \ |
| 80 | ) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 81 | |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 82 | # Find all files in specific packages that were used to compile |
| 83 | # framework.jar to document and check apis |
| 84 | files_to_check_apis += \ |
| 85 | $(addprefix ../../,\ |
| 86 | $(filter \ |
| 87 | $(foreach dir,$(FRAMEWORKS_BASE_JAVA_SRC_DIRS),\ |
| 88 | $(foreach package,$(packages_to_document),\ |
| 89 | $(dir)/$(package)/%.java)),\ |
| 90 | $(SOONG_FRAMEWORK_SRCS))) |
| 91 | |
| 92 | # Find all generated files that were used to compile framework.jar |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 93 | files_to_check_apis_generated := \ |
| 94 | $(filter $(OUT_DIR)/%,\ |
| 95 | $(SOONG_FRAMEWORK_SRCS)) |
George Mount | f6be993 | 2015-12-03 07:39:55 -0800 | [diff] [blame] | 96 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 97 | # These are relative to frameworks/base |
| 98 | # FRAMEWORKS_BASE_SUBDIRS comes from build/core/pathmap.mk |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 99 | files_to_document := \ |
| 100 | $(files_to_check_apis) \ |
| 101 | $(call find-other-java-files,\ |
Paul Duffin | 187a48d | 2017-12-13 14:34:31 +0000 | [diff] [blame] | 102 | test-base/src \ |
Paul Duffin | 9f6282d | 2017-12-15 15:49:08 +0000 | [diff] [blame] | 103 | test-mock/src \ |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 104 | test-runner/src) |
George Mount | f6be993 | 2015-12-03 07:39:55 -0800 | [diff] [blame] | 105 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 106 | # These are relative to frameworks/base |
| 107 | html_dirs := \ |
| 108 | $(FRAMEWORKS_BASE_SUBDIRS) \ |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 109 | $(non_base_dirs) \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 110 | |
| 111 | # Common sources for doc check and api check |
| 112 | common_src_files := \ |
| 113 | $(call find-other-html-files, $(html_dirs)) \ |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 114 | $(addprefix ../../, $(libcore_to_document)) \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 115 | |
| 116 | # These are relative to frameworks/base |
| 117 | framework_docs_LOCAL_SRC_FILES := \ |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 118 | $(files_to_document) \ |
| 119 | $(common_src_files) \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 120 | |
| 121 | # These are relative to frameworks/base |
| 122 | framework_docs_LOCAL_API_CHECK_SRC_FILES := \ |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 123 | $(files_to_check_apis) \ |
| 124 | $(common_src_files) \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 125 | |
| 126 | # This is used by ide.mk as the list of source files that are |
| 127 | # always included. |
| 128 | INTERNAL_SDK_SOURCE_DIRS := $(addprefix $(LOCAL_PATH)/,$(dirs_to_document)) |
| 129 | |
| 130 | framework_docs_LOCAL_DROIDDOC_SOURCE_PATH := \ |
| 131 | $(FRAMEWORKS_BASE_JAVA_SRC_DIRS) |
| 132 | |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 133 | framework_docs_LOCAL_SRCJARS := $(SOONG_FRAMEWORK_SRCJARS) |
| 134 | |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 135 | framework_docs_LOCAL_GENERATED_SOURCES := \ |
| 136 | $(libcore_to_document_generated) \ |
| 137 | $(files_to_check_apis_generated) \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 138 | |
| 139 | framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES := \ |
Piotr Jastrzebski | cfa292e | 2015-02-17 16:58:52 +0000 | [diff] [blame] | 140 | core-oj \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 141 | core-libart \ |
| 142 | conscrypt \ |
| 143 | bouncycastle \ |
| 144 | okhttp \ |
| 145 | ext \ |
| 146 | framework \ |
Paul Duffin | c08090f | 2017-06-29 14:58:43 +0100 | [diff] [blame] | 147 | voip-common \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 148 | |
Alan Viverette | 9ca513e | 2017-04-05 10:21:58 -0400 | [diff] [blame] | 149 | # Platform docs can refer to Support Library APIs, but we don't actually build |
| 150 | # them as part of the docs target, so we need to include them on the classpath. |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 151 | framework_docs_LOCAL_JAVA_LIBRARIES := \ |
| 152 | $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) \ |
| 153 | $(FRAMEWORKS_SUPPORT_JAVA_LIBRARIES) |
| 154 | |
| 155 | framework_docs_LOCAL_MODULE_CLASS := JAVA_LIBRARIES |
| 156 | framework_docs_LOCAL_DROIDDOC_HTML_DIR := docs/html |
| 157 | # The since flag (-since N.xml API_LEVEL) is used to add API Level information |
| 158 | # to the reference documentation. Must be in order of oldest to newest. |
| 159 | # |
| 160 | # Conscrypt (com.android.org.conscrypt) is an implementation detail and should |
| 161 | # not be referenced in the documentation. |
| 162 | framework_docs_LOCAL_DROIDDOC_OPTIONS := \ |
Jeff Sharkey | 0f3f60b | 2017-04-24 18:06:20 -0600 | [diff] [blame] | 163 | -android \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 164 | -knowntags ./frameworks/base/docs/knowntags.txt \ |
Narayan Kamath | 2c4f284 | 2015-07-27 14:02:11 +0100 | [diff] [blame] | 165 | -knowntags ./libcore/known_oj_tags.txt \ |
Jeff Sharkey | bfc4fcd | 2017-06-05 17:38:17 -0600 | [diff] [blame] | 166 | -manifest ./frameworks/base/core/res/AndroidManifest.xml \ |
Tobias Thierer | dda16e8 | 2018-03-05 22:55:32 +0000 | [diff] [blame] | 167 | -hidePackage com.android.internal \ |
| 168 | -hidePackage com.android.internal.util \ |
Neil Fuller | 57157fb | 2017-11-24 15:58:38 +0000 | [diff] [blame] | 169 | -hidePackage com.android.okhttp \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 170 | -hidePackage com.android.org.conscrypt \ |
Neil Fuller | 371c08c | 2017-11-27 10:32:07 +0000 | [diff] [blame] | 171 | -hidePackage com.android.server \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 172 | -since $(SRC_API_DIR)/1.xml 1 \ |
| 173 | -since $(SRC_API_DIR)/2.xml 2 \ |
| 174 | -since $(SRC_API_DIR)/3.xml 3 \ |
| 175 | -since $(SRC_API_DIR)/4.xml 4 \ |
| 176 | -since $(SRC_API_DIR)/5.xml 5 \ |
| 177 | -since $(SRC_API_DIR)/6.xml 6 \ |
| 178 | -since $(SRC_API_DIR)/7.xml 7 \ |
| 179 | -since $(SRC_API_DIR)/8.xml 8 \ |
| 180 | -since $(SRC_API_DIR)/9.xml 9 \ |
| 181 | -since $(SRC_API_DIR)/10.xml 10 \ |
| 182 | -since $(SRC_API_DIR)/11.xml 11 \ |
| 183 | -since $(SRC_API_DIR)/12.xml 12 \ |
| 184 | -since $(SRC_API_DIR)/13.xml 13 \ |
| 185 | -since $(SRC_API_DIR)/14.txt 14 \ |
| 186 | -since $(SRC_API_DIR)/15.txt 15 \ |
| 187 | -since $(SRC_API_DIR)/16.txt 16 \ |
| 188 | -since $(SRC_API_DIR)/17.txt 17 \ |
| 189 | -since $(SRC_API_DIR)/18.txt 18 \ |
| 190 | -since $(SRC_API_DIR)/19.txt 19 \ |
| 191 | -since $(SRC_API_DIR)/20.txt 20 \ |
| 192 | -since $(SRC_API_DIR)/21.txt 21 \ |
| 193 | -since $(SRC_API_DIR)/22.txt 22 \ |
Joe Fernandez | 1827e32 | 2015-08-12 19:45:22 -0700 | [diff] [blame] | 194 | -since $(SRC_API_DIR)/23.txt 23 \ |
Dirk Dougherty | 5f60f7c | 2016-06-14 16:26:28 -0700 | [diff] [blame] | 195 | -since $(SRC_API_DIR)/24.txt 24 \ |
Dirk Dougherty | 3376f58 | 2016-10-14 10:27:08 -0700 | [diff] [blame] | 196 | -since $(SRC_API_DIR)/25.txt 25 \ |
Dirk Dougherty | fdad0ba | 2017-06-09 14:43:32 -0700 | [diff] [blame] | 197 | -since $(SRC_API_DIR)/26.txt 26 \ |
Andrew Solovay | a6019b2 | 2017-10-06 14:27:20 -0700 | [diff] [blame] | 198 | -since $(SRC_API_DIR)/27.txt 27 \ |
Anton Hansson | 092d9b8 | 2018-04-19 14:04:32 +0100 | [diff] [blame] | 199 | -since $(SRC_API_DIR)/28.txt 28 \ |
Jeff Sharkey | c204c22 | 2017-11-27 15:02:10 -0700 | [diff] [blame] | 200 | -werror -lerror -hide 111 -hide 113 -hide 125 -hide 126 -hide 127 -hide 128 \ |
Jeff Sharkey | 0f3f60b | 2017-04-24 18:06:20 -0600 | [diff] [blame] | 201 | -overview $(LOCAL_PATH)/core/java/overview.html \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 202 | |
| 203 | framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR:= \ |
| 204 | $(call intermediates-dir-for,JAVA_LIBRARIES,framework,,COMMON) |
| 205 | |
| 206 | framework_docs_LOCAL_ADDITIONAL_JAVA_DIR:= \ |
Alan Viverette | 9ca513e | 2017-04-05 10:21:58 -0400 | [diff] [blame] | 207 | $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 208 | |
| 209 | framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES := \ |
Narayan Kamath | c21739a | 2015-07-14 13:39:23 +0100 | [diff] [blame] | 210 | frameworks/base/docs/knowntags.txt \ |
Colin Cross | 72d359f | 2017-10-27 10:46:53 -0700 | [diff] [blame] | 211 | $(libcore_to_document_generated) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 212 | |
| 213 | samples_dir := development/samples/browseable |
| 214 | |
| 215 | # Whitelist of valid groups, used for default TOC grouping. Each sample must |
| 216 | # belong to one (and only one) group. Assign samples to groups by setting |
| 217 | # a sample.group var to one of these groups in the sample's _index.jd. |
| 218 | sample_groups := -samplegroup Admin \ |
| 219 | -samplegroup Background \ |
| 220 | -samplegroup Connectivity \ |
| 221 | -samplegroup Content \ |
| 222 | -samplegroup Input \ |
| 223 | -samplegroup Media \ |
| 224 | -samplegroup Notification \ |
| 225 | -samplegroup RenderScript \ |
| 226 | -samplegroup Security \ |
| 227 | -samplegroup Sensors \ |
Trevor Johns | 4cbe359 | 2015-05-27 14:50:51 -0700 | [diff] [blame] | 228 | -samplegroup System \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 229 | -samplegroup Testing \ |
| 230 | -samplegroup UI \ |
| 231 | -samplegroup Views \ |
| 232 | -samplegroup Wearable |
| 233 | |
| 234 | ## SDK version identifiers used in the published docs |
| 235 | # major[.minor] version for current SDK. (full releases only) |
smain@google.com | dde8deb | 2016-08-29 18:36:50 -0700 | [diff] [blame] | 236 | framework_docs_SDK_VERSION:=7.0 |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 237 | # release version (ie "Release x") (full releases only) |
| 238 | framework_docs_SDK_REL_ID:=1 |
| 239 | |
| 240 | framework_docs_LOCAL_DROIDDOC_OPTIONS += \ |
Billy Lamberta | 75dbc8f | 2017-03-03 13:09:15 -0800 | [diff] [blame] | 241 | -hdf dac true \ |
Scott Main | f8cdfc8 | 2017-03-21 13:43:31 -0700 | [diff] [blame] | 242 | -hdf sdk.codename O \ |
| 243 | -hdf sdk.preview.version 1 \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 244 | -hdf sdk.version $(framework_docs_SDK_VERSION) \ |
| 245 | -hdf sdk.rel.id $(framework_docs_SDK_REL_ID) \ |
Scott Main | f8cdfc8 | 2017-03-21 13:43:31 -0700 | [diff] [blame] | 246 | -hdf sdk.preview 0 \ |
| 247 | -resourcesdir $(LOCAL_PATH)/docs/html/reference/images/ \ |
| 248 | -resourcesoutdir reference/android/images/ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 249 | |
Alan Viverette | 9ca513e | 2017-04-05 10:21:58 -0400 | [diff] [blame] | 250 | # Federate Support Library references against local API file. |
| 251 | framework_docs_LOCAL_DROIDDOC_OPTIONS += \ |
| 252 | -federate SupportLib https://developer.android.com \ |
| 253 | -federationapi SupportLib prebuilts/sdk/current/support-api.txt |
| 254 | |
Alan Viverette | 67b51d4 | 2018-03-28 17:10:20 -0400 | [diff] [blame] | 255 | # Federate AndroidX references against local API file. |
| 256 | framework_docs_LOCAL_DROIDDOC_OPTIONS += \ |
| 257 | -federate AndroidX https://developer.android.com \ |
| 258 | -federationapi AndroidX prebuilts/sdk/current/androidx-api.txt |
| 259 | |
Nan Zhang | bd9eda5 | 2018-06-05 19:01:32 -0700 | [diff] [blame^] | 260 | framework_metalava_docs_LOCAL_DROIDDOC_OPTIONS := \ |
| 261 | --manifest ./frameworks/base/core/res/AndroidManifest.xml \ |
| 262 | --hide-package com.android.okhttp \ |
| 263 | --hide-package com.android.org.conscrypt --hide-package com.android.server \ |
| 264 | --hide RequiresPermission \ |
| 265 | --hide MissingPermission --hide BroadcastBehavior \ |
| 266 | --hide HiddenSuperclass --hide DeprecationMismatch --hide UnavailableSymbol \ |
| 267 | --hide SdkConstant --hide HiddenTypeParameter --hide Todo --hide Typo |
| 268 | |
Jeff Sharkey | d2bf31c | 2017-11-29 13:14:27 -0700 | [diff] [blame] | 269 | # ==== Public API diff =========================== |
Alan Viverette | 6b7354c | 2017-07-13 17:10:14 -0400 | [diff] [blame] | 270 | include $(CLEAR_VARS) |
| 271 | |
| 272 | LOCAL_SRC_FILES := $(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 273 | LOCAL_GENERATED_SOURCES := $(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 274 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Alan Viverette | 6b7354c | 2017-07-13 17:10:14 -0400 | [diff] [blame] | 275 | LOCAL_JAVA_LIBRARIES := $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| 276 | LOCAL_MODULE_CLASS := $(framework_docs_LOCAL_MODULE_CLASS) |
| 277 | LOCAL_ADDITIONAL_JAVA_DIR := $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| 278 | LOCAL_ADDITIONAL_DEPENDENCIES := \ |
| 279 | $(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) \ |
| 280 | $(INTERNAL_PLATFORM_API_FILE) |
| 281 | |
| 282 | LOCAL_MODULE := offline-sdk-referenceonly |
| 283 | |
| 284 | last_released_sdk_version := $(lastword $(call numerically_sort, \ |
| 285 | $(filter-out current, \ |
| 286 | $(patsubst $(SRC_API_DIR)/%.txt,%, $(wildcard $(SRC_API_DIR)/*.txt)) \ |
| 287 | )\ |
| 288 | )) |
| 289 | |
| 290 | LOCAL_APIDIFF_OLDAPI := $(LOCAL_PATH)/../../$(SRC_API_DIR)/$(last_released_sdk_version) |
| 291 | LOCAL_APIDIFF_NEWAPI := $(LOCAL_PATH)/../../$(basename $(INTERNAL_PLATFORM_API_FILE)) |
| 292 | |
| 293 | include $(BUILD_APIDIFF) |
| 294 | |
Jeff Sharkey | c8dc254 | 2017-12-08 14:52:37 -0700 | [diff] [blame] | 295 | # Hack to get diffs included in docs output |
| 296 | out_zip := $(OUT_DOCS)/$(LOCAL_MODULE)-docs.zip |
| 297 | $(out_zip): $(full_target) |
| 298 | |
Jeff Sharkey | d2bf31c | 2017-11-29 13:14:27 -0700 | [diff] [blame] | 299 | # ==== System API diff =========================== |
| 300 | include $(CLEAR_VARS) |
| 301 | |
| 302 | LOCAL_SRC_FILES := $(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 303 | LOCAL_GENERATED_SOURCES := $(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 304 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Jeff Sharkey | d2bf31c | 2017-11-29 13:14:27 -0700 | [diff] [blame] | 305 | LOCAL_JAVA_LIBRARIES := $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| 306 | LOCAL_MODULE_CLASS := $(framework_docs_LOCAL_MODULE_CLASS) |
| 307 | LOCAL_ADDITIONAL_JAVA_DIR := $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| 308 | LOCAL_ADDITIONAL_DEPENDENCIES := \ |
| 309 | $(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) \ |
| 310 | $(INTERNAL_PLATFORM_SYSTEM_API_FILE) |
| 311 | |
| 312 | LOCAL_MODULE := offline-system-sdk-referenceonly |
| 313 | |
| 314 | last_released_sdk_version := $(lastword $(call numerically_sort, \ |
| 315 | $(filter-out current, \ |
| 316 | $(patsubst $(SRC_SYSTEM_API_DIR)/%.txt,%, $(wildcard $(SRC_SYSTEM_API_DIR)/*.txt)) \ |
| 317 | )\ |
| 318 | )) |
| 319 | |
| 320 | LOCAL_APIDIFF_OLDAPI := $(LOCAL_PATH)/../../$(SRC_SYSTEM_API_DIR)/$(last_released_sdk_version) |
| 321 | LOCAL_APIDIFF_NEWAPI := $(LOCAL_PATH)/../../$(basename $(INTERNAL_PLATFORM_SYSTEM_API_FILE)) |
| 322 | |
| 323 | include $(BUILD_APIDIFF) |
| 324 | |
Jeff Sharkey | c8dc254 | 2017-12-08 14:52:37 -0700 | [diff] [blame] | 325 | # Hack to get diffs included in docs output |
| 326 | out_zip := $(OUT_DOCS)/$(LOCAL_MODULE)-docs.zip |
| 327 | $(out_zip): $(full_target) |
| 328 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 329 | # ==== the api stubs and current.xml =========================== |
| 330 | include $(CLEAR_VARS) |
| 331 | |
| 332 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 333 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 334 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 335 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| 336 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 337 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 338 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 339 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| 340 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 341 | |
| 342 | LOCAL_MODULE := api-stubs |
| 343 | |
Ying Wang | 0f92a2e | 2015-07-16 14:20:22 -0700 | [diff] [blame] | 344 | LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_stubs_current_intermediates/src |
| 345 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 346 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 347 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 348 | -referenceonly \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 349 | -api $(INTERNAL_PLATFORM_API_FILE) \ |
| 350 | -removedApi $(INTERNAL_PLATFORM_REMOVED_API_FILE) \ |
| 351 | -nodocs |
| 352 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 353 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 354 | |
| 355 | LOCAL_UNINSTALLABLE_MODULE := true |
| 356 | |
| 357 | include $(BUILD_DROIDDOC) |
| 358 | |
David Brazdil | a793f3f | 2018-01-16 15:03:20 +0000 | [diff] [blame] | 359 | $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_API_FILE) \ |
David Brazdil | 68e1c1d | 2018-03-08 14:32:27 +0000 | [diff] [blame] | 360 | $(INTERNAL_PLATFORM_REMOVED_API_FILE) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 361 | $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_API_FILE)) |
| 362 | |
Nan Zhang | bd9eda5 | 2018-06-05 19:01:32 -0700 | [diff] [blame^] | 363 | # ==== the metalava api stubs and current.xml =========================== |
| 364 | include $(CLEAR_VARS) |
| 365 | |
| 366 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
| 367 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
| 368 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| 369 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| 370 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 371 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 372 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| 373 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 374 | |
| 375 | LOCAL_MODULE := metalava-api-stubs |
| 376 | LOCAL_DROIDDOC_USE_METALAVA := true |
| 377 | |
| 378 | LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/metalava_android_stubs_current_intermediates/src |
| 379 | |
| 380 | INTERNAL_PLATFORM_METALAVA_PUBLIC_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava_public_api.txt |
| 381 | INTERNAL_PLATFORM_METALAVA_PUBLIC_REMOVED_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava_removed.txt |
| 382 | |
| 383 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 384 | $(framework_metalava_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 385 | --api $(INTERNAL_PLATFORM_METALAVA_PUBLIC_API_FILE) \ |
| 386 | --removed-api $(INTERNAL_PLATFORM_METALAVA_PUBLIC_REMOVED_API_FILE) \ |
| 387 | -nodocs |
| 388 | |
| 389 | LOCAL_UNINSTALLABLE_MODULE := true |
| 390 | |
| 391 | include $(BUILD_DROIDDOC) |
| 392 | |
| 393 | $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_METALAVA_PUBLIC_API_FILE) \ |
| 394 | $(INTERNAL_PLATFORM_METALAVA_PUBLIC_REMOVED_API_FILE) |
| 395 | $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_METALAVA_PUBLIC_API_FILE)) |
| 396 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 397 | # ==== the system api stubs =================================== |
| 398 | include $(CLEAR_VARS) |
| 399 | |
| 400 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 401 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 402 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 403 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| 404 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 405 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 406 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 407 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| 408 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 409 | |
| 410 | LOCAL_MODULE := system-api-stubs |
| 411 | |
Ying Wang | 0f92a2e | 2015-07-16 14:20:22 -0700 | [diff] [blame] | 412 | LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_system_stubs_current_intermediates/src |
| 413 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 414 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 415 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 416 | -referenceonly \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 417 | -showAnnotation android.annotation.SystemApi \ |
| 418 | -api $(INTERNAL_PLATFORM_SYSTEM_API_FILE) \ |
| 419 | -removedApi $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE) \ |
Jeff Sharkey | 05461c0 | 2017-05-09 19:01:09 -0600 | [diff] [blame] | 420 | -exactApi $(INTERNAL_PLATFORM_SYSTEM_EXACT_API_FILE) \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 421 | -nodocs |
| 422 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 423 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 424 | |
| 425 | LOCAL_UNINSTALLABLE_MODULE := true |
| 426 | |
| 427 | include $(BUILD_DROIDDOC) |
| 428 | |
David Brazdil | a793f3f | 2018-01-16 15:03:20 +0000 | [diff] [blame] | 429 | $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_SYSTEM_API_FILE) \ |
David Brazdil | 68e1c1d | 2018-03-08 14:32:27 +0000 | [diff] [blame] | 430 | $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE) \ |
| 431 | $(INTERNAL_PLATFORM_SYSTEM_EXACT_API_FILE) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 432 | $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_SYSTEM_API_FILE)) |
| 433 | |
Nan Zhang | bd9eda5 | 2018-06-05 19:01:32 -0700 | [diff] [blame^] | 434 | # ==== the metalava system api stubs =================================== |
| 435 | include $(CLEAR_VARS) |
| 436 | |
| 437 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
| 438 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
| 439 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| 440 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| 441 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 442 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 443 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| 444 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 445 | |
| 446 | LOCAL_MODULE := metalava-system-api-stubs |
| 447 | LOCAL_DROIDDOC_USE_METALAVA := true |
| 448 | |
| 449 | LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/metalava_android_system_stubs_current_intermediates/src |
| 450 | |
| 451 | INTERNAL_PLATFORM_METALAVA_SYSTEM_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava-system-api.txt |
| 452 | INTERNAL_PLATFORM_METALAVA_SYSTEM_REMOVED_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava-system-removed.txt |
| 453 | |
| 454 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 455 | $(framework_metalava_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 456 | --show-annotation android.annotation.SystemApi \ |
| 457 | --api $(INTERNAL_PLATFORM_METALAVA_SYSTEM_API_FILE) \ |
| 458 | --removed-api $(INTERNAL_PLATFORM_METALAVA_SYSTEM_REMOVED_API_FILE) \ |
| 459 | -nodocs |
| 460 | |
| 461 | LOCAL_UNINSTALLABLE_MODULE := true |
| 462 | |
| 463 | include $(BUILD_DROIDDOC) |
| 464 | |
| 465 | $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_METALAVA_SYSTEM_API_FILE) \ |
| 466 | $(INTERNAL_PLATFORM_METALAVA_SYSTEM_REMOVED_API_FILE) \ |
| 467 | $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_METALAVA_SYSTEM_API_FILE)) |
| 468 | |
Michael Wright | b2b2c0e | 2015-11-06 15:21:13 +0000 | [diff] [blame] | 469 | # ==== the test api stubs =================================== |
| 470 | include $(CLEAR_VARS) |
| 471 | |
| 472 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 473 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 474 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Michael Wright | b2b2c0e | 2015-11-06 15:21:13 +0000 | [diff] [blame] | 475 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| 476 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 477 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 478 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 479 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| 480 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 481 | |
| 482 | LOCAL_MODULE := test-api-stubs |
| 483 | |
| 484 | LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src |
| 485 | |
| 486 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 487 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 488 | -referenceonly \ |
Michael Wright | b2b2c0e | 2015-11-06 15:21:13 +0000 | [diff] [blame] | 489 | -stubs $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src \ |
| 490 | -showAnnotation android.annotation.TestApi \ |
| 491 | -api $(INTERNAL_PLATFORM_TEST_API_FILE) \ |
| 492 | -removedApi $(INTERNAL_PLATFORM_TEST_REMOVED_API_FILE) \ |
Jeff Sharkey | 05461c0 | 2017-05-09 19:01:09 -0600 | [diff] [blame] | 493 | -exactApi $(INTERNAL_PLATFORM_TEST_EXACT_API_FILE) \ |
Michael Wright | b2b2c0e | 2015-11-06 15:21:13 +0000 | [diff] [blame] | 494 | -nodocs |
| 495 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 496 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Michael Wright | b2b2c0e | 2015-11-06 15:21:13 +0000 | [diff] [blame] | 497 | |
| 498 | LOCAL_UNINSTALLABLE_MODULE := true |
| 499 | |
| 500 | include $(BUILD_DROIDDOC) |
| 501 | |
David Brazdil | 68e1c1d | 2018-03-08 14:32:27 +0000 | [diff] [blame] | 502 | $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_TEST_API_FILE) \ |
| 503 | $(INTERNAL_PLATFORM_TEST_REMOVED_API_FILE) \ |
| 504 | $(INTERNAL_PLATFORM_TEST_EXACT_API_FILE) |
Michael Wright | b2b2c0e | 2015-11-06 15:21:13 +0000 | [diff] [blame] | 505 | $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_TEST_API_FILE)) |
| 506 | |
Nan Zhang | bd9eda5 | 2018-06-05 19:01:32 -0700 | [diff] [blame^] | 507 | # ==== the metalava test api stubs =================================== |
| 508 | include $(CLEAR_VARS) |
| 509 | |
| 510 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
| 511 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
| 512 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| 513 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| 514 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 515 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 516 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| 517 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 518 | |
| 519 | LOCAL_MODULE := metalava-test-api-stubs |
| 520 | LOCAL_DROIDDOC_USE_METALAVA := true |
| 521 | |
| 522 | LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/metalava_android_test_stubs_current_intermediates/src |
| 523 | |
| 524 | INTERNAL_PLATFORM_METALAVA_TEST_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava-test-api.txt |
| 525 | INTERNAL_PLATFORM_METALAVA_TEST_REMOVED_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava-test-removed.txt |
| 526 | |
| 527 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 528 | $(framework_metalava_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 529 | --show-annotation android.annotation.TestApi \ |
| 530 | --api $(INTERNAL_PLATFORM_METALAVA_TEST_API_FILE) \ |
| 531 | --removed-api $(INTERNAL_PLATFORM_METALAVA_TEST_REMOVED_API_FILE) \ |
| 532 | -nodocs |
| 533 | |
| 534 | LOCAL_UNINSTALLABLE_MODULE := true |
| 535 | |
| 536 | include $(BUILD_DROIDDOC) |
| 537 | |
| 538 | $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_METALAVA_TEST_API_FILE) \ |
| 539 | $(INTERNAL_PLATFORM_METALAVA_TEST_REMOVED_API_FILE) \ |
| 540 | $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_METALAVA_TEST_API_FILE)) |
| 541 | |
David Brazdil | 68e1c1d | 2018-03-08 14:32:27 +0000 | [diff] [blame] | 542 | # ==== the complete hidden api list =================================== |
| 543 | include $(CLEAR_VARS) |
| 544 | |
| 545 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
| 546 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
| 547 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| 548 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| 549 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 550 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 551 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 552 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| 553 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 554 | |
| 555 | LOCAL_MODULE := hidden-api-list |
| 556 | |
| 557 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 558 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 559 | -referenceonly \ |
| 560 | -showUnannotated \ |
| 561 | -showAnnotation android.annotation.SystemApi \ |
| 562 | -showAnnotation android.annotation.TestApi \ |
David Brazdil | 94c2ab6 | 2018-05-30 13:59:11 +0100 | [diff] [blame] | 563 | -dexApi $(INTERNAL_PLATFORM_DEX_API_FILE) \ |
David Brazdil | 68e1c1d | 2018-03-08 14:32:27 +0000 | [diff] [blame] | 564 | -privateDexApi $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) \ |
David Brazdil | 0f0abb2 | 2018-04-26 16:10:35 +0100 | [diff] [blame] | 565 | -removedDexApi $(INTERNAL_PLATFORM_REMOVED_DEX_API_FILE) \ |
David Brazdil | 68e1c1d | 2018-03-08 14:32:27 +0000 | [diff] [blame] | 566 | -nodocs |
| 567 | |
| 568 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
| 569 | |
| 570 | LOCAL_UNINSTALLABLE_MODULE := true |
| 571 | |
| 572 | include $(BUILD_DROIDDOC) |
| 573 | |
David Brazdil | 94c2ab6 | 2018-05-30 13:59:11 +0100 | [diff] [blame] | 574 | $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_DEX_API_FILE) \ |
| 575 | $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) \ |
David Brazdil | 0f0abb2 | 2018-04-26 16:10:35 +0100 | [diff] [blame] | 576 | $(INTERNAL_PLATFORM_REMOVED_DEX_API_FILE) |
David Brazdil | 68e1c1d | 2018-03-08 14:32:27 +0000 | [diff] [blame] | 577 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 578 | # ==== check javadoc comments but don't generate docs ======== |
| 579 | include $(CLEAR_VARS) |
| 580 | |
| 581 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 582 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 583 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 584 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 585 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 586 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 587 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 588 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 589 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 590 | |
| 591 | LOCAL_MODULE := doc-comment-check |
| 592 | |
| 593 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 594 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 595 | -referenceonly \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 596 | -parsecomments |
| 597 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 598 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 599 | |
| 600 | LOCAL_UNINSTALLABLE_MODULE := true |
| 601 | |
| 602 | include $(BUILD_DROIDDOC) |
| 603 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 604 | # Run this for checkbuild |
| 605 | checkbuild: doc-comment-check-docs |
| 606 | # Check comment when you are updating the API |
| 607 | update-api: doc-comment-check-docs |
| 608 | |
| 609 | # ==== static html in the sdk ================================== |
| 610 | include $(CLEAR_VARS) |
| 611 | |
| 612 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 613 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 614 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 615 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 616 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 617 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 618 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 619 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 620 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 621 | |
| 622 | LOCAL_MODULE := offline-sdk |
| 623 | |
| 624 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 625 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 626 | -offlinemode \ |
| 627 | -title "Android SDK" \ |
| 628 | -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \ |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 629 | -sdkvalues $(OUT_DOCS) \ |
smain@google.com | 8562ab5 | 2016-06-14 17:11:57 -0700 | [diff] [blame] | 630 | -hdf android.whichdoc offline |
| 631 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 632 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
smain@google.com | 8562ab5 | 2016-06-14 17:11:57 -0700 | [diff] [blame] | 633 | |
| 634 | include $(BUILD_DROIDDOC) |
| 635 | |
| 636 | static_doc_index_redirect := $(out_dir)/index.html |
| 637 | $(static_doc_index_redirect): \ |
| 638 | $(LOCAL_PATH)/docs/docs-preview-index.html | $(ACP) |
| 639 | $(hide) mkdir -p $(dir $@) |
| 640 | $(hide) $(ACP) $< $@ |
| 641 | |
| 642 | $(full_target): $(static_doc_index_redirect) |
smain@google.com | 8562ab5 | 2016-06-14 17:11:57 -0700 | [diff] [blame] | 643 | |
| 644 | |
Jeff Sharkey | d2bf31c | 2017-11-29 13:14:27 -0700 | [diff] [blame] | 645 | # ==== Public API static reference docs ================================== |
smain@google.com | 8562ab5 | 2016-06-14 17:11:57 -0700 | [diff] [blame] | 646 | include $(CLEAR_VARS) |
| 647 | |
| 648 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 649 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 650 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
smain@google.com | 8562ab5 | 2016-06-14 17:11:57 -0700 | [diff] [blame] | 651 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 652 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 653 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 654 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 655 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 656 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 657 | |
| 658 | LOCAL_MODULE := offline-sdk-referenceonly |
| 659 | |
| 660 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 661 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 662 | -offlinemode \ |
| 663 | -title "Android SDK" \ |
| 664 | -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \ |
| 665 | -sdkvalues $(OUT_DOCS) \ |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 666 | -hdf android.whichdoc offline \ |
Scott Main | f8cdfc8 | 2017-03-21 13:43:31 -0700 | [diff] [blame] | 667 | -referenceonly |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 668 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 669 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 670 | |
| 671 | include $(BUILD_DROIDDOC) |
| 672 | |
| 673 | static_doc_index_redirect := $(out_dir)/index.html |
smain@google.com | 151833a | 2016-08-31 08:42:09 -0700 | [diff] [blame] | 674 | $(static_doc_index_redirect): $(LOCAL_PATH)/docs/docs-documentation-redirect.html |
Dan Willemsen | 98ff0b7 | 2016-03-23 00:42:44 -0700 | [diff] [blame] | 675 | $(copy-file-to-target) |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 676 | |
smain@google.com | 2f2365d | 2016-09-21 14:05:50 -0700 | [diff] [blame] | 677 | static_doc_properties := $(out_dir)/source.properties |
| 678 | $(static_doc_properties): \ |
| 679 | $(LOCAL_PATH)/docs/source.properties | $(ACP) |
| 680 | $(hide) mkdir -p $(dir $@) |
| 681 | $(hide) $(ACP) $< $@ |
| 682 | |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 683 | $(full_target): $(static_doc_index_redirect) |
smain@google.com | 2f2365d | 2016-09-21 14:05:50 -0700 | [diff] [blame] | 684 | $(full_target): $(static_doc_properties) |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 685 | |
smain@google.com | 7aca8be | 2016-03-10 14:13:30 -0800 | [diff] [blame] | 686 | |
Jeff Sharkey | d2bf31c | 2017-11-29 13:14:27 -0700 | [diff] [blame] | 687 | # ==== System API static reference docs ================================== |
| 688 | include $(CLEAR_VARS) |
| 689 | |
| 690 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 691 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 692 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Jeff Sharkey | d2bf31c | 2017-11-29 13:14:27 -0700 | [diff] [blame] | 693 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 694 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 695 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 696 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 697 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 698 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 699 | |
| 700 | LOCAL_MODULE := offline-system-sdk-referenceonly |
| 701 | |
| 702 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 703 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 704 | -hide 101 -hide 104 -hide 108 \ |
| 705 | -showAnnotation android.annotation.SystemApi \ |
| 706 | -offlinemode \ |
| 707 | -title "Android System SDK" \ |
| 708 | -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \ |
| 709 | -sdkvalues $(OUT_DOCS) \ |
| 710 | -hdf android.whichdoc offline \ |
| 711 | -referenceonly |
| 712 | |
| 713 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
| 714 | |
| 715 | include $(BUILD_DROIDDOC) |
| 716 | |
| 717 | static_doc_index_redirect := $(out_dir)/index.html |
| 718 | $(static_doc_index_redirect): $(LOCAL_PATH)/docs/docs-documentation-redirect.html |
| 719 | $(copy-file-to-target) |
| 720 | |
| 721 | static_doc_properties := $(out_dir)/source.properties |
| 722 | $(static_doc_properties): \ |
| 723 | $(LOCAL_PATH)/docs/source.properties | $(ACP) |
| 724 | $(hide) mkdir -p $(dir $@) |
| 725 | $(hide) $(ACP) $< $@ |
| 726 | |
| 727 | $(full_target): $(static_doc_index_redirect) |
| 728 | $(full_target): $(static_doc_properties) |
| 729 | $(full_target): $(framework_built) |
| 730 | |
| 731 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 732 | # ==== docs for the web (on the androiddevdocs app engine server) ======================= |
| 733 | include $(CLEAR_VARS) |
| 734 | |
| 735 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 736 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 737 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 738 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 739 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 740 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 741 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 742 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 743 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 744 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 745 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
| 746 | |
| 747 | LOCAL_MODULE := online-sdk |
| 748 | |
| 749 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 750 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 751 | -toroot / \ |
| 752 | -hdf android.whichdoc online \ |
| 753 | $(sample_groups) \ |
| 754 | -hdf android.hasSamples true \ |
| 755 | -samplesdir $(samples_dir) |
| 756 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 757 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 758 | |
| 759 | include $(BUILD_DROIDDOC) |
| 760 | |
| 761 | # ==== docs for the web (on the androiddevdocs app engine server) ======================= |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 762 | include $(CLEAR_VARS) |
| 763 | |
| 764 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 765 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 766 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 767 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 768 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 769 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 770 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 771 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 772 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 773 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 774 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
| 775 | |
| 776 | LOCAL_MODULE := online-system-api-sdk |
| 777 | |
| 778 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 779 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 780 | -referenceonly \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 781 | -showAnnotation android.annotation.SystemApi \ |
| 782 | -title "Android SDK - Including system APIs." \ |
| 783 | -toroot / \ |
Gina Dimino | 98ad888 | 2016-05-31 17:25:48 -0700 | [diff] [blame] | 784 | -hide 101 \ |
| 785 | -hide 104 \ |
| 786 | -hide 108 \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 787 | -hdf android.whichdoc online \ |
| 788 | $(sample_groups) \ |
| 789 | -hdf android.hasSamples true \ |
| 790 | -samplesdir $(samples_dir) |
| 791 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 792 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Jeff Sharkey | 05461c0 | 2017-05-09 19:01:09 -0600 | [diff] [blame] | 793 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 794 | LOCAL_UNINSTALLABLE_MODULE := true |
| 795 | |
| 796 | include $(BUILD_DROIDDOC) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 797 | |
| 798 | # ==== docs for the web (on the devsite app engine server) ======================= |
| 799 | include $(CLEAR_VARS) |
| 800 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 801 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 802 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 803 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 804 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 805 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 806 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 807 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 808 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 809 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 810 | # specify a second html input dir and an output path relative to OUT_DIR) |
Dirk Dougherty | 3852c1f | 2016-04-10 02:05:09 -0700 | [diff] [blame] | 811 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 812 | |
| 813 | LOCAL_MODULE := ds |
| 814 | |
| 815 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 816 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 817 | -toroot / \ |
| 818 | -hdf android.whichdoc online \ |
Dirk Dougherty | b042ab1 | 2016-06-14 16:26:28 -0700 | [diff] [blame] | 819 | -devsite \ |
Scott Main | 4f9b48c | 2017-12-19 13:43:45 -0800 | [diff] [blame] | 820 | -yamlV2 \ |
Dirk Dougherty | 3852c1f | 2016-04-10 02:05:09 -0700 | [diff] [blame] | 821 | $(sample_groups) \ |
Dirk Dougherty | 3852c1f | 2016-04-10 02:05:09 -0700 | [diff] [blame] | 822 | -hdf android.hasSamples true \ |
| 823 | -samplesdir $(samples_dir) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 824 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 825 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 826 | |
| 827 | include $(BUILD_DROIDDOC) |
| 828 | |
Dirk Dougherty | b042ab1 | 2016-06-14 16:26:28 -0700 | [diff] [blame] | 829 | # ==== docs for the web (on the devsite app engine server) ======================= |
| 830 | include $(CLEAR_VARS) |
| 831 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 832 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 833 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Dirk Dougherty | b042ab1 | 2016-06-14 16:26:28 -0700 | [diff] [blame] | 834 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 835 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 836 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 837 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 838 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 839 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 840 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 841 | # specify a second html input dir and an output path relative to OUT_DIR) |
| 842 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
| 843 | |
| 844 | LOCAL_MODULE := ds-static |
| 845 | |
| 846 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 847 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 848 | -hdf android.whichdoc online \ |
| 849 | -staticonly \ |
| 850 | -toroot / \ |
| 851 | -devsite \ |
| 852 | -ignoreJdLinks |
| 853 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 854 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Dirk Dougherty | b042ab1 | 2016-06-14 16:26:28 -0700 | [diff] [blame] | 855 | |
| 856 | include $(BUILD_DROIDDOC) |
| 857 | |
Dirk Dougherty | 7d47b55 | 2016-09-13 16:44:25 -0700 | [diff] [blame] | 858 | # ==== generates full navtree for resolving @links in ds postprocessing ==== |
| 859 | include $(CLEAR_VARS) |
| 860 | |
| 861 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 862 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 863 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Dirk Dougherty | 7d47b55 | 2016-09-13 16:44:25 -0700 | [diff] [blame] | 864 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 865 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 866 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 867 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 868 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 869 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 870 | |
| 871 | LOCAL_MODULE := ds-ref-navtree |
| 872 | |
| 873 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 874 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 875 | -hdf android.whichdoc online \ |
| 876 | -toroot / \ |
| 877 | -atLinksNavtree \ |
| 878 | -navtreeonly |
| 879 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 880 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Dirk Dougherty | 7d47b55 | 2016-09-13 16:44:25 -0700 | [diff] [blame] | 881 | |
| 882 | include $(BUILD_DROIDDOC) |
| 883 | |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 884 | # ==== site updates for docs (on the androiddevdocs app engine server) ======================= |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 885 | include $(CLEAR_VARS) |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 886 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 887 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 888 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 889 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 890 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 891 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 892 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 893 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 894 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 895 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 896 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 897 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 898 | |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 899 | LOCAL_MODULE := online-sdk-dev |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 900 | |
| 901 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 902 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 903 | -toroot / \ |
| 904 | -hdf android.whichdoc online \ |
| 905 | $(sample_groups) \ |
| 906 | -hdf android.hasSamples true \ |
| 907 | -samplesdir $(samples_dir) |
| 908 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 909 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 910 | |
| 911 | include $(BUILD_DROIDDOC) |
| 912 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 913 | # ==== docs that have all of the stuff that's @hidden ======================= |
| 914 | include $(CLEAR_VARS) |
| 915 | |
| 916 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 917 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 918 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 919 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 920 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 921 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 922 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 923 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 924 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 925 | |
| 926 | LOCAL_MODULE := hidden |
| 927 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 928 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 929 | -referenceonly \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 930 | -title "Android SDK - Including hidden APIs." |
| 931 | # -hidden |
| 932 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 933 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 934 | |
| 935 | include $(BUILD_DROIDDOC) |
| 936 | |
Joe Onorato | 1754d74 | 2016-11-21 17:51:35 -0800 | [diff] [blame] | 937 | # ==== java proto host library ============================== |
| 938 | include $(CLEAR_VARS) |
| 939 | LOCAL_MODULE := platformprotos |
| 940 | LOCAL_PROTOC_OPTIMIZE_TYPE := full |
| 941 | LOCAL_PROTOC_FLAGS := \ |
| 942 | -Iexternal/protobuf/src |
| 943 | LOCAL_SOURCE_FILES_ALL_GENERATED := true |
| 944 | LOCAL_SRC_FILES := \ |
Mike Ma | da3a295 | 2017-11-13 12:06:45 -0800 | [diff] [blame] | 945 | cmds/am/proto/instrumentation_data.proto \ |
Primiano Tucci | e4d4491 | 2018-01-10 12:14:50 +0000 | [diff] [blame] | 946 | cmds/statsd/src/perfetto/perfetto_config.proto \ |
Joe Onorato | 1754d74 | 2016-11-21 17:51:35 -0800 | [diff] [blame] | 947 | $(call all-proto-files-under, core/proto) \ |
Chenjie Yu | 15176cd | 2017-11-22 12:36:41 -0800 | [diff] [blame] | 948 | $(call all-proto-files-under, libs/incident/proto) \ |
| 949 | $(call all-proto-files-under, cmds/statsd/src) |
Andreas Gampe | 3e429f3 | 2018-02-15 15:12:38 -0800 | [diff] [blame] | 950 | # b/72714520 |
| 951 | LOCAL_ERROR_PRONE_FLAGS := -Xep:MissingOverride:OFF |
Joe Onorato | 1754d74 | 2016-11-21 17:51:35 -0800 | [diff] [blame] | 952 | include $(BUILD_HOST_JAVA_LIBRARY) |
| 953 | |
Steven Timotius | 7ece042 | 2017-08-03 13:37:26 -0700 | [diff] [blame] | 954 | # ==== java proto device library (for test only) ============================== |
| 955 | include $(CLEAR_VARS) |
| 956 | LOCAL_MODULE := platformprotosnano |
Joe Onorato | 62c220b | 2017-11-18 20:32:56 -0800 | [diff] [blame] | 957 | LOCAL_MODULE_TAGS := tests |
Steven Timotius | 7ece042 | 2017-08-03 13:37:26 -0700 | [diff] [blame] | 958 | LOCAL_PROTOC_OPTIMIZE_TYPE := nano |
| 959 | LOCAL_PROTOC_FLAGS := \ |
| 960 | -Iexternal/protobuf/src |
| 961 | LOCAL_PROTO_JAVA_OUTPUT_PARAMS := \ |
| 962 | store_unknown_fields = true |
Jiyong Park | f004839 | 2018-02-12 21:57:59 +0900 | [diff] [blame] | 963 | LOCAL_SDK_VERSION := current |
Steven Timotius | 7ece042 | 2017-08-03 13:37:26 -0700 | [diff] [blame] | 964 | LOCAL_SRC_FILES := \ |
Yi Jin | 437aa6e | 2018-01-10 11:34:26 -0800 | [diff] [blame] | 965 | $(call all-proto-files-under, core/proto) \ |
| 966 | $(call all-proto-files-under, libs/incident/proto/android/os) |
Steven Timotius | 7ece042 | 2017-08-03 13:37:26 -0700 | [diff] [blame] | 967 | include $(BUILD_STATIC_JAVA_LIBRARY) |
| 968 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 969 | |
Joe Onorato | 62c220b | 2017-11-18 20:32:56 -0800 | [diff] [blame] | 970 | # ==== java proto device library (for test only) ============================== |
| 971 | include $(CLEAR_VARS) |
| 972 | LOCAL_MODULE := platformprotoslite |
| 973 | LOCAL_MODULE_TAGS := tests |
| 974 | LOCAL_PROTOC_OPTIMIZE_TYPE := lite |
| 975 | LOCAL_PROTOC_FLAGS := \ |
| 976 | -Iexternal/protobuf/src |
| 977 | LOCAL_SRC_FILES := \ |
Yi Jin | 437aa6e | 2018-01-10 11:34:26 -0800 | [diff] [blame] | 978 | $(call all-proto-files-under, core/proto) \ |
| 979 | $(call all-proto-files-under, libs/incident/proto/android/os) |
Andreas Gampe | 93b64c9 | 2018-01-30 18:50:34 -0800 | [diff] [blame] | 980 | # Protos have lots of MissingOverride and similar. |
| 981 | LOCAL_ERROR_PRONE_FLAGS := -XepDisableAllChecks |
Joe Onorato | 62c220b | 2017-11-18 20:32:56 -0800 | [diff] [blame] | 982 | include $(BUILD_STATIC_JAVA_LIBRARY) |
| 983 | |
David Brazdil | 0649c8d | 2018-01-22 22:23:13 +0000 | [diff] [blame] | 984 | # ==== hiddenapi lists ======================================= |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 985 | include $(CLEAR_VARS) |
David Brazdil | 0649c8d | 2018-01-22 22:23:13 +0000 | [diff] [blame] | 986 | |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 987 | # File names of final API lists |
| 988 | LOCAL_LIGHT_GREYLIST := $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST) |
| 989 | LOCAL_DARK_GREYLIST := $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST) |
| 990 | LOCAL_BLACKLIST := $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST) |
| 991 | |
| 992 | # File names of source files we will use to generate the final API lists. |
| 993 | LOCAL_SRC_GREYLIST := frameworks/base/config/hiddenapi-light-greylist.txt |
| 994 | LOCAL_SRC_VENDOR_LIST := frameworks/base/config/hiddenapi-vendor-list.txt |
David Brazdil | 4b34f79 | 2018-05-08 16:49:02 +0100 | [diff] [blame] | 995 | LOCAL_SRC_FORCE_BLACKLIST := frameworks/base/config/hiddenapi-force-blacklist.txt |
David Brazdil | 94c2ab6 | 2018-05-30 13:59:11 +0100 | [diff] [blame] | 996 | LOCAL_SRC_PUBLIC_API := $(INTERNAL_PLATFORM_DEX_API_FILE) |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 997 | LOCAL_SRC_PRIVATE_API := $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) |
| 998 | LOCAL_SRC_REMOVED_API := $(INTERNAL_PLATFORM_REMOVED_DEX_API_FILE) |
| 999 | |
| 1000 | LOCAL_SRC_ALL := \ |
| 1001 | $(LOCAL_SRC_GREYLIST) \ |
| 1002 | $(LOCAL_SRC_VENDOR_LIST) \ |
David Brazdil | 4b34f79 | 2018-05-08 16:49:02 +0100 | [diff] [blame] | 1003 | $(LOCAL_SRC_FORCE_BLACKLIST) \ |
David Brazdil | 94c2ab6 | 2018-05-30 13:59:11 +0100 | [diff] [blame] | 1004 | $(LOCAL_SRC_PUBLIC_API) \ |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 1005 | $(LOCAL_SRC_PRIVATE_API) \ |
| 1006 | $(LOCAL_SRC_REMOVED_API) |
| 1007 | |
| 1008 | define assert-has-no-overlap |
| 1009 | if [ ! -z "`comm -12 <(sort $(1)) <(sort $(2))`" ]; then \ |
| 1010 | echo "$(1) and $(2) should not overlap" 1>&2; \ |
| 1011 | comm -12 <(sort $(1)) <(sort $(2)) 1>&2; \ |
| 1012 | exit 1; \ |
| 1013 | fi |
| 1014 | endef |
| 1015 | |
| 1016 | define assert-is-subset |
| 1017 | if [ ! -z "`comm -23 <(sort $(1)) <(sort $(2))`" ]; then \ |
| 1018 | echo "$(1) must be a subset of $(2)" 1>&2; \ |
| 1019 | comm -23 <(sort $(1)) <(sort $(2)) 1>&2; \ |
| 1020 | exit 1; \ |
| 1021 | fi |
| 1022 | endef |
| 1023 | |
| 1024 | define assert-has-no-duplicates |
| 1025 | if [ ! -z "`sort $(1) | uniq -D`" ]; then \ |
| 1026 | echo "$(1) has duplicate entries" 1>&2; \ |
| 1027 | sort $(1) | uniq -D 1>&2; \ |
| 1028 | exit 1; \ |
| 1029 | fi |
| 1030 | endef |
| 1031 | |
| 1032 | # The following rules build API lists in the build folder. |
| 1033 | # By not using files from the source tree, ART buildbots can mock these lists |
| 1034 | # or have alternative rules for building them. Other rules in the build system |
| 1035 | # should depend on the files in the build folder. |
David Brazdil | f16ac00 | 2018-01-26 11:13:35 +0000 | [diff] [blame] | 1036 | |
David Brazdil | 0585533 | 2018-04-25 11:15:07 +0100 | [diff] [blame] | 1037 | # Merge light greylist from multiple files: |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 1038 | # (1) manual greylist LOCAL_SRC_GREYLIST |
| 1039 | # (2) list of usages from vendor apps LOCAL_SRC_VENDOR_LIST |
| 1040 | # (3) list of removed APIs in LOCAL_SRC_REMOVED_API |
David Brazdil | 0585533 | 2018-04-25 11:15:07 +0100 | [diff] [blame] | 1041 | # @removed does not imply private in Doclava. We must take the subset also |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 1042 | # in LOCAL_SRC_PRIVATE_API. |
David Brazdil | 0585533 | 2018-04-25 11:15:07 +0100 | [diff] [blame] | 1043 | # (4) list of serialization APIs |
| 1044 | # Automatically adds all methods which match the signatures in |
| 1045 | # REGEX_SERIALIZATION. These are greylisted in order to allow applications |
| 1046 | # to write their own serializers. |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 1047 | $(LOCAL_LIGHT_GREYLIST): REGEX_SERIALIZATION := \ |
David Brazdil | 357170b1 | 2018-03-26 16:02:23 +0100 | [diff] [blame] | 1048 | "readObject\(Ljava/io/ObjectInputStream;\)V" \ |
| 1049 | "readObjectNoData\(\)V" \ |
| 1050 | "readResolve\(\)Ljava/lang/Object;" \ |
| 1051 | "serialVersionUID:J" \ |
| 1052 | "serialPersistentFields:\[Ljava/io/ObjectStreamField;" \ |
| 1053 | "writeObject\(Ljava/io/ObjectOutputStream;\)V" \ |
| 1054 | "writeReplace\(\)Ljava/lang/Object;" |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 1055 | $(LOCAL_LIGHT_GREYLIST): $(LOCAL_SRC_ALL) |
| 1056 | sort $(LOCAL_SRC_GREYLIST) $(LOCAL_SRC_VENDOR_LIST) \ |
| 1057 | <(grep -E "\->("$(subst $(space),"|",$(REGEX_SERIALIZATION))")$$" \ |
| 1058 | $(LOCAL_SRC_PRIVATE_API)) \ |
| 1059 | <(comm -12 <(sort $(LOCAL_SRC_REMOVED_API)) <(sort $(LOCAL_SRC_PRIVATE_API))) \ |
| 1060 | > $@ |
| 1061 | $(call assert-has-no-duplicates,$@) |
| 1062 | $(call assert-is-subset,$@,$(LOCAL_SRC_PRIVATE_API)) |
David Brazdil | 4b34f79 | 2018-05-08 16:49:02 +0100 | [diff] [blame] | 1063 | $(call assert-has-no-overlap,$@,$(LOCAL_SRC_FORCE_BLACKLIST)) |
David Brazdil | f16ac00 | 2018-01-26 11:13:35 +0000 | [diff] [blame] | 1064 | |
David Brazdil | 4c3c031 | 2018-05-10 15:50:02 +0100 | [diff] [blame] | 1065 | # Generate dark greylist as remaining classes and class members in the same |
| 1066 | # package as classes listed in the light greylist. |
David Brazdil | 185f00e | 2018-05-08 15:28:31 +0100 | [diff] [blame] | 1067 | # The algorithm is as follows: |
| 1068 | # (1) extract the class descriptor from each entry in LOCAL_LIGHT_GREYLIST |
David Brazdil | 4c3c031 | 2018-05-10 15:50:02 +0100 | [diff] [blame] | 1069 | # (2) strip everything after the last forward-slash, |
| 1070 | # e.g. 'Lpackage/subpackage/class$inner;' turns into 'Lpackage/subpackage/' |
| 1071 | # (3) insert all entries from LOCAL_SRC_PRIVATE_API which begin with the package |
| 1072 | # name but do not contain another forward-slash in the class name, e.g. |
| 1073 | # matching '^Lpackage/subpackage/[^/;]*;' |
David Brazdil | 185f00e | 2018-05-08 15:28:31 +0100 | [diff] [blame] | 1074 | # (4) subtract entries shared with LOCAL_LIGHT_GREYLIST |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 1075 | $(LOCAL_DARK_GREYLIST): $(LOCAL_SRC_ALL) $(LOCAL_LIGHT_GREYLIST) |
David Brazdil | 4b34f79 | 2018-05-08 16:49:02 +0100 | [diff] [blame] | 1076 | comm -13 <(sort $(LOCAL_LIGHT_GREYLIST) $(LOCAL_SRC_FORCE_BLACKLIST)) \ |
David Brazdil | 94c2ab6 | 2018-05-30 13:59:11 +0100 | [diff] [blame] | 1077 | <(cat $(LOCAL_SRC_PUBLIC_API) $(LOCAL_LIGHT_GREYLIST) | \ |
| 1078 | sed 's/\->.*//' | sed 's/\(.*\/\).*/\1/' | sort | uniq | \ |
David Brazdil | 4c3c031 | 2018-05-10 15:50:02 +0100 | [diff] [blame] | 1079 | while read PKG_NAME; do \ |
| 1080 | grep -E "^$${PKG_NAME}[^/;]*;" $(LOCAL_SRC_PRIVATE_API); \ |
David Brazdil | 185f00e | 2018-05-08 15:28:31 +0100 | [diff] [blame] | 1081 | done | sort | uniq) \ |
| 1082 | > $@ |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 1083 | $(call assert-is-subset,$@,$(LOCAL_SRC_PRIVATE_API)) |
| 1084 | $(call assert-has-no-duplicates,$@) |
| 1085 | $(call assert-has-no-overlap,$@,$(LOCAL_LIGHT_GREYLIST)) |
David Brazdil | 4b34f79 | 2018-05-08 16:49:02 +0100 | [diff] [blame] | 1086 | $(call assert-has-no-overlap,$@,$(LOCAL_SRC_FORCE_BLACKLIST)) |
David Brazdil | 36bbf12 | 2018-03-28 11:28:39 +0100 | [diff] [blame] | 1087 | |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 1088 | # Generate blacklist as private API minus (light greylist plus dark greylist). |
| 1089 | $(LOCAL_BLACKLIST): $(LOCAL_SRC_ALL) $(LOCAL_LIGHT_GREYLIST) $(LOCAL_DARK_GREYLIST) |
| 1090 | comm -13 <(sort $(LOCAL_LIGHT_GREYLIST) $(LOCAL_DARK_GREYLIST)) \ |
| 1091 | <(sort $(LOCAL_SRC_PRIVATE_API)) \ |
| 1092 | > $@ |
| 1093 | $(call assert-is-subset,$@,$(LOCAL_SRC_PRIVATE_API)) |
| 1094 | $(call assert-has-no-duplicates,$@) |
| 1095 | $(call assert-has-no-overlap,$@,$(LOCAL_LIGHT_GREYLIST)) |
| 1096 | $(call assert-has-no-overlap,$@,$(LOCAL_DARK_GREYLIST)) |
David Brazdil | 4b34f79 | 2018-05-08 16:49:02 +0100 | [diff] [blame] | 1097 | $(call assert-is-subset,$(LOCAL_SRC_FORCE_BLACKLIST),$@) |
David Brazdil | 0649c8d | 2018-01-22 22:23:13 +0000 | [diff] [blame] | 1098 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 1099 | # Include subdirectory makefiles |
| 1100 | # ============================================================ |
| 1101 | |
| 1102 | # If we're building with ONE_SHOT_MAKEFILE (mm, mmm), then what the framework |
| 1103 | # team really wants is to build the stuff defined by this makefile. |
| 1104 | ifeq (,$(ONE_SHOT_MAKEFILE)) |
| 1105 | include $(call first-makefiles-under,$(LOCAL_PATH)) |
| 1106 | endif |
| 1107 | |
Holly Jiuyu Sun | bbc8580 | 2017-12-21 18:44:59 -0800 | [diff] [blame] | 1108 | endif # ANDROID_BUILD_EMBEDDED |