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 |
Nan Zhang | b3871a6 | 2018-06-06 19:11:33 -0700 | [diff] [blame] | 377 | LOCAL_DROIDDOC_METALAVA_PREVIOUS_API := prebuilts/sdk/api/27.txt |
| 378 | LOCAL_DROIDDOC_METALAVA_ANNOTATIONS_ENABLED := true |
| 379 | LOCAL_DROIDDOC_METALAVA_MERGE_ANNOTATIONS_DIR := tools/metalava/manual |
Nan Zhang | bd9eda5 | 2018-06-05 19:01:32 -0700 | [diff] [blame] | 380 | |
| 381 | LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/metalava_android_stubs_current_intermediates/src |
| 382 | |
| 383 | INTERNAL_PLATFORM_METALAVA_PUBLIC_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava_public_api.txt |
| 384 | INTERNAL_PLATFORM_METALAVA_PUBLIC_REMOVED_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava_removed.txt |
| 385 | |
| 386 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 387 | $(framework_metalava_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 388 | --api $(INTERNAL_PLATFORM_METALAVA_PUBLIC_API_FILE) \ |
| 389 | --removed-api $(INTERNAL_PLATFORM_METALAVA_PUBLIC_REMOVED_API_FILE) \ |
| 390 | -nodocs |
| 391 | |
| 392 | LOCAL_UNINSTALLABLE_MODULE := true |
| 393 | |
| 394 | include $(BUILD_DROIDDOC) |
| 395 | |
| 396 | $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_METALAVA_PUBLIC_API_FILE) \ |
| 397 | $(INTERNAL_PLATFORM_METALAVA_PUBLIC_REMOVED_API_FILE) |
| 398 | $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_METALAVA_PUBLIC_API_FILE)) |
| 399 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 400 | # ==== the system api stubs =================================== |
| 401 | include $(CLEAR_VARS) |
| 402 | |
| 403 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 404 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 405 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 406 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| 407 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 408 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 409 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 410 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| 411 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 412 | |
| 413 | LOCAL_MODULE := system-api-stubs |
| 414 | |
Ying Wang | 0f92a2e | 2015-07-16 14:20:22 -0700 | [diff] [blame] | 415 | LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_system_stubs_current_intermediates/src |
| 416 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 417 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 418 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 419 | -referenceonly \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 420 | -showAnnotation android.annotation.SystemApi \ |
| 421 | -api $(INTERNAL_PLATFORM_SYSTEM_API_FILE) \ |
| 422 | -removedApi $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE) \ |
Jeff Sharkey | 05461c0 | 2017-05-09 19:01:09 -0600 | [diff] [blame] | 423 | -exactApi $(INTERNAL_PLATFORM_SYSTEM_EXACT_API_FILE) \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 424 | -nodocs |
| 425 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 426 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 427 | |
| 428 | LOCAL_UNINSTALLABLE_MODULE := true |
| 429 | |
| 430 | include $(BUILD_DROIDDOC) |
| 431 | |
David Brazdil | a793f3f | 2018-01-16 15:03:20 +0000 | [diff] [blame] | 432 | $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_SYSTEM_API_FILE) \ |
David Brazdil | 68e1c1d | 2018-03-08 14:32:27 +0000 | [diff] [blame] | 433 | $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE) \ |
| 434 | $(INTERNAL_PLATFORM_SYSTEM_EXACT_API_FILE) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 435 | $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_SYSTEM_API_FILE)) |
| 436 | |
Nan Zhang | bd9eda5 | 2018-06-05 19:01:32 -0700 | [diff] [blame] | 437 | # ==== the metalava system api stubs =================================== |
| 438 | include $(CLEAR_VARS) |
| 439 | |
| 440 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
| 441 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
| 442 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| 443 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| 444 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 445 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 446 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| 447 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 448 | |
| 449 | LOCAL_MODULE := metalava-system-api-stubs |
| 450 | LOCAL_DROIDDOC_USE_METALAVA := true |
Nan Zhang | b3871a6 | 2018-06-06 19:11:33 -0700 | [diff] [blame] | 451 | LOCAL_DROIDDOC_METALAVA_PREVIOUS_API := prebuilts/sdk/api/27.txt |
| 452 | LOCAL_DROIDDOC_METALAVA_ANNOTATIONS_ENABLED := true |
| 453 | LOCAL_DROIDDOC_METALAVA_MERGE_ANNOTATIONS_DIR := tools/metalava/manual |
Nan Zhang | bd9eda5 | 2018-06-05 19:01:32 -0700 | [diff] [blame] | 454 | |
| 455 | LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/metalava_android_system_stubs_current_intermediates/src |
| 456 | |
| 457 | INTERNAL_PLATFORM_METALAVA_SYSTEM_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava-system-api.txt |
| 458 | INTERNAL_PLATFORM_METALAVA_SYSTEM_REMOVED_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava-system-removed.txt |
| 459 | |
| 460 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 461 | $(framework_metalava_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 462 | --show-annotation android.annotation.SystemApi \ |
| 463 | --api $(INTERNAL_PLATFORM_METALAVA_SYSTEM_API_FILE) \ |
| 464 | --removed-api $(INTERNAL_PLATFORM_METALAVA_SYSTEM_REMOVED_API_FILE) \ |
| 465 | -nodocs |
| 466 | |
| 467 | LOCAL_UNINSTALLABLE_MODULE := true |
| 468 | |
| 469 | include $(BUILD_DROIDDOC) |
| 470 | |
| 471 | $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_METALAVA_SYSTEM_API_FILE) \ |
| 472 | $(INTERNAL_PLATFORM_METALAVA_SYSTEM_REMOVED_API_FILE) \ |
| 473 | $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_METALAVA_SYSTEM_API_FILE)) |
| 474 | |
Michael Wright | b2b2c0e | 2015-11-06 15:21:13 +0000 | [diff] [blame] | 475 | # ==== the test api stubs =================================== |
| 476 | include $(CLEAR_VARS) |
| 477 | |
| 478 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 479 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 480 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Michael Wright | b2b2c0e | 2015-11-06 15:21:13 +0000 | [diff] [blame] | 481 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| 482 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 483 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 484 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 485 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| 486 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 487 | |
| 488 | LOCAL_MODULE := test-api-stubs |
| 489 | |
| 490 | LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src |
| 491 | |
| 492 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 493 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 494 | -referenceonly \ |
Michael Wright | b2b2c0e | 2015-11-06 15:21:13 +0000 | [diff] [blame] | 495 | -stubs $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src \ |
| 496 | -showAnnotation android.annotation.TestApi \ |
| 497 | -api $(INTERNAL_PLATFORM_TEST_API_FILE) \ |
| 498 | -removedApi $(INTERNAL_PLATFORM_TEST_REMOVED_API_FILE) \ |
Jeff Sharkey | 05461c0 | 2017-05-09 19:01:09 -0600 | [diff] [blame] | 499 | -exactApi $(INTERNAL_PLATFORM_TEST_EXACT_API_FILE) \ |
Michael Wright | b2b2c0e | 2015-11-06 15:21:13 +0000 | [diff] [blame] | 500 | -nodocs |
| 501 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 502 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Michael Wright | b2b2c0e | 2015-11-06 15:21:13 +0000 | [diff] [blame] | 503 | |
| 504 | LOCAL_UNINSTALLABLE_MODULE := true |
| 505 | |
| 506 | include $(BUILD_DROIDDOC) |
| 507 | |
David Brazdil | 68e1c1d | 2018-03-08 14:32:27 +0000 | [diff] [blame] | 508 | $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_TEST_API_FILE) \ |
| 509 | $(INTERNAL_PLATFORM_TEST_REMOVED_API_FILE) \ |
| 510 | $(INTERNAL_PLATFORM_TEST_EXACT_API_FILE) |
Michael Wright | b2b2c0e | 2015-11-06 15:21:13 +0000 | [diff] [blame] | 511 | $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_TEST_API_FILE)) |
| 512 | |
Nan Zhang | bd9eda5 | 2018-06-05 19:01:32 -0700 | [diff] [blame] | 513 | # ==== the metalava test api stubs =================================== |
| 514 | include $(CLEAR_VARS) |
| 515 | |
| 516 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
| 517 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
| 518 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| 519 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| 520 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 521 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 522 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| 523 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 524 | |
| 525 | LOCAL_MODULE := metalava-test-api-stubs |
| 526 | LOCAL_DROIDDOC_USE_METALAVA := true |
Nan Zhang | b3871a6 | 2018-06-06 19:11:33 -0700 | [diff] [blame] | 527 | LOCAL_DROIDDOC_METALAVA_PREVIOUS_API := prebuilts/sdk/api/27.txt |
| 528 | LOCAL_DROIDDOC_METALAVA_ANNOTATIONS_ENABLED := true |
| 529 | LOCAL_DROIDDOC_METALAVA_MERGE_ANNOTATIONS_DIR := tools/metalava/manual |
Nan Zhang | bd9eda5 | 2018-06-05 19:01:32 -0700 | [diff] [blame] | 530 | |
| 531 | LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/metalava_android_test_stubs_current_intermediates/src |
| 532 | |
| 533 | INTERNAL_PLATFORM_METALAVA_TEST_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava-test-api.txt |
| 534 | INTERNAL_PLATFORM_METALAVA_TEST_REMOVED_API_FILE := $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/metalava-test-removed.txt |
| 535 | |
| 536 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 537 | $(framework_metalava_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 538 | --show-annotation android.annotation.TestApi \ |
| 539 | --api $(INTERNAL_PLATFORM_METALAVA_TEST_API_FILE) \ |
| 540 | --removed-api $(INTERNAL_PLATFORM_METALAVA_TEST_REMOVED_API_FILE) \ |
| 541 | -nodocs |
| 542 | |
| 543 | LOCAL_UNINSTALLABLE_MODULE := true |
| 544 | |
| 545 | include $(BUILD_DROIDDOC) |
| 546 | |
| 547 | $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_METALAVA_TEST_API_FILE) \ |
| 548 | $(INTERNAL_PLATFORM_METALAVA_TEST_REMOVED_API_FILE) \ |
| 549 | $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_METALAVA_TEST_API_FILE)) |
| 550 | |
David Brazdil | 68e1c1d | 2018-03-08 14:32:27 +0000 | [diff] [blame] | 551 | # ==== the complete hidden api list =================================== |
| 552 | include $(CLEAR_VARS) |
| 553 | |
| 554 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
| 555 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
| 556 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
| 557 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| 558 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 559 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 560 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 561 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| 562 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 563 | |
| 564 | LOCAL_MODULE := hidden-api-list |
| 565 | |
| 566 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 567 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 568 | -referenceonly \ |
| 569 | -showUnannotated \ |
| 570 | -showAnnotation android.annotation.SystemApi \ |
| 571 | -showAnnotation android.annotation.TestApi \ |
David Brazdil | 94c2ab6 | 2018-05-30 13:59:11 +0100 | [diff] [blame] | 572 | -dexApi $(INTERNAL_PLATFORM_DEX_API_FILE) \ |
David Brazdil | 68e1c1d | 2018-03-08 14:32:27 +0000 | [diff] [blame] | 573 | -privateDexApi $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) \ |
David Brazdil | 0f0abb2 | 2018-04-26 16:10:35 +0100 | [diff] [blame] | 574 | -removedDexApi $(INTERNAL_PLATFORM_REMOVED_DEX_API_FILE) \ |
David Brazdil | 68e1c1d | 2018-03-08 14:32:27 +0000 | [diff] [blame] | 575 | -nodocs |
| 576 | |
| 577 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
| 578 | |
| 579 | LOCAL_UNINSTALLABLE_MODULE := true |
| 580 | |
| 581 | include $(BUILD_DROIDDOC) |
| 582 | |
David Brazdil | 94c2ab6 | 2018-05-30 13:59:11 +0100 | [diff] [blame] | 583 | $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_DEX_API_FILE) \ |
| 584 | $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) \ |
David Brazdil | 0f0abb2 | 2018-04-26 16:10:35 +0100 | [diff] [blame] | 585 | $(INTERNAL_PLATFORM_REMOVED_DEX_API_FILE) |
David Brazdil | 68e1c1d | 2018-03-08 14:32:27 +0000 | [diff] [blame] | 586 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 587 | # ==== check javadoc comments but don't generate docs ======== |
| 588 | include $(CLEAR_VARS) |
| 589 | |
| 590 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 591 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 592 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 593 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 594 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 595 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 596 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 597 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 598 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 599 | |
| 600 | LOCAL_MODULE := doc-comment-check |
| 601 | |
| 602 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 603 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 604 | -referenceonly \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 605 | -parsecomments |
| 606 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 607 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 608 | |
| 609 | LOCAL_UNINSTALLABLE_MODULE := true |
| 610 | |
| 611 | include $(BUILD_DROIDDOC) |
| 612 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 613 | # Run this for checkbuild |
| 614 | checkbuild: doc-comment-check-docs |
| 615 | # Check comment when you are updating the API |
| 616 | update-api: doc-comment-check-docs |
| 617 | |
| 618 | # ==== static html in the sdk ================================== |
| 619 | include $(CLEAR_VARS) |
| 620 | |
| 621 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 622 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 623 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 624 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 625 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 626 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 627 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 628 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 629 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 630 | |
| 631 | LOCAL_MODULE := offline-sdk |
| 632 | |
| 633 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 634 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 635 | -offlinemode \ |
| 636 | -title "Android SDK" \ |
| 637 | -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \ |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 638 | -sdkvalues $(OUT_DOCS) \ |
smain@google.com | 8562ab5 | 2016-06-14 17:11:57 -0700 | [diff] [blame] | 639 | -hdf android.whichdoc offline |
| 640 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 641 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
smain@google.com | 8562ab5 | 2016-06-14 17:11:57 -0700 | [diff] [blame] | 642 | |
| 643 | include $(BUILD_DROIDDOC) |
| 644 | |
| 645 | static_doc_index_redirect := $(out_dir)/index.html |
| 646 | $(static_doc_index_redirect): \ |
| 647 | $(LOCAL_PATH)/docs/docs-preview-index.html | $(ACP) |
| 648 | $(hide) mkdir -p $(dir $@) |
| 649 | $(hide) $(ACP) $< $@ |
| 650 | |
| 651 | $(full_target): $(static_doc_index_redirect) |
smain@google.com | 8562ab5 | 2016-06-14 17:11:57 -0700 | [diff] [blame] | 652 | |
| 653 | |
Jeff Sharkey | d2bf31c | 2017-11-29 13:14:27 -0700 | [diff] [blame] | 654 | # ==== Public API static reference docs ================================== |
smain@google.com | 8562ab5 | 2016-06-14 17:11:57 -0700 | [diff] [blame] | 655 | include $(CLEAR_VARS) |
| 656 | |
| 657 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 658 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 659 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
smain@google.com | 8562ab5 | 2016-06-14 17:11:57 -0700 | [diff] [blame] | 660 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 661 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 662 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 663 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 664 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 665 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 666 | |
| 667 | LOCAL_MODULE := offline-sdk-referenceonly |
| 668 | |
| 669 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 670 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 671 | -offlinemode \ |
| 672 | -title "Android SDK" \ |
| 673 | -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \ |
| 674 | -sdkvalues $(OUT_DOCS) \ |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 675 | -hdf android.whichdoc offline \ |
Scott Main | f8cdfc8 | 2017-03-21 13:43:31 -0700 | [diff] [blame] | 676 | -referenceonly |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 677 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 678 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 679 | |
| 680 | include $(BUILD_DROIDDOC) |
| 681 | |
| 682 | static_doc_index_redirect := $(out_dir)/index.html |
smain@google.com | 151833a | 2016-08-31 08:42:09 -0700 | [diff] [blame] | 683 | $(static_doc_index_redirect): $(LOCAL_PATH)/docs/docs-documentation-redirect.html |
Dan Willemsen | 98ff0b7 | 2016-03-23 00:42:44 -0700 | [diff] [blame] | 684 | $(copy-file-to-target) |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 685 | |
smain@google.com | 2f2365d | 2016-09-21 14:05:50 -0700 | [diff] [blame] | 686 | static_doc_properties := $(out_dir)/source.properties |
| 687 | $(static_doc_properties): \ |
| 688 | $(LOCAL_PATH)/docs/source.properties | $(ACP) |
| 689 | $(hide) mkdir -p $(dir $@) |
| 690 | $(hide) $(ACP) $< $@ |
| 691 | |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 692 | $(full_target): $(static_doc_index_redirect) |
smain@google.com | 2f2365d | 2016-09-21 14:05:50 -0700 | [diff] [blame] | 693 | $(full_target): $(static_doc_properties) |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 694 | |
smain@google.com | 7aca8be | 2016-03-10 14:13:30 -0800 | [diff] [blame] | 695 | |
Jeff Sharkey | d2bf31c | 2017-11-29 13:14:27 -0700 | [diff] [blame] | 696 | # ==== System API static reference docs ================================== |
| 697 | include $(CLEAR_VARS) |
| 698 | |
| 699 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 700 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 701 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Jeff Sharkey | d2bf31c | 2017-11-29 13:14:27 -0700 | [diff] [blame] | 702 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 703 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 704 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 705 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 706 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 707 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 708 | |
| 709 | LOCAL_MODULE := offline-system-sdk-referenceonly |
| 710 | |
| 711 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 712 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 713 | -hide 101 -hide 104 -hide 108 \ |
| 714 | -showAnnotation android.annotation.SystemApi \ |
| 715 | -offlinemode \ |
| 716 | -title "Android System SDK" \ |
| 717 | -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \ |
| 718 | -sdkvalues $(OUT_DOCS) \ |
| 719 | -hdf android.whichdoc offline \ |
| 720 | -referenceonly |
| 721 | |
| 722 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
| 723 | |
| 724 | include $(BUILD_DROIDDOC) |
| 725 | |
| 726 | static_doc_index_redirect := $(out_dir)/index.html |
| 727 | $(static_doc_index_redirect): $(LOCAL_PATH)/docs/docs-documentation-redirect.html |
| 728 | $(copy-file-to-target) |
| 729 | |
| 730 | static_doc_properties := $(out_dir)/source.properties |
| 731 | $(static_doc_properties): \ |
| 732 | $(LOCAL_PATH)/docs/source.properties | $(ACP) |
| 733 | $(hide) mkdir -p $(dir $@) |
| 734 | $(hide) $(ACP) $< $@ |
| 735 | |
| 736 | $(full_target): $(static_doc_index_redirect) |
| 737 | $(full_target): $(static_doc_properties) |
| 738 | $(full_target): $(framework_built) |
| 739 | |
| 740 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 741 | # ==== docs for the web (on the androiddevdocs app engine server) ======================= |
| 742 | include $(CLEAR_VARS) |
| 743 | |
| 744 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 745 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 746 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 747 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 748 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 749 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 750 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 751 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 752 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 753 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 754 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
| 755 | |
| 756 | LOCAL_MODULE := online-sdk |
| 757 | |
| 758 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 759 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 760 | -toroot / \ |
| 761 | -hdf android.whichdoc online \ |
| 762 | $(sample_groups) \ |
| 763 | -hdf android.hasSamples true \ |
| 764 | -samplesdir $(samples_dir) |
| 765 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 766 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 767 | |
| 768 | include $(BUILD_DROIDDOC) |
| 769 | |
| 770 | # ==== docs for the web (on the androiddevdocs app engine server) ======================= |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 771 | include $(CLEAR_VARS) |
| 772 | |
| 773 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 774 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 775 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 776 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 777 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 778 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 779 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 780 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 781 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 782 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 783 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
| 784 | |
| 785 | LOCAL_MODULE := online-system-api-sdk |
| 786 | |
| 787 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 788 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 789 | -referenceonly \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 790 | -showAnnotation android.annotation.SystemApi \ |
| 791 | -title "Android SDK - Including system APIs." \ |
| 792 | -toroot / \ |
Gina Dimino | 98ad888 | 2016-05-31 17:25:48 -0700 | [diff] [blame] | 793 | -hide 101 \ |
| 794 | -hide 104 \ |
| 795 | -hide 108 \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 796 | -hdf android.whichdoc online \ |
| 797 | $(sample_groups) \ |
| 798 | -hdf android.hasSamples true \ |
| 799 | -samplesdir $(samples_dir) |
| 800 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 801 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Jeff Sharkey | 05461c0 | 2017-05-09 19:01:09 -0600 | [diff] [blame] | 802 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 803 | LOCAL_UNINSTALLABLE_MODULE := true |
| 804 | |
| 805 | include $(BUILD_DROIDDOC) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 806 | |
| 807 | # ==== docs for the web (on the devsite app engine server) ======================= |
| 808 | include $(CLEAR_VARS) |
| 809 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 810 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 811 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 812 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 813 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 814 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 815 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 816 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 817 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 818 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 819 | # 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] | 820 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 821 | |
| 822 | LOCAL_MODULE := ds |
| 823 | |
| 824 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 825 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 826 | -toroot / \ |
| 827 | -hdf android.whichdoc online \ |
Dirk Dougherty | b042ab1 | 2016-06-14 16:26:28 -0700 | [diff] [blame] | 828 | -devsite \ |
Scott Main | 4f9b48c | 2017-12-19 13:43:45 -0800 | [diff] [blame] | 829 | -yamlV2 \ |
Dirk Dougherty | 3852c1f | 2016-04-10 02:05:09 -0700 | [diff] [blame] | 830 | $(sample_groups) \ |
Dirk Dougherty | 3852c1f | 2016-04-10 02:05:09 -0700 | [diff] [blame] | 831 | -hdf android.hasSamples true \ |
| 832 | -samplesdir $(samples_dir) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 833 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 834 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 835 | |
| 836 | include $(BUILD_DROIDDOC) |
| 837 | |
Dirk Dougherty | b042ab1 | 2016-06-14 16:26:28 -0700 | [diff] [blame] | 838 | # ==== docs for the web (on the devsite app engine server) ======================= |
| 839 | include $(CLEAR_VARS) |
| 840 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 841 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 842 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Dirk Dougherty | b042ab1 | 2016-06-14 16:26:28 -0700 | [diff] [blame] | 843 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 844 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 845 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 846 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 847 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 848 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 849 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 850 | # specify a second html input dir and an output path relative to OUT_DIR) |
| 851 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
| 852 | |
| 853 | LOCAL_MODULE := ds-static |
| 854 | |
| 855 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 856 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 857 | -hdf android.whichdoc online \ |
| 858 | -staticonly \ |
| 859 | -toroot / \ |
| 860 | -devsite \ |
| 861 | -ignoreJdLinks |
| 862 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 863 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Dirk Dougherty | b042ab1 | 2016-06-14 16:26:28 -0700 | [diff] [blame] | 864 | |
| 865 | include $(BUILD_DROIDDOC) |
| 866 | |
Dirk Dougherty | 7d47b55 | 2016-09-13 16:44:25 -0700 | [diff] [blame] | 867 | # ==== generates full navtree for resolving @links in ds postprocessing ==== |
| 868 | include $(CLEAR_VARS) |
| 869 | |
| 870 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 871 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 872 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Dirk Dougherty | 7d47b55 | 2016-09-13 16:44:25 -0700 | [diff] [blame] | 873 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 874 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 875 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 876 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 877 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 878 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 879 | |
| 880 | LOCAL_MODULE := ds-ref-navtree |
| 881 | |
| 882 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 883 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 884 | -hdf android.whichdoc online \ |
| 885 | -toroot / \ |
| 886 | -atLinksNavtree \ |
| 887 | -navtreeonly |
| 888 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 889 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Dirk Dougherty | 7d47b55 | 2016-09-13 16:44:25 -0700 | [diff] [blame] | 890 | |
| 891 | include $(BUILD_DROIDDOC) |
| 892 | |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 893 | # ==== site updates for docs (on the androiddevdocs app engine server) ======================= |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 894 | include $(CLEAR_VARS) |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 895 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 896 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 897 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 898 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 899 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 900 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 901 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 902 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 903 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 904 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 905 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 906 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 907 | |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 908 | LOCAL_MODULE := online-sdk-dev |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 909 | |
| 910 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 911 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 912 | -toroot / \ |
| 913 | -hdf android.whichdoc online \ |
| 914 | $(sample_groups) \ |
| 915 | -hdf android.hasSamples true \ |
| 916 | -samplesdir $(samples_dir) |
| 917 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 918 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 919 | |
| 920 | include $(BUILD_DROIDDOC) |
| 921 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 922 | # ==== docs that have all of the stuff that's @hidden ======================= |
| 923 | include $(CLEAR_VARS) |
| 924 | |
| 925 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 926 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 927 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 928 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 929 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 930 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 931 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 932 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 933 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 934 | |
| 935 | LOCAL_MODULE := hidden |
| 936 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 937 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 938 | -referenceonly \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 939 | -title "Android SDK - Including hidden APIs." |
| 940 | # -hidden |
| 941 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 942 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 943 | |
| 944 | include $(BUILD_DROIDDOC) |
| 945 | |
Joe Onorato | 1754d74 | 2016-11-21 17:51:35 -0800 | [diff] [blame] | 946 | # ==== java proto host library ============================== |
| 947 | include $(CLEAR_VARS) |
| 948 | LOCAL_MODULE := platformprotos |
| 949 | LOCAL_PROTOC_OPTIMIZE_TYPE := full |
| 950 | LOCAL_PROTOC_FLAGS := \ |
| 951 | -Iexternal/protobuf/src |
| 952 | LOCAL_SOURCE_FILES_ALL_GENERATED := true |
| 953 | LOCAL_SRC_FILES := \ |
Mike Ma | da3a295 | 2017-11-13 12:06:45 -0800 | [diff] [blame] | 954 | cmds/am/proto/instrumentation_data.proto \ |
Primiano Tucci | e4d4491 | 2018-01-10 12:14:50 +0000 | [diff] [blame] | 955 | cmds/statsd/src/perfetto/perfetto_config.proto \ |
Joe Onorato | 1754d74 | 2016-11-21 17:51:35 -0800 | [diff] [blame] | 956 | $(call all-proto-files-under, core/proto) \ |
Chenjie Yu | 15176cd | 2017-11-22 12:36:41 -0800 | [diff] [blame] | 957 | $(call all-proto-files-under, libs/incident/proto) \ |
| 958 | $(call all-proto-files-under, cmds/statsd/src) |
Andreas Gampe | 3e429f3 | 2018-02-15 15:12:38 -0800 | [diff] [blame] | 959 | # b/72714520 |
| 960 | LOCAL_ERROR_PRONE_FLAGS := -Xep:MissingOverride:OFF |
Joe Onorato | 1754d74 | 2016-11-21 17:51:35 -0800 | [diff] [blame] | 961 | include $(BUILD_HOST_JAVA_LIBRARY) |
| 962 | |
Steven Timotius | 7ece042 | 2017-08-03 13:37:26 -0700 | [diff] [blame] | 963 | # ==== java proto device library (for test only) ============================== |
| 964 | include $(CLEAR_VARS) |
| 965 | LOCAL_MODULE := platformprotosnano |
Joe Onorato | 62c220b | 2017-11-18 20:32:56 -0800 | [diff] [blame] | 966 | LOCAL_MODULE_TAGS := tests |
Steven Timotius | 7ece042 | 2017-08-03 13:37:26 -0700 | [diff] [blame] | 967 | LOCAL_PROTOC_OPTIMIZE_TYPE := nano |
| 968 | LOCAL_PROTOC_FLAGS := \ |
| 969 | -Iexternal/protobuf/src |
| 970 | LOCAL_PROTO_JAVA_OUTPUT_PARAMS := \ |
| 971 | store_unknown_fields = true |
Jiyong Park | f004839 | 2018-02-12 21:57:59 +0900 | [diff] [blame] | 972 | LOCAL_SDK_VERSION := current |
Steven Timotius | 7ece042 | 2017-08-03 13:37:26 -0700 | [diff] [blame] | 973 | LOCAL_SRC_FILES := \ |
Yi Jin | 437aa6e | 2018-01-10 11:34:26 -0800 | [diff] [blame] | 974 | $(call all-proto-files-under, core/proto) \ |
| 975 | $(call all-proto-files-under, libs/incident/proto/android/os) |
Steven Timotius | 7ece042 | 2017-08-03 13:37:26 -0700 | [diff] [blame] | 976 | include $(BUILD_STATIC_JAVA_LIBRARY) |
| 977 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 978 | |
Joe Onorato | 62c220b | 2017-11-18 20:32:56 -0800 | [diff] [blame] | 979 | # ==== java proto device library (for test only) ============================== |
| 980 | include $(CLEAR_VARS) |
| 981 | LOCAL_MODULE := platformprotoslite |
| 982 | LOCAL_MODULE_TAGS := tests |
| 983 | LOCAL_PROTOC_OPTIMIZE_TYPE := lite |
| 984 | LOCAL_PROTOC_FLAGS := \ |
| 985 | -Iexternal/protobuf/src |
| 986 | LOCAL_SRC_FILES := \ |
Yi Jin | 437aa6e | 2018-01-10 11:34:26 -0800 | [diff] [blame] | 987 | $(call all-proto-files-under, core/proto) \ |
| 988 | $(call all-proto-files-under, libs/incident/proto/android/os) |
Andreas Gampe | 93b64c9 | 2018-01-30 18:50:34 -0800 | [diff] [blame] | 989 | # Protos have lots of MissingOverride and similar. |
| 990 | LOCAL_ERROR_PRONE_FLAGS := -XepDisableAllChecks |
Joe Onorato | 62c220b | 2017-11-18 20:32:56 -0800 | [diff] [blame] | 991 | include $(BUILD_STATIC_JAVA_LIBRARY) |
| 992 | |
David Brazdil | 0649c8d | 2018-01-22 22:23:13 +0000 | [diff] [blame] | 993 | # ==== hiddenapi lists ======================================= |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 994 | include $(CLEAR_VARS) |
David Brazdil | 0649c8d | 2018-01-22 22:23:13 +0000 | [diff] [blame] | 995 | |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 996 | # File names of final API lists |
| 997 | LOCAL_LIGHT_GREYLIST := $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST) |
| 998 | LOCAL_DARK_GREYLIST := $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST) |
| 999 | LOCAL_BLACKLIST := $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST) |
| 1000 | |
| 1001 | # File names of source files we will use to generate the final API lists. |
| 1002 | LOCAL_SRC_GREYLIST := frameworks/base/config/hiddenapi-light-greylist.txt |
| 1003 | LOCAL_SRC_VENDOR_LIST := frameworks/base/config/hiddenapi-vendor-list.txt |
David Brazdil | 4b34f79 | 2018-05-08 16:49:02 +0100 | [diff] [blame] | 1004 | LOCAL_SRC_FORCE_BLACKLIST := frameworks/base/config/hiddenapi-force-blacklist.txt |
David Brazdil | 5999830 | 2018-06-15 14:05:42 +0100 | [diff] [blame^] | 1005 | LOCAL_SRC_PUBLIC_API := frameworks/base/config/hiddenapi-public-dex.txt |
| 1006 | LOCAL_SRC_PRIVATE_API := frameworks/base/config/hiddenapi-private-dex.txt |
| 1007 | LOCAL_SRC_REMOVED_API := frameworks/base/config/hiddenapi-removed-dex.txt |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 1008 | |
| 1009 | LOCAL_SRC_ALL := \ |
| 1010 | $(LOCAL_SRC_GREYLIST) \ |
| 1011 | $(LOCAL_SRC_VENDOR_LIST) \ |
David Brazdil | 4b34f79 | 2018-05-08 16:49:02 +0100 | [diff] [blame] | 1012 | $(LOCAL_SRC_FORCE_BLACKLIST) \ |
David Brazdil | 94c2ab6 | 2018-05-30 13:59:11 +0100 | [diff] [blame] | 1013 | $(LOCAL_SRC_PUBLIC_API) \ |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 1014 | $(LOCAL_SRC_PRIVATE_API) \ |
| 1015 | $(LOCAL_SRC_REMOVED_API) |
| 1016 | |
| 1017 | define assert-has-no-overlap |
| 1018 | if [ ! -z "`comm -12 <(sort $(1)) <(sort $(2))`" ]; then \ |
| 1019 | echo "$(1) and $(2) should not overlap" 1>&2; \ |
| 1020 | comm -12 <(sort $(1)) <(sort $(2)) 1>&2; \ |
| 1021 | exit 1; \ |
| 1022 | fi |
| 1023 | endef |
| 1024 | |
| 1025 | define assert-is-subset |
| 1026 | if [ ! -z "`comm -23 <(sort $(1)) <(sort $(2))`" ]; then \ |
| 1027 | echo "$(1) must be a subset of $(2)" 1>&2; \ |
| 1028 | comm -23 <(sort $(1)) <(sort $(2)) 1>&2; \ |
| 1029 | exit 1; \ |
| 1030 | fi |
| 1031 | endef |
| 1032 | |
| 1033 | define assert-has-no-duplicates |
| 1034 | if [ ! -z "`sort $(1) | uniq -D`" ]; then \ |
| 1035 | echo "$(1) has duplicate entries" 1>&2; \ |
| 1036 | sort $(1) | uniq -D 1>&2; \ |
| 1037 | exit 1; \ |
| 1038 | fi |
| 1039 | endef |
| 1040 | |
| 1041 | # The following rules build API lists in the build folder. |
| 1042 | # By not using files from the source tree, ART buildbots can mock these lists |
| 1043 | # or have alternative rules for building them. Other rules in the build system |
| 1044 | # should depend on the files in the build folder. |
David Brazdil | f16ac00 | 2018-01-26 11:13:35 +0000 | [diff] [blame] | 1045 | |
David Brazdil | 0585533 | 2018-04-25 11:15:07 +0100 | [diff] [blame] | 1046 | # Merge light greylist from multiple files: |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 1047 | # (1) manual greylist LOCAL_SRC_GREYLIST |
| 1048 | # (2) list of usages from vendor apps LOCAL_SRC_VENDOR_LIST |
| 1049 | # (3) list of removed APIs in LOCAL_SRC_REMOVED_API |
David Brazdil | 0585533 | 2018-04-25 11:15:07 +0100 | [diff] [blame] | 1050 | # @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] | 1051 | # in LOCAL_SRC_PRIVATE_API. |
David Brazdil | 0585533 | 2018-04-25 11:15:07 +0100 | [diff] [blame] | 1052 | # (4) list of serialization APIs |
| 1053 | # Automatically adds all methods which match the signatures in |
| 1054 | # REGEX_SERIALIZATION. These are greylisted in order to allow applications |
| 1055 | # to write their own serializers. |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 1056 | $(LOCAL_LIGHT_GREYLIST): REGEX_SERIALIZATION := \ |
David Brazdil | 357170b1 | 2018-03-26 16:02:23 +0100 | [diff] [blame] | 1057 | "readObject\(Ljava/io/ObjectInputStream;\)V" \ |
| 1058 | "readObjectNoData\(\)V" \ |
| 1059 | "readResolve\(\)Ljava/lang/Object;" \ |
| 1060 | "serialVersionUID:J" \ |
| 1061 | "serialPersistentFields:\[Ljava/io/ObjectStreamField;" \ |
| 1062 | "writeObject\(Ljava/io/ObjectOutputStream;\)V" \ |
| 1063 | "writeReplace\(\)Ljava/lang/Object;" |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 1064 | $(LOCAL_LIGHT_GREYLIST): $(LOCAL_SRC_ALL) |
| 1065 | sort $(LOCAL_SRC_GREYLIST) $(LOCAL_SRC_VENDOR_LIST) \ |
| 1066 | <(grep -E "\->("$(subst $(space),"|",$(REGEX_SERIALIZATION))")$$" \ |
| 1067 | $(LOCAL_SRC_PRIVATE_API)) \ |
| 1068 | <(comm -12 <(sort $(LOCAL_SRC_REMOVED_API)) <(sort $(LOCAL_SRC_PRIVATE_API))) \ |
| 1069 | > $@ |
| 1070 | $(call assert-has-no-duplicates,$@) |
| 1071 | $(call assert-is-subset,$@,$(LOCAL_SRC_PRIVATE_API)) |
David Brazdil | 4b34f79 | 2018-05-08 16:49:02 +0100 | [diff] [blame] | 1072 | $(call assert-has-no-overlap,$@,$(LOCAL_SRC_FORCE_BLACKLIST)) |
David Brazdil | f16ac00 | 2018-01-26 11:13:35 +0000 | [diff] [blame] | 1073 | |
David Brazdil | 4c3c031 | 2018-05-10 15:50:02 +0100 | [diff] [blame] | 1074 | # Generate dark greylist as remaining classes and class members in the same |
| 1075 | # package as classes listed in the light greylist. |
David Brazdil | 185f00e | 2018-05-08 15:28:31 +0100 | [diff] [blame] | 1076 | # The algorithm is as follows: |
| 1077 | # (1) extract the class descriptor from each entry in LOCAL_LIGHT_GREYLIST |
David Brazdil | 4c3c031 | 2018-05-10 15:50:02 +0100 | [diff] [blame] | 1078 | # (2) strip everything after the last forward-slash, |
| 1079 | # e.g. 'Lpackage/subpackage/class$inner;' turns into 'Lpackage/subpackage/' |
| 1080 | # (3) insert all entries from LOCAL_SRC_PRIVATE_API which begin with the package |
| 1081 | # name but do not contain another forward-slash in the class name, e.g. |
| 1082 | # matching '^Lpackage/subpackage/[^/;]*;' |
David Brazdil | 185f00e | 2018-05-08 15:28:31 +0100 | [diff] [blame] | 1083 | # (4) subtract entries shared with LOCAL_LIGHT_GREYLIST |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 1084 | $(LOCAL_DARK_GREYLIST): $(LOCAL_SRC_ALL) $(LOCAL_LIGHT_GREYLIST) |
David Brazdil | 4b34f79 | 2018-05-08 16:49:02 +0100 | [diff] [blame] | 1085 | comm -13 <(sort $(LOCAL_LIGHT_GREYLIST) $(LOCAL_SRC_FORCE_BLACKLIST)) \ |
David Brazdil | 94c2ab6 | 2018-05-30 13:59:11 +0100 | [diff] [blame] | 1086 | <(cat $(LOCAL_SRC_PUBLIC_API) $(LOCAL_LIGHT_GREYLIST) | \ |
| 1087 | sed 's/\->.*//' | sed 's/\(.*\/\).*/\1/' | sort | uniq | \ |
David Brazdil | 4c3c031 | 2018-05-10 15:50:02 +0100 | [diff] [blame] | 1088 | while read PKG_NAME; do \ |
| 1089 | grep -E "^$${PKG_NAME}[^/;]*;" $(LOCAL_SRC_PRIVATE_API); \ |
David Brazdil | 185f00e | 2018-05-08 15:28:31 +0100 | [diff] [blame] | 1090 | done | sort | uniq) \ |
| 1091 | > $@ |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 1092 | $(call assert-is-subset,$@,$(LOCAL_SRC_PRIVATE_API)) |
| 1093 | $(call assert-has-no-duplicates,$@) |
| 1094 | $(call assert-has-no-overlap,$@,$(LOCAL_LIGHT_GREYLIST)) |
David Brazdil | 4b34f79 | 2018-05-08 16:49:02 +0100 | [diff] [blame] | 1095 | $(call assert-has-no-overlap,$@,$(LOCAL_SRC_FORCE_BLACKLIST)) |
David Brazdil | 36bbf12 | 2018-03-28 11:28:39 +0100 | [diff] [blame] | 1096 | |
David Brazdil | 721bc8e | 2018-05-08 15:04:20 +0100 | [diff] [blame] | 1097 | # Generate blacklist as private API minus (light greylist plus dark greylist). |
| 1098 | $(LOCAL_BLACKLIST): $(LOCAL_SRC_ALL) $(LOCAL_LIGHT_GREYLIST) $(LOCAL_DARK_GREYLIST) |
| 1099 | comm -13 <(sort $(LOCAL_LIGHT_GREYLIST) $(LOCAL_DARK_GREYLIST)) \ |
| 1100 | <(sort $(LOCAL_SRC_PRIVATE_API)) \ |
| 1101 | > $@ |
| 1102 | $(call assert-is-subset,$@,$(LOCAL_SRC_PRIVATE_API)) |
| 1103 | $(call assert-has-no-duplicates,$@) |
| 1104 | $(call assert-has-no-overlap,$@,$(LOCAL_LIGHT_GREYLIST)) |
| 1105 | $(call assert-has-no-overlap,$@,$(LOCAL_DARK_GREYLIST)) |
David Brazdil | 4b34f79 | 2018-05-08 16:49:02 +0100 | [diff] [blame] | 1106 | $(call assert-is-subset,$(LOCAL_SRC_FORCE_BLACKLIST),$@) |
David Brazdil | 0649c8d | 2018-01-22 22:23:13 +0000 | [diff] [blame] | 1107 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 1108 | # Include subdirectory makefiles |
| 1109 | # ============================================================ |
| 1110 | |
| 1111 | # If we're building with ONE_SHOT_MAKEFILE (mm, mmm), then what the framework |
| 1112 | # team really wants is to build the stuff defined by this makefile. |
| 1113 | ifeq (,$(ONE_SHOT_MAKEFILE)) |
| 1114 | include $(call first-makefiles-under,$(LOCAL_PATH)) |
| 1115 | endif |
| 1116 | |
Holly Jiuyu Sun | bbc8580 | 2017-12-21 18:44:59 -0800 | [diff] [blame] | 1117 | endif # ANDROID_BUILD_EMBEDDED |