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 | 5f4dcf6 | 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 | 5f4dcf6 | 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 | 5f4dcf6 | 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 | |
Paul Duffin | c08090f | 2017-06-29 14:58:43 +0100 | [diff] [blame] | 75 | framework_base_android_test_mock_src_files := \ |
Paul Duffin | 69516f4 | 2017-11-15 11:39:14 +0000 | [diff] [blame] | 76 | $(call all-java-files-under, test-mock/src/android/test/mock) |
Paul Duffin | c08090f | 2017-06-29 14:58:43 +0100 | [diff] [blame] | 77 | |
| 78 | framework_base_android_test_runner_excluding_mock_src_files := \ |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 79 | $(filter-out $(framework_base_android_test_mock_src_files), $(call all-java-files-under, test-runner/src)) |
Paul Duffin | c08090f | 2017-06-29 14:58:43 +0100 | [diff] [blame] | 80 | |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 81 | # Find all files in specific directories (relative to frameworks/base) |
| 82 | # to document and check apis |
| 83 | files_to_check_apis := \ |
| 84 | $(call find-other-java-files, \ |
Paul Duffin | 2141827 | 2017-11-16 15:47:05 +0000 | [diff] [blame] | 85 | test-base/src \ |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 86 | $(non_base_dirs) \ |
| 87 | ) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 88 | |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 89 | # Find all files in specific packages that were used to compile |
| 90 | # framework.jar to document and check apis |
| 91 | files_to_check_apis += \ |
| 92 | $(addprefix ../../,\ |
| 93 | $(filter \ |
| 94 | $(foreach dir,$(FRAMEWORKS_BASE_JAVA_SRC_DIRS),\ |
| 95 | $(foreach package,$(packages_to_document),\ |
| 96 | $(dir)/$(package)/%.java)),\ |
| 97 | $(SOONG_FRAMEWORK_SRCS))) |
| 98 | |
| 99 | # Find all generated files that were used to compile framework.jar |
Colin Cross | 0c76095 | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 100 | files_to_check_apis_generated := \ |
| 101 | $(filter $(OUT_DIR)/%,\ |
| 102 | $(SOONG_FRAMEWORK_SRCS)) |
George Mount | f6be993 | 2015-12-03 07:39:55 -0800 | [diff] [blame] | 103 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 104 | # These are relative to frameworks/base |
| 105 | # FRAMEWORKS_BASE_SUBDIRS comes from build/core/pathmap.mk |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 106 | files_to_document := \ |
| 107 | $(files_to_check_apis) \ |
| 108 | $(call find-other-java-files,\ |
| 109 | $(addprefix ../../, $(FRAMEWORKS_DATA_BINDING_JAVA_SRC_DIRS)) \ |
| 110 | test-runner/src) |
George Mount | f6be993 | 2015-12-03 07:39:55 -0800 | [diff] [blame] | 111 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 112 | # These are relative to frameworks/base |
| 113 | html_dirs := \ |
| 114 | $(FRAMEWORKS_BASE_SUBDIRS) \ |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 115 | $(non_base_dirs) \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 116 | |
| 117 | # Common sources for doc check and api check |
| 118 | common_src_files := \ |
| 119 | $(call find-other-html-files, $(html_dirs)) \ |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 120 | $(addprefix ../../, $(libcore_to_document)) \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 121 | |
| 122 | # These are relative to frameworks/base |
| 123 | framework_docs_LOCAL_SRC_FILES := \ |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 124 | $(files_to_document) \ |
| 125 | $(common_src_files) \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 126 | |
| 127 | # These are relative to frameworks/base |
| 128 | framework_docs_LOCAL_API_CHECK_SRC_FILES := \ |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 129 | $(framework_base_android_test_mock_src_files) \ |
| 130 | $(framework_base_android_test_runner_excluding_mock_src_files) \ |
| 131 | $(files_to_check_apis) \ |
| 132 | $(common_src_files) \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 133 | |
| 134 | # This is used by ide.mk as the list of source files that are |
| 135 | # always included. |
| 136 | INTERNAL_SDK_SOURCE_DIRS := $(addprefix $(LOCAL_PATH)/,$(dirs_to_document)) |
| 137 | |
| 138 | framework_docs_LOCAL_DROIDDOC_SOURCE_PATH := \ |
| 139 | $(FRAMEWORKS_BASE_JAVA_SRC_DIRS) |
| 140 | |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 141 | framework_docs_LOCAL_SRCJARS := $(SOONG_FRAMEWORK_SRCJARS) |
| 142 | |
Colin Cross | 0c76095 | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 143 | framework_docs_LOCAL_GENERATED_SOURCES := \ |
| 144 | $(libcore_to_document_generated) \ |
| 145 | $(files_to_check_apis_generated) \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 146 | |
| 147 | framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES := \ |
Piotr Jastrzebski | cfa292e | 2015-02-17 16:58:52 +0000 | [diff] [blame] | 148 | core-oj \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 149 | core-libart \ |
| 150 | conscrypt \ |
| 151 | bouncycastle \ |
| 152 | okhttp \ |
| 153 | ext \ |
| 154 | framework \ |
Paul Duffin | c08090f | 2017-06-29 14:58:43 +0100 | [diff] [blame] | 155 | voip-common \ |
| 156 | android.test.mock \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 157 | |
Alan Viverette | 2d362a5 | 2017-04-05 10:21:58 -0400 | [diff] [blame] | 158 | # Platform docs can refer to Support Library APIs, but we don't actually build |
| 159 | # 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] | 160 | framework_docs_LOCAL_JAVA_LIBRARIES := \ |
| 161 | $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) \ |
| 162 | $(FRAMEWORKS_SUPPORT_JAVA_LIBRARIES) |
| 163 | |
| 164 | framework_docs_LOCAL_MODULE_CLASS := JAVA_LIBRARIES |
| 165 | framework_docs_LOCAL_DROIDDOC_HTML_DIR := docs/html |
| 166 | # The since flag (-since N.xml API_LEVEL) is used to add API Level information |
| 167 | # to the reference documentation. Must be in order of oldest to newest. |
| 168 | # |
| 169 | # Conscrypt (com.android.org.conscrypt) is an implementation detail and should |
| 170 | # not be referenced in the documentation. |
| 171 | framework_docs_LOCAL_DROIDDOC_OPTIONS := \ |
Jeff Sharkey | 0f3f60b | 2017-04-24 18:06:20 -0600 | [diff] [blame] | 172 | -android \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 173 | -knowntags ./frameworks/base/docs/knowntags.txt \ |
Narayan Kamath | 2c4f284 | 2015-07-27 14:02:11 +0100 | [diff] [blame] | 174 | -knowntags ./libcore/known_oj_tags.txt \ |
Jeff Sharkey | bfc4fcd | 2017-06-05 17:38:17 -0600 | [diff] [blame] | 175 | -manifest ./frameworks/base/core/res/AndroidManifest.xml \ |
Tobias Thierer | 97bb6cf | 2018-03-05 22:55:32 +0000 | [diff] [blame] | 176 | -hidePackage com.android.internal \ |
| 177 | -hidePackage com.android.internal.util \ |
Jeff Sharkey | bc4f48b | 2017-12-06 21:02:11 -0700 | [diff] [blame] | 178 | -hidePackage com.android.okhttp \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 179 | -hidePackage com.android.org.conscrypt \ |
Jeff Sharkey | bc4f48b | 2017-12-06 21:02:11 -0700 | [diff] [blame] | 180 | -hidePackage com.android.server \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 181 | -since $(SRC_API_DIR)/1.xml 1 \ |
| 182 | -since $(SRC_API_DIR)/2.xml 2 \ |
| 183 | -since $(SRC_API_DIR)/3.xml 3 \ |
| 184 | -since $(SRC_API_DIR)/4.xml 4 \ |
| 185 | -since $(SRC_API_DIR)/5.xml 5 \ |
| 186 | -since $(SRC_API_DIR)/6.xml 6 \ |
| 187 | -since $(SRC_API_DIR)/7.xml 7 \ |
| 188 | -since $(SRC_API_DIR)/8.xml 8 \ |
| 189 | -since $(SRC_API_DIR)/9.xml 9 \ |
| 190 | -since $(SRC_API_DIR)/10.xml 10 \ |
| 191 | -since $(SRC_API_DIR)/11.xml 11 \ |
| 192 | -since $(SRC_API_DIR)/12.xml 12 \ |
| 193 | -since $(SRC_API_DIR)/13.xml 13 \ |
| 194 | -since $(SRC_API_DIR)/14.txt 14 \ |
| 195 | -since $(SRC_API_DIR)/15.txt 15 \ |
| 196 | -since $(SRC_API_DIR)/16.txt 16 \ |
| 197 | -since $(SRC_API_DIR)/17.txt 17 \ |
| 198 | -since $(SRC_API_DIR)/18.txt 18 \ |
| 199 | -since $(SRC_API_DIR)/19.txt 19 \ |
| 200 | -since $(SRC_API_DIR)/20.txt 20 \ |
| 201 | -since $(SRC_API_DIR)/21.txt 21 \ |
| 202 | -since $(SRC_API_DIR)/22.txt 22 \ |
Joe Fernandez | 1827e32 | 2015-08-12 19:45:22 -0700 | [diff] [blame] | 203 | -since $(SRC_API_DIR)/23.txt 23 \ |
Dirk Dougherty | 5f60f7c | 2016-06-14 16:26:28 -0700 | [diff] [blame] | 204 | -since $(SRC_API_DIR)/24.txt 24 \ |
Dirk Dougherty | 3376f58 | 2016-10-14 10:27:08 -0700 | [diff] [blame] | 205 | -since $(SRC_API_DIR)/25.txt 25 \ |
Dirk Dougherty | fdad0ba | 2017-06-09 14:43:32 -0700 | [diff] [blame] | 206 | -since $(SRC_API_DIR)/26.txt 26 \ |
Andrew Solovay | a6019b2 | 2017-10-06 14:27:20 -0700 | [diff] [blame] | 207 | -since $(SRC_API_DIR)/27.txt 27 \ |
Jeff Sharkey | 2337aec | 2017-12-06 21:12:23 -0700 | [diff] [blame] | 208 | -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] | 209 | -overview $(LOCAL_PATH)/core/java/overview.html \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 210 | |
| 211 | framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR:= \ |
| 212 | $(call intermediates-dir-for,JAVA_LIBRARIES,framework,,COMMON) |
| 213 | |
| 214 | framework_docs_LOCAL_ADDITIONAL_JAVA_DIR:= \ |
Alan Viverette | 2d362a5 | 2017-04-05 10:21:58 -0400 | [diff] [blame] | 215 | $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 216 | |
| 217 | framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES := \ |
Narayan Kamath | c21739a | 2015-07-14 13:39:23 +0100 | [diff] [blame] | 218 | frameworks/base/docs/knowntags.txt \ |
Colin Cross | 72d359f | 2017-10-27 10:46:53 -0700 | [diff] [blame] | 219 | $(libcore_to_document_generated) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 220 | |
| 221 | samples_dir := development/samples/browseable |
| 222 | |
| 223 | # Whitelist of valid groups, used for default TOC grouping. Each sample must |
| 224 | # belong to one (and only one) group. Assign samples to groups by setting |
| 225 | # a sample.group var to one of these groups in the sample's _index.jd. |
| 226 | sample_groups := -samplegroup Admin \ |
| 227 | -samplegroup Background \ |
| 228 | -samplegroup Connectivity \ |
| 229 | -samplegroup Content \ |
| 230 | -samplegroup Input \ |
| 231 | -samplegroup Media \ |
| 232 | -samplegroup Notification \ |
| 233 | -samplegroup RenderScript \ |
| 234 | -samplegroup Security \ |
| 235 | -samplegroup Sensors \ |
Trevor Johns | 4cbe359 | 2015-05-27 14:50:51 -0700 | [diff] [blame] | 236 | -samplegroup System \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 237 | -samplegroup Testing \ |
| 238 | -samplegroup UI \ |
| 239 | -samplegroup Views \ |
| 240 | -samplegroup Wearable |
| 241 | |
| 242 | ## SDK version identifiers used in the published docs |
| 243 | # major[.minor] version for current SDK. (full releases only) |
smain@google.com | dde8deb | 2016-08-29 18:36:50 -0700 | [diff] [blame] | 244 | framework_docs_SDK_VERSION:=7.0 |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 245 | # release version (ie "Release x") (full releases only) |
| 246 | framework_docs_SDK_REL_ID:=1 |
| 247 | |
| 248 | framework_docs_LOCAL_DROIDDOC_OPTIONS += \ |
Billy Lamberta | 75dbc8f | 2017-03-03 13:09:15 -0800 | [diff] [blame] | 249 | -hdf dac true \ |
Scott Main | f8cdfc8 | 2017-03-21 13:43:31 -0700 | [diff] [blame] | 250 | -hdf sdk.codename O \ |
| 251 | -hdf sdk.preview.version 1 \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 252 | -hdf sdk.version $(framework_docs_SDK_VERSION) \ |
| 253 | -hdf sdk.rel.id $(framework_docs_SDK_REL_ID) \ |
Scott Main | f8cdfc8 | 2017-03-21 13:43:31 -0700 | [diff] [blame] | 254 | -hdf sdk.preview 0 \ |
| 255 | -resourcesdir $(LOCAL_PATH)/docs/html/reference/images/ \ |
| 256 | -resourcesoutdir reference/android/images/ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 257 | |
Alan Viverette | 2d362a5 | 2017-04-05 10:21:58 -0400 | [diff] [blame] | 258 | # Federate Support Library references against local API file. |
| 259 | framework_docs_LOCAL_DROIDDOC_OPTIONS += \ |
| 260 | -federate SupportLib https://developer.android.com \ |
| 261 | -federationapi SupportLib prebuilts/sdk/current/support-api.txt |
| 262 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 263 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 264 | $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_API_FILE)) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 265 | $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_SYSTEM_API_FILE)) |
Michael Wright | b2b2c0e | 2015-11-06 15:21:13 +0000 | [diff] [blame] | 266 | $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_TEST_API_FILE)) |
| 267 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 268 | # ==== check javadoc comments but don't generate docs ======== |
| 269 | include $(CLEAR_VARS) |
| 270 | |
| 271 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | 0c76095 | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 272 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 273 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 274 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 275 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 276 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 277 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 278 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 279 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 280 | |
| 281 | LOCAL_MODULE := doc-comment-check |
| 282 | |
| 283 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 284 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 285 | -referenceonly \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 286 | -parsecomments |
| 287 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 288 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 289 | |
| 290 | LOCAL_UNINSTALLABLE_MODULE := true |
| 291 | |
| 292 | include $(BUILD_DROIDDOC) |
| 293 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 294 | # Run this for checkbuild |
| 295 | checkbuild: doc-comment-check-docs |
| 296 | # Check comment when you are updating the API |
| 297 | update-api: doc-comment-check-docs |
| 298 | |
| 299 | # ==== static html in the sdk ================================== |
| 300 | include $(CLEAR_VARS) |
| 301 | |
| 302 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | 0c76095 | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 303 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 304 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 305 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 306 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 307 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 308 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 309 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 310 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 311 | |
| 312 | LOCAL_MODULE := offline-sdk |
| 313 | |
| 314 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 315 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 316 | -offlinemode \ |
| 317 | -title "Android SDK" \ |
| 318 | -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \ |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 319 | -sdkvalues $(OUT_DOCS) \ |
smain@google.com | 8562ab5 | 2016-06-14 17:11:57 -0700 | [diff] [blame] | 320 | -hdf android.whichdoc offline |
| 321 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 322 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
smain@google.com | 8562ab5 | 2016-06-14 17:11:57 -0700 | [diff] [blame] | 323 | |
| 324 | include $(BUILD_DROIDDOC) |
| 325 | |
| 326 | static_doc_index_redirect := $(out_dir)/index.html |
| 327 | $(static_doc_index_redirect): \ |
| 328 | $(LOCAL_PATH)/docs/docs-preview-index.html | $(ACP) |
| 329 | $(hide) mkdir -p $(dir $@) |
| 330 | $(hide) $(ACP) $< $@ |
| 331 | |
| 332 | $(full_target): $(static_doc_index_redirect) |
smain@google.com | 8562ab5 | 2016-06-14 17:11:57 -0700 | [diff] [blame] | 333 | |
| 334 | |
| 335 | # ==== static html in the sdk ================================== |
| 336 | include $(CLEAR_VARS) |
| 337 | |
| 338 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | 0c76095 | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 339 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 340 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
smain@google.com | 8562ab5 | 2016-06-14 17:11:57 -0700 | [diff] [blame] | 341 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 342 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 343 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 344 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 345 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 346 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 347 | |
| 348 | LOCAL_MODULE := offline-sdk-referenceonly |
| 349 | |
| 350 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 351 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 352 | -offlinemode \ |
| 353 | -title "Android SDK" \ |
| 354 | -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \ |
| 355 | -sdkvalues $(OUT_DOCS) \ |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 356 | -hdf android.whichdoc offline \ |
Scott Main | f8cdfc8 | 2017-03-21 13:43:31 -0700 | [diff] [blame] | 357 | -referenceonly |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 358 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 359 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 360 | |
| 361 | include $(BUILD_DROIDDOC) |
| 362 | |
| 363 | static_doc_index_redirect := $(out_dir)/index.html |
smain@google.com | 151833a | 2016-08-31 08:42:09 -0700 | [diff] [blame] | 364 | $(static_doc_index_redirect): $(LOCAL_PATH)/docs/docs-documentation-redirect.html |
Dan Willemsen | 98ff0b7 | 2016-03-23 00:42:44 -0700 | [diff] [blame] | 365 | $(copy-file-to-target) |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 366 | |
smain@google.com | 2f2365d | 2016-09-21 14:05:50 -0700 | [diff] [blame] | 367 | static_doc_properties := $(out_dir)/source.properties |
| 368 | $(static_doc_properties): \ |
| 369 | $(LOCAL_PATH)/docs/source.properties | $(ACP) |
| 370 | $(hide) mkdir -p $(dir $@) |
| 371 | $(hide) $(ACP) $< $@ |
| 372 | |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 373 | $(full_target): $(static_doc_index_redirect) |
smain@google.com | 2f2365d | 2016-09-21 14:05:50 -0700 | [diff] [blame] | 374 | $(full_target): $(static_doc_properties) |
smain@google.com | 00de8c5 | 2016-03-07 18:38:08 -0800 | [diff] [blame] | 375 | |
smain@google.com | 7aca8be | 2016-03-10 14:13:30 -0800 | [diff] [blame] | 376 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 377 | # ==== docs for the web (on the androiddevdocs app engine server) ======================= |
| 378 | include $(CLEAR_VARS) |
| 379 | |
| 380 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | 0c76095 | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 381 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 382 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 383 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 384 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 385 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 386 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 387 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 388 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 389 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 390 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
| 391 | |
| 392 | LOCAL_MODULE := online-sdk |
| 393 | |
| 394 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 395 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 396 | -toroot / \ |
| 397 | -hdf android.whichdoc online \ |
| 398 | $(sample_groups) \ |
| 399 | -hdf android.hasSamples true \ |
| 400 | -samplesdir $(samples_dir) |
| 401 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 402 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 403 | |
| 404 | include $(BUILD_DROIDDOC) |
| 405 | |
| 406 | # ==== docs for the web (on the androiddevdocs app engine server) ======================= |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 407 | include $(CLEAR_VARS) |
| 408 | |
| 409 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | 0c76095 | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 410 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 411 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 412 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 413 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 414 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 415 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 416 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 417 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 418 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 419 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
| 420 | |
| 421 | LOCAL_MODULE := online-system-api-sdk |
| 422 | |
| 423 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 424 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 425 | -referenceonly \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 426 | -showAnnotation android.annotation.SystemApi \ |
| 427 | -title "Android SDK - Including system APIs." \ |
| 428 | -toroot / \ |
Gina Dimino | 98ad888 | 2016-05-31 17:25:48 -0700 | [diff] [blame] | 429 | -hide 101 \ |
| 430 | -hide 104 \ |
| 431 | -hide 108 \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 432 | -hdf android.whichdoc online \ |
| 433 | $(sample_groups) \ |
| 434 | -hdf android.hasSamples true \ |
| 435 | -samplesdir $(samples_dir) |
| 436 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 437 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Jeff Sharkey | 05461c0 | 2017-05-09 19:01:09 -0600 | [diff] [blame] | 438 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 439 | LOCAL_UNINSTALLABLE_MODULE := true |
| 440 | |
| 441 | include $(BUILD_DROIDDOC) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 442 | |
| 443 | # ==== docs for the web (on the devsite app engine server) ======================= |
| 444 | include $(CLEAR_VARS) |
| 445 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | 0c76095 | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 446 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 447 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 448 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 449 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 450 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 451 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 452 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 453 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 454 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 455 | # 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] | 456 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 457 | |
| 458 | LOCAL_MODULE := ds |
| 459 | |
| 460 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 461 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 462 | -toroot / \ |
| 463 | -hdf android.whichdoc online \ |
Dirk Dougherty | b042ab1 | 2016-06-14 16:26:28 -0700 | [diff] [blame] | 464 | -devsite \ |
Dirk Dougherty | 3852c1f | 2016-04-10 02:05:09 -0700 | [diff] [blame] | 465 | $(sample_groups) \ |
Dirk Dougherty | 3852c1f | 2016-04-10 02:05:09 -0700 | [diff] [blame] | 466 | -hdf android.hasSamples true \ |
| 467 | -samplesdir $(samples_dir) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 468 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 469 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 470 | |
| 471 | include $(BUILD_DROIDDOC) |
| 472 | |
Dirk Dougherty | b042ab1 | 2016-06-14 16:26:28 -0700 | [diff] [blame] | 473 | # ==== docs for the web (on the devsite app engine server) ======================= |
| 474 | include $(CLEAR_VARS) |
| 475 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | 0c76095 | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 476 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 477 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Dirk Dougherty | b042ab1 | 2016-06-14 16:26:28 -0700 | [diff] [blame] | 478 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 479 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 480 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 481 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 482 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 483 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 484 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 485 | # specify a second html input dir and an output path relative to OUT_DIR) |
| 486 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
| 487 | |
| 488 | LOCAL_MODULE := ds-static |
| 489 | |
| 490 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 491 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 492 | -hdf android.whichdoc online \ |
| 493 | -staticonly \ |
| 494 | -toroot / \ |
| 495 | -devsite \ |
| 496 | -ignoreJdLinks |
| 497 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 498 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Dirk Dougherty | b042ab1 | 2016-06-14 16:26:28 -0700 | [diff] [blame] | 499 | |
| 500 | include $(BUILD_DROIDDOC) |
| 501 | |
Dirk Dougherty | 7d47b55 | 2016-09-13 16:44:25 -0700 | [diff] [blame] | 502 | # ==== generates full navtree for resolving @links in ds postprocessing ==== |
| 503 | include $(CLEAR_VARS) |
| 504 | |
| 505 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | 0c76095 | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 506 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 507 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Dirk Dougherty | 7d47b55 | 2016-09-13 16:44:25 -0700 | [diff] [blame] | 508 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 509 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 510 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 511 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 512 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 513 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 514 | |
| 515 | LOCAL_MODULE := ds-ref-navtree |
| 516 | |
| 517 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 518 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 519 | -hdf android.whichdoc online \ |
| 520 | -toroot / \ |
| 521 | -atLinksNavtree \ |
| 522 | -navtreeonly |
| 523 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 524 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Dirk Dougherty | 7d47b55 | 2016-09-13 16:44:25 -0700 | [diff] [blame] | 525 | |
| 526 | include $(BUILD_DROIDDOC) |
| 527 | |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 528 | # ==== site updates for docs (on the androiddevdocs app engine server) ======================= |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 529 | include $(CLEAR_VARS) |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 530 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 531 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | 0c76095 | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 532 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 533 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 534 | LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) |
| 535 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 536 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 537 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 538 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 539 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 540 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 541 | LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl / |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 542 | |
Dirk Dougherty | 31ae1c51 | 2015-11-07 13:18:02 -0800 | [diff] [blame] | 543 | LOCAL_MODULE := online-sdk-dev |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 544 | |
| 545 | LOCAL_DROIDDOC_OPTIONS:= \ |
| 546 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
| 547 | -toroot / \ |
| 548 | -hdf android.whichdoc online \ |
| 549 | $(sample_groups) \ |
| 550 | -hdf android.hasSamples true \ |
| 551 | -samplesdir $(samples_dir) |
| 552 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 553 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 554 | |
| 555 | include $(BUILD_DROIDDOC) |
| 556 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 557 | # ==== docs that have all of the stuff that's @hidden ======================= |
| 558 | include $(CLEAR_VARS) |
| 559 | |
| 560 | LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) |
Colin Cross | 0c76095 | 2017-12-04 13:45:19 -0800 | [diff] [blame] | 561 | LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES) |
Colin Cross | 5f4dcf6 | 2017-11-16 00:15:28 -0800 | [diff] [blame] | 562 | LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS) |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 563 | LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) |
| 564 | LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) |
| 565 | LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) |
| 566 | LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) |
| 567 | LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) |
| 568 | LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) |
| 569 | |
| 570 | LOCAL_MODULE := hidden |
| 571 | LOCAL_DROIDDOC_OPTIONS:=\ |
| 572 | $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ |
smain@google.com | 534bfe1 | 2016-09-01 19:52:17 -0700 | [diff] [blame] | 573 | -referenceonly \ |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 574 | -title "Android SDK - Including hidden APIs." |
| 575 | # -hidden |
| 576 | |
Scott Main | 15b8517 | 2017-02-21 14:30:58 -0800 | [diff] [blame] | 577 | LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 578 | |
| 579 | include $(BUILD_DROIDDOC) |
| 580 | |
Joe Onorato | 1754d74 | 2016-11-21 17:51:35 -0800 | [diff] [blame] | 581 | # ==== java proto host library ============================== |
| 582 | include $(CLEAR_VARS) |
| 583 | LOCAL_MODULE := platformprotos |
| 584 | LOCAL_PROTOC_OPTIMIZE_TYPE := full |
| 585 | LOCAL_PROTOC_FLAGS := \ |
| 586 | -Iexternal/protobuf/src |
| 587 | LOCAL_SOURCE_FILES_ALL_GENERATED := true |
| 588 | LOCAL_SRC_FILES := \ |
| 589 | $(call all-proto-files-under, core/proto) \ |
| 590 | $(call all-proto-files-under, libs/incident/proto) |
Andreas Gampe | 7b9b5d7 | 2018-02-15 15:12:38 -0800 | [diff] [blame] | 591 | # b/72714520 |
| 592 | LOCAL_ERROR_PRONE_FLAGS := -Xep:MissingOverride:OFF |
Joe Onorato | 1754d74 | 2016-11-21 17:51:35 -0800 | [diff] [blame] | 593 | include $(BUILD_HOST_JAVA_LIBRARY) |
| 594 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 595 | |
David Brazdil | 0649c8d | 2018-01-22 22:23:13 +0000 | [diff] [blame] | 596 | # ==== hiddenapi lists ======================================= |
| 597 | |
David Brazdil | f16ac00 | 2018-01-26 11:13:35 +0000 | [diff] [blame] | 598 | # Copy blacklist and dark greylist over into the build folder. |
| 599 | # This is for ART buildbots which need to mock these lists and have alternative |
| 600 | # rules for building them. Other rules in the build system should depend on the |
| 601 | # files in the build folder. |
| 602 | |
| 603 | $(eval $(call copy-one-file,frameworks/base/config/hiddenapi-blacklist.txt,\ |
| 604 | $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST))) |
| 605 | $(eval $(call copy-one-file,frameworks/base/config/hiddenapi-dark-greylist.txt,\ |
| 606 | $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST))) |
| 607 | |
David Brazdil | 0649c8d | 2018-01-22 22:23:13 +0000 | [diff] [blame] | 608 | # Generate light greylist as private API minus (blacklist plus dark greylist). |
| 609 | |
| 610 | $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST): PRIVATE_API := $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) |
| 611 | $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST): BLACKLIST := $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST) |
| 612 | $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST): DARK_GREYLIST := $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST) |
| 613 | $(INTERNAL_PLATFORM_HIDDENAPI_LIGHT_GREYLIST): $(INTERNAL_PLATFORM_PRIVATE_DEX_API_FILE) \ |
| 614 | $(INTERNAL_PLATFORM_HIDDENAPI_BLACKLIST) \ |
| 615 | $(INTERNAL_PLATFORM_HIDDENAPI_DARK_GREYLIST) |
| 616 | if [ ! -z "`comm -12 <(sort $(BLACKLIST)) <(sort $(DARK_GREYLIST))`" ]; then \ |
| 617 | echo "There should be no overlap between $(BLACKLIST) and $(DARK_GREYLIST)" 1>&2; \ |
| 618 | exit 1; \ |
| 619 | elif [ ! -z "`comm -13 <(sort $(PRIVATE_API)) <(sort $(BLACKLIST))`" ]; then \ |
| 620 | echo "$(BLACKLIST) must be a subset of $(PRIVATE_API)" 1>&2; \ |
| 621 | exit 2; \ |
| 622 | elif [ ! -z "`comm -13 <(sort $(PRIVATE_API)) <(sort $(DARK_GREYLIST))`" ]; then \ |
| 623 | echo "$(DARK_GREYLIST) must be a subset of $(PRIVATE_API)" 1>&2; \ |
| 624 | exit 3; \ |
| 625 | fi |
| 626 | comm -23 <(sort $(PRIVATE_API)) <(sort $(BLACKLIST) $(DARK_GREYLIST)) > $@ |
| 627 | |
Bart Sears | a8cc058 | 2015-05-07 03:23:20 +0000 | [diff] [blame] | 628 | # Include subdirectory makefiles |
| 629 | # ============================================================ |
| 630 | |
| 631 | # If we're building with ONE_SHOT_MAKEFILE (mm, mmm), then what the framework |
| 632 | # team really wants is to build the stuff defined by this makefile. |
| 633 | ifeq (,$(ONE_SHOT_MAKEFILE)) |
| 634 | include $(call first-makefiles-under,$(LOCAL_PATH)) |
| 635 | endif |
| 636 | |
Holly Jiuyu Sun | bbc8580 | 2017-12-21 18:44:59 -0800 | [diff] [blame] | 637 | endif # ANDROID_BUILD_EMBEDDED |
| 638 | |