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) |
| 39 | $$(gen): $(call java-lib-header-files,$1) | $(HOST_OUT_EXECUTABLES)/sdkparcelables |
| 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 \ |
Rayhaan Jaufeerally | 2e47a6e | 2015-08-03 13:54:28 +0100 | [diff] [blame] | 146 | icu4j \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 147 | framework \ |
Paul Duffin | c08090f | 2017-06-29 14:58:43 +0100 | [diff] [blame] | 148 | voip-common \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 149 | |
Alan Viverette | 9ca513e | 2017-04-05 10:21:58 -0400 | [diff] [blame] | 150 | # Platform docs can refer to Support Library APIs, but we don't actually build |
| 151 | # 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] | 152 | framework_docs_LOCAL_JAVA_LIBRARIES := \ |
| 153 | $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) \ |
| 154 | $(FRAMEWORKS_SUPPORT_JAVA_LIBRARIES) |
| 155 | |
| 156 | framework_docs_LOCAL_MODULE_CLASS := JAVA_LIBRARIES |
| 157 | framework_docs_LOCAL_DROIDDOC_HTML_DIR := docs/html |
| 158 | # The since flag (-since N.xml API_LEVEL) is used to add API Level information |
| 159 | # to the reference documentation. Must be in order of oldest to newest. |
| 160 | # |
| 161 | # Conscrypt (com.android.org.conscrypt) is an implementation detail and should |
| 162 | # not be referenced in the documentation. |
| 163 | framework_docs_LOCAL_DROIDDOC_OPTIONS := \ |
Jeff Sharkey | 0f3f60b | 2017-04-24 18:06:20 -0600 | [diff] [blame] | 164 | -android \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 165 | -knowntags ./frameworks/base/docs/knowntags.txt \ |
Narayan Kamath | 2c4f284 | 2015-07-27 14:02:11 +0100 | [diff] [blame] | 166 | -knowntags ./libcore/known_oj_tags.txt \ |
Jeff Sharkey | bfc4fcd | 2017-06-05 17:38:17 -0600 | [diff] [blame] | 167 | -manifest ./frameworks/base/core/res/AndroidManifest.xml \ |
Neil Fuller | 57157fb | 2017-11-24 15:58:38 +0000 | [diff] [blame] | 168 | -hidePackage com.android.okhttp \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 169 | -hidePackage com.android.org.conscrypt \ |
Neil Fuller | 371c08c | 2017-11-27 10:32:07 +0000 | [diff] [blame] | 170 | -hidePackage com.android.server \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 171 | -since $(SRC_API_DIR)/1.xml 1 \ |
| 172 | -since $(SRC_API_DIR)/2.xml 2 \ |
| 173 | -since $(SRC_API_DIR)/3.xml 3 \ |
| 174 | -since $(SRC_API_DIR)/4.xml 4 \ |
| 175 | -since $(SRC_API_DIR)/5.xml 5 \ |
| 176 | -since $(SRC_API_DIR)/6.xml 6 \ |
| 177 | -since $(SRC_API_DIR)/7.xml 7 \ |
| 178 | -since $(SRC_API_DIR)/8.xml 8 \ |
| 179 | -since $(SRC_API_DIR)/9.xml 9 \ |
| 180 | -since $(SRC_API_DIR)/10.xml 10 \ |
| 181 | -since $(SRC_API_DIR)/11.xml 11 \ |
| 182 | -since $(SRC_API_DIR)/12.xml 12 \ |
| 183 | -since $(SRC_API_DIR)/13.xml 13 \ |
| 184 | -since $(SRC_API_DIR)/14.txt 14 \ |
| 185 | -since $(SRC_API_DIR)/15.txt 15 \ |
| 186 | -since $(SRC_API_DIR)/16.txt 16 \ |
| 187 | -since $(SRC_API_DIR)/17.txt 17 \ |
| 188 | -since $(SRC_API_DIR)/18.txt 18 \ |
| 189 | -since $(SRC_API_DIR)/19.txt 19 \ |
| 190 | -since $(SRC_API_DIR)/20.txt 20 \ |
| 191 | -since $(SRC_API_DIR)/21.txt 21 \ |
| 192 | -since $(SRC_API_DIR)/22.txt 22 \ |
Joe Fernandez | 1827e32 | 2015-08-12 19:45:22 -0700 | [diff] [blame] | 193 | -since $(SRC_API_DIR)/23.txt 23 \ |
Dirk Dougherty | 5f60f7c | 2016-06-14 16:26:28 -0700 | [diff] [blame] | 194 | -since $(SRC_API_DIR)/24.txt 24 \ |
Dirk Dougherty | 3376f58 | 2016-10-14 10:27:08 -0700 | [diff] [blame] | 195 | -since $(SRC_API_DIR)/25.txt 25 \ |
Dirk Dougherty | fdad0ba | 2017-06-09 14:43:32 -0700 | [diff] [blame] | 196 | -since $(SRC_API_DIR)/26.txt 26 \ |
Andrew Solovay | a6019b2 | 2017-10-06 14:27:20 -0700 | [diff] [blame] | 197 | -since $(SRC_API_DIR)/27.txt 27 \ |
Jeff Sharkey | c204c22 | 2017-11-27 15:02:10 -0700 | [diff] [blame] | 198 | -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] | 199 | -overview $(LOCAL_PATH)/core/java/overview.html \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 200 | |
| 201 | framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR:= \ |
| 202 | $(call intermediates-dir-for,JAVA_LIBRARIES,framework,,COMMON) |
| 203 | |
| 204 | framework_docs_LOCAL_ADDITIONAL_JAVA_DIR:= \ |
Alan Viverette | 9ca513e | 2017-04-05 10:21:58 -0400 | [diff] [blame] | 205 | $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 206 | |
| 207 | framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES := \ |
Narayan Kamath | c21739a | 2015-07-14 13:39:23 +0100 | [diff] [blame] | 208 | frameworks/base/docs/knowntags.txt \ |
Colin Cross | 72d359f | 2017-10-27 10:46:53 -0700 | [diff] [blame] | 209 | $(libcore_to_document_generated) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 210 | |
| 211 | samples_dir := development/samples/browseable |
| 212 | |
| 213 | # Whitelist of valid groups, used for default TOC grouping. Each sample must |
| 214 | # belong to one (and only one) group. Assign samples to groups by setting |
| 215 | # a sample.group var to one of these groups in the sample's _index.jd. |
| 216 | sample_groups := -samplegroup Admin \ |
| 217 | -samplegroup Background \ |
| 218 | -samplegroup Connectivity \ |
| 219 | -samplegroup Content \ |
| 220 | -samplegroup Input \ |
| 221 | -samplegroup Media \ |
| 222 | -samplegroup Notification \ |
| 223 | -samplegroup RenderScript \ |
| 224 | -samplegroup Security \ |
| 225 | -samplegroup Sensors \ |
Trevor Johns | 4cbe359 | 2015-05-27 14:50:51 -0700 | [diff] [blame] | 226 | -samplegroup System \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 227 | -samplegroup Testing \ |
| 228 | -samplegroup UI \ |
| 229 | -samplegroup Views \ |
| 230 | -samplegroup Wearable |
| 231 | |
| 232 | ## SDK version identifiers used in the published docs |
| 233 | # major[.minor] version for current SDK. (full releases only) |
smain@google.com | dde8deb | 2016-08-29 18:36:50 -0700 | [diff] [blame] | 234 | framework_docs_SDK_VERSION:=7.0 |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 235 | # release version (ie "Release x") (full releases only) |
| 236 | framework_docs_SDK_REL_ID:=1 |
| 237 | |
| 238 | framework_docs_LOCAL_DROIDDOC_OPTIONS += \ |
Billy Lamberta | 75dbc8f | 2017-03-03 13:09:15 -0800 | [diff] [blame] | 239 | -hdf dac true \ |
Scott Main | f8cdfc8 | 2017-03-21 13:43:31 -0700 | [diff] [blame] | 240 | -hdf sdk.codename O \ |
| 241 | -hdf sdk.preview.version 1 \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 242 | -hdf sdk.version $(framework_docs_SDK_VERSION) \ |
| 243 | -hdf sdk.rel.id $(framework_docs_SDK_REL_ID) \ |
Scott Main | f8cdfc8 | 2017-03-21 13:43:31 -0700 | [diff] [blame] | 244 | -hdf sdk.preview 0 \ |
| 245 | -resourcesdir $(LOCAL_PATH)/docs/html/reference/images/ \ |
| 246 | -resourcesoutdir reference/android/images/ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 247 | |
Alan Viverette | 9ca513e | 2017-04-05 10:21:58 -0400 | [diff] [blame] | 248 | # Federate Support Library references against local API file. |
| 249 | framework_docs_LOCAL_DROIDDOC_OPTIONS += \ |
| 250 | -federate SupportLib https://developer.android.com \ |
| 251 | -federationapi SupportLib prebuilts/sdk/current/support-api.txt |
| 252 | |
Jeff Sharkey | d2bf31c | 2017-11-29 13:14:27 -0700 | [diff] [blame] | 253 | # ==== Public API diff =========================== |
Alan Viverette | 6b7354c | 2017-07-13 17:10:14 -0400 | [diff] [blame] | 254 | include $(CLEAR_VARS) |
| 255 | |
| 256 | LOCAL_SRC_FILES := $(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 257 | LOCAL_GENERATED_SOURCES := $(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 258 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Alan Viverette | 6b7354c | 2017-07-13 17:10:14 -0400 | [diff] [blame] | 259 | LOCAL_JAVA_LIBRARIES := $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| 260 | LOCAL_MODULE_CLASS := $(framework_docs_LOCAL_MODULE_CLASS) |
| 261 | LOCAL_ADDITIONAL_JAVA_DIR := $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| 262 | LOCAL_ADDITIONAL_DEPENDENCIES := \ |
| 263 | $(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) \ |
| 264 | $(INTERNAL_PLATFORM_API_FILE) |
| 265 | |
| 266 | LOCAL_MODULE := offline-sdk-referenceonly |
| 267 | |
| 268 | last_released_sdk_version := $(lastword $(call numerically_sort, \ |
| 269 | $(filter-out current, \ |
| 270 | $(patsubst $(SRC_API_DIR)/%.txt,%, $(wildcard $(SRC_API_DIR)/*.txt)) \ |
| 271 | )\ |
| 272 | )) |
| 273 | |
| 274 | LOCAL_APIDIFF_OLDAPI := $(LOCAL_PATH)/../../$(SRC_API_DIR)/$(last_released_sdk_version) |
| 275 | LOCAL_APIDIFF_NEWAPI := $(LOCAL_PATH)/../../$(basename $(INTERNAL_PLATFORM_API_FILE)) |
| 276 | |
| 277 | include $(BUILD_APIDIFF) |
| 278 | |
Jeff Sharkey | c8dc254 | 2017-12-08 14:52:37 -0700 | [diff] [blame] | 279 | # Hack to get diffs included in docs output |
| 280 | out_zip := $(OUT_DOCS)/$(LOCAL_MODULE)-docs.zip |
| 281 | $(out_zip): $(full_target) |
| 282 | |
Jeff Sharkey | d2bf31c | 2017-11-29 13:14:27 -0700 | [diff] [blame] | 283 | # ==== System API diff =========================== |
| 284 | include $(CLEAR_VARS) |
| 285 | |
| 286 | LOCAL_SRC_FILES := $(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 287 | LOCAL_GENERATED_SOURCES := $(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 288 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Jeff Sharkey | d2bf31c | 2017-11-29 13:14:27 -0700 | [diff] [blame] | 289 | LOCAL_JAVA_LIBRARIES := $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| 290 | LOCAL_MODULE_CLASS := $(framework_docs_LOCAL_MODULE_CLASS) |
| 291 | LOCAL_ADDITIONAL_JAVA_DIR := $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| 292 | LOCAL_ADDITIONAL_DEPENDENCIES := \ |
| 293 | $(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) \ |
| 294 | $(INTERNAL_PLATFORM_SYSTEM_API_FILE) |
| 295 | |
| 296 | LOCAL_MODULE := offline-system-sdk-referenceonly |
| 297 | |
| 298 | last_released_sdk_version := $(lastword $(call numerically_sort, \ |
| 299 | $(filter-out current, \ |
| 300 | $(patsubst $(SRC_SYSTEM_API_DIR)/%.txt,%, $(wildcard $(SRC_SYSTEM_API_DIR)/*.txt)) \ |
| 301 | )\ |
| 302 | )) |
| 303 | |
| 304 | LOCAL_APIDIFF_OLDAPI := $(LOCAL_PATH)/../../$(SRC_SYSTEM_API_DIR)/$(last_released_sdk_version) |
| 305 | LOCAL_APIDIFF_NEWAPI := $(LOCAL_PATH)/../../$(basename $(INTERNAL_PLATFORM_SYSTEM_API_FILE)) |
| 306 | |
| 307 | include $(BUILD_APIDIFF) |
| 308 | |
Jeff Sharkey | c8dc254 | 2017-12-08 14:52:37 -0700 | [diff] [blame] | 309 | # Hack to get diffs included in docs output |
| 310 | out_zip := $(OUT_DOCS)/$(LOCAL_MODULE)-docs.zip |
| 311 | $(out_zip): $(full_target) |
| 312 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 313 | # ==== the api stubs and current.xml =========================== |
| 314 | include $(CLEAR_VARS) |
| 315 | |
| 316 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 317 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 318 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 319 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| 320 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 321 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 322 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 323 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| 324 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 325 | |
| 326 | LOCAL_MODULE := api-stubs |
| 327 | |
Ying Wang | 0f92a2e | 2015-07-16 14:20:22 -0700 | [diff] [blame] | 328 | LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_stubs_current_intermediates/src |
| 329 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 330 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 331 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 332 | -referenceonly \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 333 | -api $(INTERNAL_PLATFORM_API_FILE) \ |
David Brazdil | a793f3f | 2018-01-16 15:03:20 +0000 | [diff] [blame] | 334 | -privateApi $(INTERNAL_PLATFORM_PRIVATE_API_FILE) \ |
| 335 | -privateDexApi $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 336 | -removedApi $(INTERNAL_PLATFORM_REMOVED_API_FILE) \ |
| 337 | -nodocs |
| 338 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 339 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 340 | |
| 341 | LOCAL_UNINSTALLABLE_MODULE := true |
| 342 | |
| 343 | include $(BUILD_DROIDDOC) |
| 344 | |
David Brazdil | a793f3f | 2018-01-16 15:03:20 +0000 | [diff] [blame] | 345 | $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_API_FILE) \ |
| 346 | $(INTERNAL_PLATFORM_PRIVATE_API_FILE) \ |
| 347 | $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 348 | $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_API_FILE)) |
| 349 | |
| 350 | # ==== the system api stubs =================================== |
| 351 | include $(CLEAR_VARS) |
| 352 | |
| 353 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 354 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 355 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 356 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| 357 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 358 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 359 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 360 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| 361 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 362 | |
| 363 | LOCAL_MODULE := system-api-stubs |
| 364 | |
Ying Wang | 0f92a2e | 2015-07-16 14:20:22 -0700 | [diff] [blame] | 365 | LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_system_stubs_current_intermediates/src |
| 366 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 367 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 368 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 369 | -referenceonly \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 370 | -showAnnotation android.annotation.SystemApi \ |
| 371 | -api $(INTERNAL_PLATFORM_SYSTEM_API_FILE) \ |
David Brazdil | a793f3f | 2018-01-16 15:03:20 +0000 | [diff] [blame] | 372 | -privateApi $(INTERNAL_PLATFORM_SYSTEM_PRIVATE_API_FILE) \ |
| 373 | -privateDexApi $(INTERNAL_PLATFORM_SYSTEM_PRIVATE_DEX_API_FILE) \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 374 | -removedApi $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE) \ |
Jeff Sharkey | 05461c0 | 2017-05-09 19:01:09 -0600 | [diff] [blame] | 375 | -exactApi $(INTERNAL_PLATFORM_SYSTEM_EXACT_API_FILE) \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 376 | -nodocs |
| 377 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 378 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 379 | |
| 380 | LOCAL_UNINSTALLABLE_MODULE := true |
| 381 | |
| 382 | include $(BUILD_DROIDDOC) |
| 383 | |
David Brazdil | a793f3f | 2018-01-16 15:03:20 +0000 | [diff] [blame] | 384 | $(full_target): .KATI_IMPLICIT_OUTPUTS := $(INTERNAL_PLATFORM_SYSTEM_API_FILE) \ |
| 385 | $(INTERNAL_PLATFORM_SYSTEM_PRIVATE_API_FILE) \ |
| 386 | $(INTERNAL_PLATFORM_SYSTEM_PRIVATE_DEX_API_FILE) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 387 | $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_SYSTEM_API_FILE)) |
| 388 | |
Michael Wright | b2b2c0e | 2015-11-06 15:21:13 +0000 | [diff] [blame] | 389 | # ==== the test api stubs =================================== |
| 390 | include $(CLEAR_VARS) |
| 391 | |
| 392 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 393 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 394 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Michael Wright | b2b2c0e | 2015-11-06 15:21:13 +0000 | [diff] [blame] | 395 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) |
| 396 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 397 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 398 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 399 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
| 400 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 401 | |
| 402 | LOCAL_MODULE := test-api-stubs |
| 403 | |
| 404 | LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src |
| 405 | |
| 406 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 407 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 408 | -referenceonly \ |
Michael Wright | b2b2c0e | 2015-11-06 15:21:13 +0000 | [diff] [blame] | 409 | -stubs $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src \ |
| 410 | -showAnnotation android.annotation.TestApi \ |
| 411 | -api $(INTERNAL_PLATFORM_TEST_API_FILE) \ |
| 412 | -removedApi $(INTERNAL_PLATFORM_TEST_REMOVED_API_FILE) \ |
Jeff Sharkey | 05461c0 | 2017-05-09 19:01:09 -0600 | [diff] [blame] | 413 | -exactApi $(INTERNAL_PLATFORM_TEST_EXACT_API_FILE) \ |
Michael Wright | b2b2c0e | 2015-11-06 15:21:13 +0000 | [diff] [blame] | 414 | -nodocs |
| 415 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 416 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Michael Wright | b2b2c0e | 2015-11-06 15:21:13 +0000 | [diff] [blame] | 417 | |
| 418 | LOCAL_UNINSTALLABLE_MODULE := true |
| 419 | |
| 420 | include $(BUILD_DROIDDOC) |
| 421 | |
Michael Wright | b2b2c0e | 2015-11-06 15:21:13 +0000 | [diff] [blame] | 422 | $(INTERNAL_PLATFORM_TEST_API_FILE): $(full_target) |
| 423 | $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_TEST_API_FILE)) |
| 424 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 425 | # ==== check javadoc comments but don't generate docs ======== |
| 426 | include $(CLEAR_VARS) |
| 427 | |
| 428 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 429 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 430 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 431 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 432 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 433 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 434 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 435 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 436 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 437 | |
| 438 | LOCAL_MODULE := doc-comment-check |
| 439 | |
| 440 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 441 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 442 | -referenceonly \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 443 | -parsecomments |
| 444 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 445 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 446 | |
| 447 | LOCAL_UNINSTALLABLE_MODULE := true |
| 448 | |
| 449 | include $(BUILD_DROIDDOC) |
| 450 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 451 | # Run this for checkbuild |
| 452 | checkbuild: doc-comment-check-docs |
| 453 | # Check comment when you are updating the API |
| 454 | update-api: doc-comment-check-docs |
| 455 | |
| 456 | # ==== static html in the sdk ================================== |
| 457 | include $(CLEAR_VARS) |
| 458 | |
| 459 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 460 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 461 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 462 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 463 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 464 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 465 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 466 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 467 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 468 | |
| 469 | LOCAL_MODULE := offline-sdk |
| 470 | |
| 471 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 472 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 473 | -offlinemode \ |
| 474 | -title "Android SDK" \ |
| 475 | -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \ |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 476 | -sdkvalues $(OUT_DOCS) \ |
smain@google.com | 8562ab5 | 2016-06-14 17:11:57 -0700 | [diff] [blame] | 477 | -hdf android.whichdoc offline |
| 478 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 479 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
smain@google.com | 8562ab5 | 2016-06-14 17:11:57 -0700 | [diff] [blame] | 480 | |
| 481 | include $(BUILD_DROIDDOC) |
| 482 | |
| 483 | static_doc_index_redirect := $(out_dir)/index.html |
| 484 | $(static_doc_index_redirect): \ |
| 485 | $(LOCAL_PATH)/docs/docs-preview-index.html | $(ACP) |
| 486 | $(hide) mkdir -p $(dir $@) |
| 487 | $(hide) $(ACP) $< $@ |
| 488 | |
| 489 | $(full_target): $(static_doc_index_redirect) |
smain@google.com | 8562ab5 | 2016-06-14 17:11:57 -0700 | [diff] [blame] | 490 | |
| 491 | |
Jeff Sharkey | d2bf31c | 2017-11-29 13:14:27 -0700 | [diff] [blame] | 492 | # ==== Public API static reference docs ================================== |
smain@google.com | 8562ab5 | 2016-06-14 17:11:57 -0700 | [diff] [blame] | 493 | include $(CLEAR_VARS) |
| 494 | |
| 495 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 496 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 497 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
smain@google.com | 8562ab5 | 2016-06-14 17:11:57 -0700 | [diff] [blame] | 498 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 499 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 500 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 501 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 502 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 503 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 504 | |
| 505 | LOCAL_MODULE := offline-sdk-referenceonly |
| 506 | |
| 507 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 508 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 509 | -offlinemode \ |
| 510 | -title "Android SDK" \ |
| 511 | -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \ |
| 512 | -sdkvalues $(OUT_DOCS) \ |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 513 | -hdf android.whichdoc offline \ |
Scott Main | f8cdfc8 | 2017-03-21 13:43:31 -0700 | [diff] [blame] | 514 | -referenceonly |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 515 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 516 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 517 | |
| 518 | include $(BUILD_DROIDDOC) |
| 519 | |
| 520 | static_doc_index_redirect := $(out_dir)/index.html |
smain@google.com | 151833a | 2016-08-31 08:42:09 -0700 | [diff] [blame] | 521 | $(static_doc_index_redirect): $(LOCAL_PATH)/docs/docs-documentation-redirect.html |
Dan Willemsen | 98ff0b7 | 2016-03-23 00:42:44 -0700 | [diff] [blame] | 522 | $(copy-file-to-target) |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 523 | |
smain@google.com | 2f2365d | 2016-09-21 14:05:50 -0700 | [diff] [blame] | 524 | static_doc_properties := $(out_dir)/source.properties |
| 525 | $(static_doc_properties): \ |
| 526 | $(LOCAL_PATH)/docs/source.properties | $(ACP) |
| 527 | $(hide) mkdir -p $(dir $@) |
| 528 | $(hide) $(ACP) $< $@ |
| 529 | |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 530 | $(full_target): $(static_doc_index_redirect) |
smain@google.com | 2f2365d | 2016-09-21 14:05:50 -0700 | [diff] [blame] | 531 | $(full_target): $(static_doc_properties) |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 532 | |
smain@google.com | 7aca8be | 2016-03-10 14:13:30 -0800 | [diff] [blame] | 533 | |
Jeff Sharkey | d2bf31c | 2017-11-29 13:14:27 -0700 | [diff] [blame] | 534 | # ==== System API static reference docs ================================== |
| 535 | include $(CLEAR_VARS) |
| 536 | |
| 537 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 538 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 539 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Jeff Sharkey | d2bf31c | 2017-11-29 13:14:27 -0700 | [diff] [blame] | 540 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 541 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 542 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 543 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 544 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 545 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 546 | |
| 547 | LOCAL_MODULE := offline-system-sdk-referenceonly |
| 548 | |
| 549 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 550 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 551 | -hide 101 -hide 104 -hide 108 \ |
| 552 | -showAnnotation android.annotation.SystemApi \ |
| 553 | -offlinemode \ |
| 554 | -title "Android System SDK" \ |
| 555 | -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \ |
| 556 | -sdkvalues $(OUT_DOCS) \ |
| 557 | -hdf android.whichdoc offline \ |
| 558 | -referenceonly |
| 559 | |
| 560 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
| 561 | |
| 562 | include $(BUILD_DROIDDOC) |
| 563 | |
| 564 | static_doc_index_redirect := $(out_dir)/index.html |
| 565 | $(static_doc_index_redirect): $(LOCAL_PATH)/docs/docs-documentation-redirect.html |
| 566 | $(copy-file-to-target) |
| 567 | |
| 568 | static_doc_properties := $(out_dir)/source.properties |
| 569 | $(static_doc_properties): \ |
| 570 | $(LOCAL_PATH)/docs/source.properties | $(ACP) |
| 571 | $(hide) mkdir -p $(dir $@) |
| 572 | $(hide) $(ACP) $< $@ |
| 573 | |
| 574 | $(full_target): $(static_doc_index_redirect) |
| 575 | $(full_target): $(static_doc_properties) |
| 576 | $(full_target): $(framework_built) |
| 577 | |
| 578 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 579 | # ==== docs for the web (on the androiddevdocs app engine server) ======================= |
| 580 | include $(CLEAR_VARS) |
| 581 | |
| 582 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 583 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 584 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 585 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 586 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 587 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 588 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 589 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 590 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 591 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 592 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
| 593 | |
| 594 | LOCAL_MODULE := online-sdk |
| 595 | |
| 596 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 597 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 598 | -toroot / \ |
| 599 | -hdf android.whichdoc online \ |
| 600 | $(sample_groups) \ |
| 601 | -hdf android.hasSamples true \ |
| 602 | -samplesdir $(samples_dir) |
| 603 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 604 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 605 | |
| 606 | include $(BUILD_DROIDDOC) |
| 607 | |
| 608 | # ==== docs for the web (on the androiddevdocs app engine server) ======================= |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 609 | include $(CLEAR_VARS) |
| 610 | |
| 611 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 612 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 613 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 614 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 615 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 616 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 617 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 618 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 619 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 620 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 621 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
| 622 | |
| 623 | LOCAL_MODULE := online-system-api-sdk |
| 624 | |
| 625 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 626 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 627 | -referenceonly \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 628 | -showAnnotation android.annotation.SystemApi \ |
| 629 | -title "Android SDK - Including system APIs." \ |
| 630 | -toroot / \ |
Gina Dimino | 98ad888 | 2016-05-31 17:25:48 -0700 | [diff] [blame] | 631 | -hide 101 \ |
| 632 | -hide 104 \ |
| 633 | -hide 108 \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 634 | -hdf android.whichdoc online \ |
| 635 | $(sample_groups) \ |
| 636 | -hdf android.hasSamples true \ |
| 637 | -samplesdir $(samples_dir) |
| 638 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 639 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Jeff Sharkey | 05461c0 | 2017-05-09 19:01:09 -0600 | [diff] [blame] | 640 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 641 | LOCAL_UNINSTALLABLE_MODULE := true |
| 642 | |
| 643 | include $(BUILD_DROIDDOC) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 644 | |
| 645 | # ==== docs for the web (on the devsite app engine server) ======================= |
| 646 | include $(CLEAR_VARS) |
| 647 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 648 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 649 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 650 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 651 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 652 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 653 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 654 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 655 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 656 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 657 | # 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] | 658 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 659 | |
| 660 | LOCAL_MODULE := ds |
| 661 | |
| 662 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 663 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 664 | -toroot / \ |
| 665 | -hdf android.whichdoc online \ |
Dirk Dougherty | b042ab1 | 2016-06-14 16:26:28 -0700 | [diff] [blame] | 666 | -devsite \ |
Dirk Dougherty | 3852c1f | 2016-04-10 02:05:09 -0700 | [diff] [blame] | 667 | $(sample_groups) \ |
Dirk Dougherty | 3852c1f | 2016-04-10 02:05:09 -0700 | [diff] [blame] | 668 | -hdf android.hasSamples true \ |
| 669 | -samplesdir $(samples_dir) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 670 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 671 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 672 | |
| 673 | include $(BUILD_DROIDDOC) |
| 674 | |
Dirk Dougherty | b042ab1 | 2016-06-14 16:26:28 -0700 | [diff] [blame] | 675 | # ==== docs for the web (on the devsite app engine server) ======================= |
| 676 | include $(CLEAR_VARS) |
| 677 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 678 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 679 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Dirk Dougherty | b042ab1 | 2016-06-14 16:26:28 -0700 | [diff] [blame] | 680 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 681 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 682 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 683 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 684 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 685 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 686 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 687 | # specify a second html input dir and an output path relative to OUT_DIR) |
| 688 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
| 689 | |
| 690 | LOCAL_MODULE := ds-static |
| 691 | |
| 692 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 693 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 694 | -hdf android.whichdoc online \ |
| 695 | -staticonly \ |
| 696 | -toroot / \ |
| 697 | -devsite \ |
| 698 | -ignoreJdLinks |
| 699 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 700 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Dirk Dougherty | b042ab1 | 2016-06-14 16:26:28 -0700 | [diff] [blame] | 701 | |
| 702 | include $(BUILD_DROIDDOC) |
| 703 | |
Dirk Dougherty | 7d47b55 | 2016-09-13 16:44:25 -0700 | [diff] [blame] | 704 | # ==== generates full navtree for resolving @links in ds postprocessing ==== |
| 705 | include $(CLEAR_VARS) |
| 706 | |
| 707 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 708 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 709 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Dirk Dougherty | 7d47b55 | 2016-09-13 16:44:25 -0700 | [diff] [blame] | 710 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 711 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 712 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 713 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 714 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 715 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 716 | |
| 717 | LOCAL_MODULE := ds-ref-navtree |
| 718 | |
| 719 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 720 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 721 | -hdf android.whichdoc online \ |
| 722 | -toroot / \ |
| 723 | -atLinksNavtree \ |
| 724 | -navtreeonly |
| 725 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 726 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Dirk Dougherty | 7d47b55 | 2016-09-13 16:44:25 -0700 | [diff] [blame] | 727 | |
| 728 | include $(BUILD_DROIDDOC) |
| 729 | |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 730 | # ==== site updates for docs (on the androiddevdocs app engine server) ======================= |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 731 | include $(CLEAR_VARS) |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 732 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 733 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 734 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 735 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 736 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 737 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 738 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 739 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 740 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 741 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 742 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 743 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 744 | |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 745 | LOCAL_MODULE := online-sdk-dev |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 746 | |
| 747 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 748 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 749 | -toroot / \ |
| 750 | -hdf android.whichdoc online \ |
| 751 | $(sample_groups) \ |
| 752 | -hdf android.hasSamples true \ |
| 753 | -samplesdir $(samples_dir) |
| 754 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 755 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 756 | |
| 757 | include $(BUILD_DROIDDOC) |
| 758 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 759 | # ==== docs that have all of the stuff that's @hidden ======================= |
| 760 | include $(CLEAR_VARS) |
| 761 | |
| 762 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | bd200ce | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 763 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | cf3a0b5 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 764 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 765 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 766 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 767 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 768 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 769 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 770 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 771 | |
| 772 | LOCAL_MODULE := hidden |
| 773 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 774 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 775 | -referenceonly \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 776 | -title "Android SDK - Including hidden APIs." |
| 777 | # -hidden |
| 778 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 779 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 780 | |
| 781 | include $(BUILD_DROIDDOC) |
| 782 | |
Joe Onorato | 1754d74 | 2016-11-21 17:51:35 -0800 | [diff] [blame] | 783 | # ==== java proto host library ============================== |
| 784 | include $(CLEAR_VARS) |
| 785 | LOCAL_MODULE := platformprotos |
| 786 | LOCAL_PROTOC_OPTIMIZE_TYPE := full |
| 787 | LOCAL_PROTOC_FLAGS := \ |
| 788 | -Iexternal/protobuf/src |
| 789 | LOCAL_SOURCE_FILES_ALL_GENERATED := true |
| 790 | LOCAL_SRC_FILES := \ |
Mike Ma | da3a295 | 2017-11-13 12:06:45 -0800 | [diff] [blame] | 791 | cmds/am/proto/instrumentation_data.proto \ |
Primiano Tucci | e4d4491 | 2018-01-10 12:14:50 +0000 | [diff] [blame] | 792 | cmds/statsd/src/perfetto/perfetto_config.proto \ |
Joe Onorato | 1754d74 | 2016-11-21 17:51:35 -0800 | [diff] [blame] | 793 | $(call all-proto-files-under, core/proto) \ |
Chenjie Yu | 15176cd | 2017-11-22 12:36:41 -0800 | [diff] [blame] | 794 | $(call all-proto-files-under, libs/incident/proto) \ |
| 795 | $(call all-proto-files-under, cmds/statsd/src) |
Joe Onorato | 1754d74 | 2016-11-21 17:51:35 -0800 | [diff] [blame] | 796 | include $(BUILD_HOST_JAVA_LIBRARY) |
| 797 | |
Steven Timotius | 7ece042 | 2017-08-03 13:37:26 -0700 | [diff] [blame] | 798 | # ==== java proto device library (for test only) ============================== |
| 799 | include $(CLEAR_VARS) |
| 800 | LOCAL_MODULE := platformprotosnano |
Joe Onorato | 62c220b | 2017-11-18 20:32:56 -0800 | [diff] [blame] | 801 | LOCAL_MODULE_TAGS := tests |
Steven Timotius | 7ece042 | 2017-08-03 13:37:26 -0700 | [diff] [blame] | 802 | LOCAL_PROTOC_OPTIMIZE_TYPE := nano |
| 803 | LOCAL_PROTOC_FLAGS := \ |
| 804 | -Iexternal/protobuf/src |
| 805 | LOCAL_PROTO_JAVA_OUTPUT_PARAMS := \ |
| 806 | store_unknown_fields = true |
| 807 | LOCAL_JAVA_LIBRARIES := core-oj core-libart |
| 808 | LOCAL_SRC_FILES := \ |
Yi Jin | 437aa6e | 2018-01-10 11:34:26 -0800 | [diff] [blame] | 809 | $(call all-proto-files-under, core/proto) \ |
| 810 | $(call all-proto-files-under, libs/incident/proto/android/os) |
Steven Timotius | 7ece042 | 2017-08-03 13:37:26 -0700 | [diff] [blame] | 811 | include $(BUILD_STATIC_JAVA_LIBRARY) |
| 812 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 813 | |
Joe Onorato | 62c220b | 2017-11-18 20:32:56 -0800 | [diff] [blame] | 814 | # ==== java proto device library (for test only) ============================== |
| 815 | include $(CLEAR_VARS) |
| 816 | LOCAL_MODULE := platformprotoslite |
| 817 | LOCAL_MODULE_TAGS := tests |
| 818 | LOCAL_PROTOC_OPTIMIZE_TYPE := lite |
| 819 | LOCAL_PROTOC_FLAGS := \ |
| 820 | -Iexternal/protobuf/src |
| 821 | LOCAL_SRC_FILES := \ |
Yi Jin | 437aa6e | 2018-01-10 11:34:26 -0800 | [diff] [blame] | 822 | $(call all-proto-files-under, core/proto) \ |
| 823 | $(call all-proto-files-under, libs/incident/proto/android/os) |
Andreas Gampe | 93b64c9 | 2018-01-30 18:50:34 -0800 | [diff] [blame] | 824 | # Protos have lots of MissingOverride and similar. |
| 825 | LOCAL_ERROR_PRONE_FLAGS := -XepDisableAllChecks |
Joe Onorato | 62c220b | 2017-11-18 20:32:56 -0800 | [diff] [blame] | 826 | include $(BUILD_STATIC_JAVA_LIBRARY) |
| 827 | |
David Brazdil | 0649c8d | 2018-01-22 22:23:13 +0000 | [diff] [blame] | 828 | # ==== hiddenapi lists ======================================= |
| 829 | |
David Brazdil | 3f4136c | 2018-02-07 00:39:22 +0000 | [diff] [blame^] | 830 | # Copy light greylist and dark greylist over into the build folder. |
David Brazdil | f16ac00 | 2018-01-26 11:13:35 +0000 | [diff] [blame] | 831 | # This is for ART buildbots which need to mock these lists and have alternative |
| 832 | # rules for building them. Other rules in the build system should depend on the |
| 833 | # files in the build folder. |
| 834 | |
David Brazdil | b43351f | 2018-01-31 14:43:36 +0000 | [diff] [blame] | 835 | $(eval $(call copy-one-file,frameworks/base/config/hiddenapi-light-greylist.txt,\ |
| 836 | $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST))) |
David Brazdil | 3f4136c | 2018-02-07 00:39:22 +0000 | [diff] [blame^] | 837 | $(eval $(call copy-one-file,frameworks/base/config/hiddenapi-dark-greylist.txt,\ |
| 838 | $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST))) |
David Brazdil | f16ac00 | 2018-01-26 11:13:35 +0000 | [diff] [blame] | 839 | |
David Brazdil | 3f4136c | 2018-02-07 00:39:22 +0000 | [diff] [blame^] | 840 | # Generate blacklist as private API minus (light greylist plus dark greylist). |
David Brazdil | 0649c8d | 2018-01-22 22:23:13 +0000 | [diff] [blame] | 841 | |
David Brazdil | 3f4136c | 2018-02-07 00:39:22 +0000 | [diff] [blame^] | 842 | $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST): PRIVATE_API := $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) |
| 843 | $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST): LIGHT_GREYLIST := $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST) |
| 844 | $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST): DARK_GREYLIST := $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST) |
| 845 | $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST): $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) \ |
| 846 | $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST) \ |
| 847 | $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST) |
| 848 | if [ ! -z "`comm -12 <(sort $(LIGHT_GREYLIST)) <(sort $(DARK_GREYLIST))`" ]; then \ |
| 849 | echo "There should be no overlap between $(LIGHT_GREYLIST) and $(DARK_GREYLIST)" 1>&2; \ |
David Brazdil | 0649c8d | 2018-01-22 22:23:13 +0000 | [diff] [blame] | 850 | exit 1; \ |
David Brazdil | b43351f | 2018-01-31 14:43:36 +0000 | [diff] [blame] | 851 | elif [ ! -z "`comm -13 <(sort $(PRIVATE_API)) <(sort $(LIGHT_GREYLIST))`" ]; then \ |
| 852 | echo "$(LIGHT_GREYLIST) must be a subset of $(PRIVATE_API)" 1>&2; \ |
David Brazdil | 3f4136c | 2018-02-07 00:39:22 +0000 | [diff] [blame^] | 853 | exit 2; \ |
| 854 | elif [ ! -z "`comm -13 <(sort $(PRIVATE_API)) <(sort $(DARK_GREYLIST))`" ]; then \ |
| 855 | echo "$(DARK_GREYLIST) must be a subset of $(PRIVATE_API)" 1>&2; \ |
David Brazdil | 0649c8d | 2018-01-22 22:23:13 +0000 | [diff] [blame] | 856 | exit 3; \ |
| 857 | fi |
David Brazdil | 3f4136c | 2018-02-07 00:39:22 +0000 | [diff] [blame^] | 858 | comm -23 <(sort $(PRIVATE_API)) <(sort $(LIGHT_GREYLIST) $(DARK_GREYLIST)) > $@ |
David Brazdil | 0649c8d | 2018-01-22 22:23:13 +0000 | [diff] [blame] | 859 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 860 | # Include subdirectory makefiles |
| 861 | # ============================================================ |
| 862 | |
| 863 | # If we're building with ONE_SHOT_MAKEFILE (mm, mmm), then what the framework |
| 864 | # team really wants is to build the stuff defined by this makefile. |
| 865 | ifeq (,$(ONE_SHOT_MAKEFILE)) |
| 866 | include $(call first-makefiles-under,$(LOCAL_PATH)) |
| 867 | endif |
| 868 | |
Holly Jiuyu Sun | bbc8580 | 2017-12-21 18:44:59 -0800 | [diff] [blame] | 869 | endif # ANDROID_BUILD_EMBEDDED |
| 870 | |