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